Skip to content

Latest commit

 

History

History
101 lines (60 loc) · 4.41 KB

README.md

File metadata and controls

101 lines (60 loc) · 4.41 KB

Fildem V2

A Global menu extension for Gnome

Buy Me A Coffee

Fildem

This project is a fork of Fildem V1. Due to the original creator abandoning the project, I've decided to keep this project upto-date. View current plans and ideas at https://github.com/Weather-OS/Fildem-v2/discussions.

You can also bring a HUD menu with Alt + Space (on Xorg).

Installation

Extension

To install the extension, download it from the Gnome extensions website.
Deprecated extension. Will be updated soon.
You can install the extension by moving [email protected] to ~/.local/share/gnome-shell/extensions/

Ubuntu

Download the .deb file from the releases section and run sudo apt install ./fildem_*.deb
Build is not available yet. I'm currently working on updating the build file.

Arch

Download the .zst file from the releases section and run sudo pacman -U ./python3-fildem*.zst
Build is not available yet. I'm currently working on updating the build file.
You can build a working package with makepkg -si

Building from source

Dependencies

Arch: bamf appmenu-gtk-module libkeybinder3 libdbusmenu-gtk2 libdbusmenu-gtk3 libdbusmenu-qt5
Ubuntu libbamf3-dev bamfdaemon libkeybinder-3.0-dev appmenu-gtk2-module appmenu-gtk3-module unity-gtk-module-common

Install the extension by moving [email protected] to ~/.local/share/gnome-shell/extensions/.

Run setup.py install --optimize=1.

You will be asked if you want to run fildem at startup, This is completely optional, but it is recommended.

Log out and log back in.
Enable fildem from GNOME Extensions.
If you haven't configured fildem to run at startup, you may need to run fildem and fildem-hud

Configuration

In order for the application to work, you must configure the following files (aplies to all operating systems):

  • Create the file ~/.gtkrc-2.0 and append gtk-modules="appmenu-gtk-module"
  • The file ~/.config/gtk-3.0/settings.ini should have the line gtk-modules="appmenu-gtk-module" under [Settings]. If it doesn’t exist create it and paste the following
[Settings]
gtk-modules="appmenu-gtk-module"

Running

After installation you’ll have two executables, fildem and fildem-hud. To check if it works use the first one. fildem-hud is for using he HUD, if you are on Xorg, you already have it bound to Alt + Space. If you are on Wayland, you can bind some keybinding to that command.

Customization

Menu always visible

By default, the menu is visible when you hover the mouse on the panel. If you want the menu to be always visible, unselect “Show menu only when the mouse is over the panel” in the preferences of the extension.

AppMenu Button always visible

The AppMenu button shows the application name or window title (if you have some extension) in the panel. By default, the fildem extension hides that label when the menu is being shown. If you want it to be always visible, you can unselect “Hide App Menu label” in the preferences of the extension.

Reduce space between buttons

If the menu shown on the panel is shifted with relation to the one that appears, you can tweak the padding in the preferences window of the extension.

Remove space in between buttons

In some gnome themes, the buttons have a small spacing between them. This can make the buttons easy to miss and unfocusing our window if it’s not maximized. To fix this, add this somewhere on your gnome-shell.css theme:

#panel #panelLeft {
  spacing: 0px; }
#panel #panelLeft .panel-button {
  spacing: 0px; }

Running the program at startup

If you manage to make the program work and want to have it running automatically at startup you can add an entry to gnome-session-properties with the name of the program and the path to execute it.

Create a shortcut for the HUD on Wayland

Since it’s not possible to creat a shortcut from the app on Wayland, you have to create it yourself. Go to Settings → Keyboard Shorcuts and create a shortcut that executes inithud.sh.

State of the Apps

To see a list of apps that work check the wiki