This repository has been archived on 2024-01-22. You can view files and clone it, but cannot push or open issues or pull requests.
speedie-page/projects/spmenu.php
2023-01-22 18:39:32 +01:00

97 lines
4 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html>
<head>
<?php include '../php/header.php';?>
<title>spmenu</title>
<meta charset="UTF-8">
<meta name="description" content="speedie's fork of suckless dmenu.">
<meta name="author" content="speedie">
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<link rel="stylesheet" href="speedwm.css">
<title>Welcome to speedie.gq</title>
</head>
<body>
<div class="content">
<img src="preview2.png" alt="spmenu screenshot" width="75%">
<h3 id="what-is-spmenu">What is spmenu?</h3>
<p>spmenu is an X11 menu application based on <a
href="https://tools.suckless.org/dmenu">dmenu</a> which takes standard
input, parses it, and lets the user choose an option and sends the
selected option to standard output.</p>
<p>It is designed to integrate well with my <a
href="https://dwm.suckless.org">dwm</a> fork, <a
href="https://codeberg.org/speedie/speedwm">speedwm</a>.</p>
<h3 id="special-features">Special features</h3>
<p>This build of spmenu has some features written for this build. Of
course if you want, this is free software so you can use it in your own
build.</p>
<ul>
<li>dwm-like keybind array (See keybinds.h)</li>
<li>256 color support through SGR codes.</li>
<li>Option to block typing.</li>
<li>Rewritten arguments, old arguments still work though.</li>
<li>Border only when centered option</li>
<li>Hiding each part of the menu</li>
</ul>
<h3 id="other-features">Other features</h3>
<p>Note: This is an incomplete list, its just here to give you an idea
of what this build has to offer. - Pango markup support - Alpha
transparency - Pywal/.Xresources support - Grid - Colored Emoji/Font
support - Highlighting - Right-to-left language support -
Case-insensitive by default - Padding; useful with patched dwm with
barpadding or speedwm. - Fuzzy-finding - Preselect support - Line-height
- History support</p>
<h3 id="dependencies">Dependencies</h3>
<ul>
<li>libX11</li>
<li>libXrender</li>
<li>freetype</li>
<li>libXinerama
<ul>
<li>Can be disabled if you dont want/need multi-monitor support.</li>
</ul></li>
<li>tcc compiler (you can swap it out for GCC by passing CC=“gcc” to the
<code>make</code> command if you want)</li>
<li>Pango (for drawing fonts)
<ul>
<li>If you do not want to use pango, consider my <a
href="https://github.com/speedie-de/dmenu">older spmenu build</a></li>
</ul></li>
</ul>
<h3 id="installation-most-gnulinux-distributions">Installation (most
GNU/Linux distributions)</h3>
<p><code>emerge dev-vcs/git # Install dev-vcs/git using your favorite package manager</code></p>
<p><code>git clone https://codeberg.org/speedie/spmenu</code></p>
<p><code>cd spmenu/</code></p>
<p><code>make clean install # Run as root.</code></p>
<h3 id="installation-gentoo">Installation (Gentoo)</h3>
<p>If you are on Gentoo GNU/Linux, you can add <a
href="https://codeberg.org/speedie/speedie-overlay">my overlay</a> which
includes <code>x11-misc/spmenu</code> as well as other useful
packages.</p>
<h3 id="xresources-values">.Xresources values</h3>
<p>This build allows you to define .Xresources values to load on
startup. See docs/example.Xresources for a list of default values.</p>
<h3 id="scripts">Scripts</h3>
<p>This build of spmenu should work with all spmenu scripts. <a
href="https://codeberg.org/speedie/speedwm-extras">Here</a> are a few
Ive written/use:</p>
<h3 id="notes-for-users-of-arch">Notes for users of Arch</h3>
<p>This fork of spmenu is compiled using tcc for speed however tcc from
the Arch repositories seems to be broken. Im sure theres a better way
to fix this but I just fix it by installing <a
href="https://aur.archlinux.org/packages/tcc-ziyao">this package</a>
from the AUR.</p>
<h3 id="notes-for-gcc-users">Notes for GCC users</h3>
<p>If youre compiling with GCC, chances are youre seeing a lot of
warnings. This is because were compiling with -Ofast. I cant seem to
find any issues with using -Ofast but if it bothers you, you can compile
with -Os or -O2 which dont spit out these warnings.</p>
</div>
</body>
<footer>
<?php include '../php/footer.php';?>
</footer>
</html>