axyl-iso Wiki

Welcome to the axyl-iso wiki!

Post-Install Guide || General Tools Overview

A list of packages can be found in the archiso directory. Look for a packages.x86_64 file, for a comprehensive list.
Or just click here

Here's a brief overview of the main (30ish) tools with relevent Arch Linux Wiki links and other helpful info:
1. Alacritty = GPU-accelerated Terminal Emulator Arch Wiki | AUR-git | Feat | GitHub | .org
- Config should be found in same directory as window manager's .config folder(i.e. ~/.config/i3/alacritty).
- Does not come as default due to compatibility/stability issues.
2. ani-cli = Browse/Play anime via cli AUR | AUR-git | GitHub
3. Cava = Audio Visualizer for ALSA AUR | GitHub
4. Conkeww = Framework for Eww GitHub | Conky ArchWiki | Conky GitHub
- Made for Axyl, and easy to customize.
5. cowfortune = Configurable fortune cookie proclaiming cow GitHub | cowsay Wikipedia
- Good fun.
6. Dmenu = Dynamic menu (Launcher) Arch Wiki See also ->j4-dmenu-desktop
- Custom scripts and themeing(filename colors) info can be found in your /usr/local/bin directory.
7. Devour = X11 window swallower AUR | AUR-git | GitHub
- It should be noted that Axyl comes with aliases that force devour with these tools: mpv, pcmanfm, sxiv, vlc, and zathura
- This is interesting because Axyl doesn't come with pcmanfm or vlc lool
8. Dunst = Notification daemon Arch Wiki | GitHub
- dunstrc should be found in same directory as window manager's .config folder(i.e. ~/.config/i3/dunstrc).
9. Feh = Image Viewer Arch Wiki | GitHub
- .fehbg should be found in same directory as window manager's .config folder(i.e. ~/.config/i3/.fehbg).
- ~/.config/i3/wallpaper.jpg is the default file referenced for the i3wm wallpaper.
10. FireFox = Web browserArch Wiki | .org
11. Geany = GUI text editor Arch Wiki | AUR-git | GitHub | Wikipedia
12. Grub = GRand Unified Bootloader Arch Wiki | GitHub | Wikipedia
13. gtop = System Monitoring dashboard for terminal Github
14. htop = Interactive process viewer .dev | GitHub | Wikipedia
15. j4-dmenu = A fast desktop menu AUR | GitHub
- Intended as a replacement for i3-dmenu-desktop
- May need to be reinstalled to get working keybind(Super).
16. mpv = Cli video playerArch Wiki | GitHub | .io
17. (oh-my-)zsh-git = AUR | GitHub | .sh
18. paru = Feature packed AUR helper AUR | GitHub
19. picom = A lightweight compositor for X11 Arch Wiki | GitHub
20. polybar = A fast status bar Arch Wiki | GitHub
21. ranger = A VIM-inspired filemanager for the console Arch Wiki | GitHub | Wikipedia
22. sxhkd = X hotkey daemon (made by bspwm dev) Arch Wiki | GitHub
23. thunar = GUI file manager Arch Wiki | Gentoo Wiki | GitHub | .org | Wikipedia
24. tmux = Terminal multiplexer Arch Wiki | GitHub | Wikipedia
25. ueberzug = I think its trying to be a superior w3mimgdisplay, idk. AUR-git | GitHub
26. viewnior = Elegant image viewer for minimalism GitHub
27. (neo)vim = Ultimate text editor with lua scripting now Neovim Arch Wiki | nvim.io | Neovim GitHub | NvChad GitHub | NvChad.io | .org | rtorr | Wikipedia
- nvim issues seem to be fairly prevalent at the moment(Aug-2022)
- Axyl ships with a fairly standard nvchad theme that is easy to reinstall
- See this link for all uninstall/reinstall/install specifics for NvChad
- Don't forget, NvChad has a default <\leader> = (Space) ; which you can use to toggle themes
* (space) -> (t) -> (h) -> nvChad themes
- axyl-vim and axyl-nvim can also be reinstalled to resolve certain issues.
28. xfce4-terminal = OG Terminal Emulator GitHub | .org
- Default Terminal for speed and stability
29. ytfzf(-git) = A posix script to find and watch YouTube videos AUR | AUR-git | GitHub

Axyl packages that differ from vanilla(to be expanded upon with detail and distinctions later):
1. axyl-release
2. axyl-wallpapers
3. axyl-conkeww
4. axyl-dmenu
5. axyl-fonts
6. axyl-i3wm
7. axyl-grub-theme
8. axyl-lxdm-theme
9. axyl-nvim
10. axyl-scripts
11. axyl-skeleton
12. axyl-vim

Last Note: Each wm has a specific autostart script that is worth glancing at before investing significant time customizing your axyl
(For example, changing nvChad themes can initially seem bugged on i3 due to a login script that reapplies nord)
1. i3 = Directory ~/.config/i3/bin/ has an autostart.sh and a launchbar.sh
2. bspwm = Directory ~/.config/bspwm/ has a bspwmrc
3. dwm = Directory ~/.dwm/ has an autostart.sh
4. xmonad = Directory ~/.xmonad/bin/ has an autostart.sh and a launchbar.sh
5. qtile = Directory ~/.config/qtile/scripts/ has an autostart.sh
6. leftwm = Directory ~/.config/leftwm/themes/current/ has an up
7. riverwm = Directory ~/.config/river/ has an init
8. spectrwm = Directory ~/.config/spectrwm/ has an autostart.sh

Common Frustrations || Recommendations

1. One should take a glance at the ~/.zshrc and ~/.zshrc-personal files for some aliases that may be unexpected defaults. For example, rm gets aliased to rm -i rather than rm -I. A few devour aliases can be found as well. If you are unfamiliar with ~/.zshrc-personal as a convention, I believe it started with arcolinux as a way to ensure certain aliases remain untouched across different environments. Will correct if wrong.

2. Axyl's i3 has a single adjustment to the default split-horizontal and focus-up binding that may cause confusion(mod+Bvs.mod+H). i3 regulars will expect this functionality with mod+H and mod+B but be sorely disappointed to find them swapped. Users can revert this in their i3 config if inconvenient enough.

3. Axyl can seem stubborn when adjusting some visual config due to the start scripts overwriting previous edits. This is to keep themeing consistent across Window managers but can make for a lot of headache if forgotten during themeing config/customizations. Please revisit the Last Note: if you are struggling to keep changes saved or from being reverted.