Home

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