Home

Welcome, dear adventurers. ⛰️

Welcome to the Epitaph wiki! This is a tiny wiki where we will show you how to customize the epitaph theme to your needs and liking 🧑‍🔧

Dependencies 👶 -> 🍼

You'll need the following dependencies installed to make Epitaph work:

⚠️ Only some distribution instructions are listed here, this may differ from your current distribution, if you happen to know how to install these dependencies in a non-apt distribution, please add your knowlegde to this wiki 🙏

Dependency	Debian / Ubuntu	Void Linux	Funtoo Linux
leftwm	Get it here
rustc	Get it here		emerge -av rust-bin
xrandr	apt install x11-xserver-utils		emerge -av xrandr
picom	apt install picom		emerge -av picom
rofi	apt install rofi	xbps-install rofi	emerge -av rofi
feh	apt install feh		emerge -av feh
pulseaudio	apt install pulseaudio		emerge -av pulseaudio
notify-send	apt install libnotify-bin		emerge -av libnotify
i3lock	apt install i3lock		emerge -av i3lock
inotify tools	apt install inotify-tools	xbps-install inotify-tools	emerge -av inotify-tools
i3lock-fancy	apt install i3lock-fancy		Not available in Funtoo, stick with i3lock
polybar	apt install polybar	sudo xbps-install polybar	emerge -av polybar
pulse audio CLI mixer	apt install pamixer		emerge -av pamixer
Playerctl	apt install playerctl	xbps-install playerctl	emerge -av playerctl
cmus	apt install cmus	xbps-install cmus	emerge -av cmus
tilix	apt install tilix	xbps-install tilix	emerge -av tilix-bin
perl	apt install perl	xbps-install perl	emerge -av perl
xdg-user-dirs	apt install xdg-user-dirs		emerge -av xdg-user-dirs
maim	apt install maim		emerge -av maim
Perl Libraries	apt install libgtk3-perl libpar-packer-perl libinline-c-perl

The following packages are recommended if you want a good out-of-the-box experience

Package	Debian / Ubuntu	Funtoo Linux (1.4 or Next)
flatpak	apt install flatpak	emerge -av flatpak
Any polkit you want	apt install policykit-1-gnome	emerge -av mate-polkit
keychain	apt install keychain	emerge -av keychain
blueman-applet	apt install blueman	emerge -av blueman

Where to start 🤔 ❓

1. First you need to download the repository from the main page or use git clone --depth=1 https://github.com/VentGrey/Epitaph.git $HOME/.config/leftwm/themes/ to clone the repo locally to your computer. If the themes/ directory doesn't exist, create it manually, otherwise the above command will install Epitaph without a parent folder and this won't work.

2. Create a symbolic link named “current”: ln -s Epitaph current or rename the epitaph folder as “current”: mv Epitaph current.

3. Read the Goodies & Bar Modules documentation and learn how to customize them to your own liking.

4. Run the epitaph script after modifying the Rust power manager (battery-notify) included in this theme. See the scripts section at the Wiki index to read an extensive documentation on each goodie. The Epitaph scripts come with the follwing flags:

   1. install - This does a normal installation. It's up to the user to decide how to configure Epitaph and use it's scripts
   2. recompile - In case you need to rebuild the included battery-notify power manager Rust, this will recompile it if you ever need to modify it or if you need an update.
   3. help - Shows a help message.

5. Enjoy your brand new Epitaph theme.

⚠️ The Makefile is in beta still, please report any bugs or submit improvements if you wish to help out ❤️