https://github.com/System64fumo/sysmenu

Simple program launcher written in gtkmm 4
https://github.com/System64fumo/sysmenu

application-launcher gtk4 wayland

Last synced: 2 months ago
JSON representation

Simple program launcher written in gtkmm 4

• Host: GitHub
• URL: https://github.com/System64fumo/sysmenu
• Owner: System64fumo
• License: wtfpl
• Created: 2024-02-01T04:29:53.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2024-10-15T15:26:33.000Z (3 months ago)
• Last Synced: 2024-10-25T09:12:36.209Z (3 months ago)
• Topics: application-launcher, gtk4, wayland
• Language: C++
• Homepage:
• Size: 46.7 MB
• Stars: 44
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-hyprland - sysmenu

README

        
# Sysmenu

Sysmenu is a simple and efficient application launcher written in gtkmm4


![default](https://github.com/System64fumo/sysmenu/blob/main/preview_default.gif "default")

![fullscreen](https://github.com/System64fumo/sysmenu/blob/main/preview_fullscreen.gif "fullscreen")

# Install

You need the following dependencies:

* gtkmm-4.0

* gtk4-layer-shell

Customize ``config.hpp`` if you wish to do so. 


Then to build all you need to do is run ``make``

# Why does this exist?

Mainly because i got bored lol.


But also because i disliked how the current programs i used behaved.


So instead of fixing them i created my own!


# Configuration

sysmenu can be configured in 3 ways


1: By changing config.h and recompiling (Suckless style)


2: Using a config file (~/.config/sys64/menu/config.conf)


3: Using launch arguments


```

arguments:

  -S	Hide the program on launch

  -s	Hide the search bar

  -i	Set launcher icon size

  -I	Set dock icon size

  -m	Set launcher margins

  -u	Show name under icon

  -b	Show scroll bars

  -n	Max name length

  -p	Items per row

  -a	Anchors ("top right bottom left")

  -W	Set window width

  -H	Set window Height

  -l	Disable use of layer shell

  -v	Prints version info

  -D	Set dock items ("Terminal,FileManager,WebBrowser,ect..")

```

# Signals

You can send signals to show/hide the window.


``pkill -10 sysmenu`` to show.


``pkill -12 sysmenu`` to hide.


``pkill -34 sysmenu`` to toggle.


# Theming

sysmenu uses your gtk4 theme by default, However it can be also load custom css,


Just copy one of the included style_*.css file to ~/.config/sys64/menu/style.css


# Credits

[wf-shell](https://github.com/WayfireWM/wf-shell) for showing how to do launcher related stuff


# Also check out

[wofi](https://hg.sr.ht/~scoopta/wofi)


[nwg-drawer](https://github.com/nwg-piotr/nwg-drawer)