https://github.com/omar-polo/mymenu

A customizable menu for X11
https://github.com/omar-polo/mymenu

desktop-utility xlib

Last synced: 21 days ago
JSON representation

A customizable menu for X11

• Host: GitHub
• URL: https://github.com/omar-polo/mymenu
• Owner: omar-polo
• License: isc
• Created: 2019-10-24T15:30:31.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2022-07-02T13:23:50.000Z (over 2 years ago)
• Last Synced: 2024-11-07T11:14:27.385Z (2 months ago)
• Topics: desktop-utility, xlib
• Language: C
• Homepage: https://www.omarpolo.com/pages/mymenu.html
• Size: 1.59 MB
• Stars: 2
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# MyMenu

> A menu for Xorg, 'cause I was bored

![MyMenu works!](screen.png)

![MyMenu alternate layout](screen-alt.png)

---

## What?

This is a simple menu for Xorg, like `dmenu(1)`.

## Why?

This was the perfect excuse to learn how to use Xlib.

## How?

Check out the [manpage](mymenu.1.md) for further documentation. Check

out also the [template](Xexample) for the resources.

---

## Features

- two layout: `horizontal` (a là dmenu) and `vertical` (a là rofi);

- highly customizable (width, height, position on the screen, colors, borders, ...);

- transparency support

- support for both Xft and bitmap font

## Dependencies

 - Xlib

 - Xinerama for multi-monitor support

 - Xft for TrueType font support

 - pkg-config *(optional)* to aid the autoconfiguration

 - mandoc *(optional)* to generate the

   [markdown version of the manpage](mymenu.1.md)

## Build

The usual spell:

	$ ./configure

	$ make

## FAQ

 - Does not run / Hangs

   At the startup mymenu will read `stdin` for a list of item, only

   then it'll display a window. Are you sure that you're passing

   something on standard input?

 - Will feature $X be added?

   No. Or maybe yes. In fact, it depends. Open an issue and let's

   discuss. If it's something that's trivial to achieve in combo with

   other tool maybe is not the case to add it here.

 - Is feature $Y present? What $Z do? How to achieve $W?

   Everything is documented in the [man page](mymenu.1.md). To read

   it, simply execute `man -l mymenu.1` or `mandoc mymenu.1 | less`

   (depending on your system the `-l` option may not be present).

---

## Scripts

I'm using this script to launch MyMenu with custom item

``` shell

#!/bin/sh

cat <