Hunter OS

🌿 Philosophy

Distro Agnostic: Compatibility with a any linux based system for persisting workflow regardless of preferred base.

Terminal Focused: The terminal is the heart of this distro, providing CLI/TUI tools and utilities for efficient workflow tailored to personal preference. Even in the absence of a display server, do 95% of work in TTY comfortability without disrupting the workflow.

Lightweight, Optimized, and Battery Efficient: Perfectly engineered to be light on system resources, ensuring smooth performance. Every aspect is optimized for maximum efficiency, extending battery life and also have many features at disposal.

Keyboard Centric Workflow with Vim Style Keybindings: Keyboard-centric approach, with Vim-style keybindings deeply integrated into every tools, apps and utilities. This allows to navigate and interact with speed, precision and comfortability without even thinking about keybindings.

💼 Contained Concocted Custom Configurations

Click the links below for a detailed documentation.

Name	Description	Preview
🎹 KeyD	Keyboard Layout/Mapping
📊 Cava	Music Visualizer
🌄 Feh	Image Viewer
🦊 FireFox	Web Browser
🐟 Fish	Shell
📜 Fuzzel	App Launcher
💧 Hyprland	Wayland Compositor
🐱 Kitty	Terminal Emulator
😴 LazyGit	TUI Git Frontend
🎬 Mpv	Video Player
📝 NeoVim	TUI Code Editor
⚙️ Scripts	Scripts
🚀 Starship	Shell Prompt Engine
🍱 Tmux	Terminal Multiplexer
📁 ViFM	File Manager
🆚 VSCode	GUI Code Editor
🍫 WayBar	Status Bar
🌳 Wlogout	Logout Menu
📄 Zathura	PDF Frontend

📦 Preeminently Preferred Primary Packages

Click the following categories to toggle the list of packages in that category.

🐧 Linux System

🐧 Linux System

Package Name	Description	Src
base	Base Arch Installation	pacman
base-devel	Basic tools to build Arch Linux packages	pacman
linux	The Linux kernel and modules	pacman
linux-firmware	Firmware files for Linux	pacman
linux-headers	Headers and scripts for building modules	pacman
pacman-contrib	Scripts and tools for pacman systems (paccache)	pacman

👢 Boot

👢 Boot

Package Name	Description	Src
dosfstools	DOS Filesystem Utilities	pacman
efibootmgr	Utility to modify the EFI Boot Manager	pacman
grub	GNU GRand Unified Bootloader	pacman
ntfs-3g	NTFS filesystem driver and utilities	pacman
os-prober	Utility to detect other OSes	pacman
plymouth	Graphical boot splash screen	pacman
cantarell-fonts	Humanist sans serif font (for plymouth)	pacman

💾 Hardware

💾 Hardware

Package Name	Description	Src
acpi	Client for battery, power and thermal readings	pacman
acpi_call	Kernel module call ACPI (/proc/acpi/call)	pacman
acpid	Daemon for ACPI power management events	pacman
amd-ucode	Microcode update image for AMD CPUs	pacman
amdvlk	AMD’s standalone Vulkan driver	pacman
mesa-utils	Essential Utilities for Open-source OpenGL	pacman

📦 Development

📦 Development

Package Name	Description	Src
git	Version control system	pacman
lazygit	TUI for Git	pacman
meson	Nice build system	pacman
nodejs	Node Java Script Runtime Env	pacman
npm	Node JS package manager	pacman
python	Python Interpreter	pacman
sqlitebrowser	DB Browser for SQLite	pacman

⚙️ Utilities

⚙️ Utilities

Package Name	Description	Src
sudo	Run commands as root	pacman
bat	cat with syntax highlighting	pacman
dust	Disk space usage analyzer	pacman
exiv2	Image EXIF Manipulation Tool	pacman
fd	Faster alternative to find command	pacman
ffmpegthumbnailer	Video Thumbnailer	pacman
fzf	Fuzzy Finder Utility	pacman
highlight	Syntax Highlighter	pacman
jq	CLI JSON Processor	pacman
libqalculate	CLI NLP Calculator	pacman
lsd	ls with Nerd Font support	pacman
man-db	Utility for reading man pages	pacman
poppler	PDF Rendering Engine	pacman
ripgrep	Text Search Tool	pacman
speech-dispatcher	Speech Synthesis (spd-say)	pacman
xsv	CLI CSV Processor	pacman
brillo	Brightness based on human perception	aur
cava	Cross Platform Audio Visualizer	aur
tgpt	CLI AI Chat without API keys	aur
warpd-git	Modal Keyboard Driven Virtual Pointer	aur

📷 Audio, Video and Image

📢 Audio

Package Name	Description	Src
pamixer	CLI Volume Control Tool	pacman
pavucontrol	GUI Volume Control Tool	pacman
pipewire	Audio and Video streaming server	pacman
pipewire-pulse	A/V router & processor - PulseAudio replacement	pacman
wireplumber	PipeWire session/policy manager - wpctl	pacman

🎬 Video

Package Name	Description	Src
ffmpeg	Super advanced library for handling Audio / Video	pacman
handbrake	GUI Video Transcoder	pacman
mpv	Video Player - Minimal and integrates well with WM	pacman
yt-dlp	Video Downloader	pacman

🌄 Image

Package Name	Description	Src
feh	Image Viewer - Super light weight	pacman
nomacs	Image Viewer - Touch screen friendly	aur

🌐 Network and Security

🌐 Network and Security

Package Name	Description	Src
android-file-transfer	Mount Android Device	pacman
blueman	GUI Bluetooth Manager	pacman
bluez	Bluetooth Protocol Daemon	pacman
bluez-utils	Bluetooth Utilities - bluetoothctl	pacman
termscp	TUI client for SCP, FTP, Kube, S3	pacman
dhcpcd	DHCP Client Daemon	pacman
firefox-developer-edition	Internet Browser	pacman
keepassxc	Password Manager	pacman
networkmanager	CLI Network Manager - nmcli, nmtui	pacman
openssh	SSH protocol implementation	pacman
torbrowser-launcher	Anonnymous Onion Browser	pacman
transmission-gtk	GUI Torrent Client	pacman
wpa_supplicant	WLAN Daemon	pacman

🌲 Desktop

🌲 Desktop

Package Name	Description	Src
libnotify	Notification library	pacman
dunst	Notification Daemon	pacman
fuzzel	Wayland App Launcher	pacman
hyprland	Wayland compositor	pacman
xdg-desktop-portal-hyprland	Desktop Integration Portal	pacman
swayidle	Wayland Idle Manager	pacman
waybar	Wayland Status Bar	pacman
wl-clipboard	Wayland Clipboard Utility	pacman
wtype	Wayland Keystrokes Emulation	pacman
keyd	Key Remapping Daemon	aur
swww	Wayland Wallpaper Daemon	aur
wlogout	Logout Screen	aur

💻 2-in-1 Laptop Specific

💻 2-in-1 Laptop Specific

Package Name	Description	Src
iio-sensor-proxy	Accelerometer Sensor Driver	pacman
tlp	Laptop Power Optimization	pacman
auto-cpufreq	Dynamic CPU Clock Cycle Frequency	aur
detect-tablet-mode-git	Tablet mode scripts - watch_tablet	aur
iio-hyprland-git	Set Hyprland Orientation automatically	aur
yoga-usage-mode-dkms-git	ACPI driver for Tablet mode detection	aur

📄 Document viewers and editors

📄 Document viewers and editors

Package Name	Description	Src
neovim	Text Editor	pacman
code	Open Source build of VSCode	pacman
obsidian	MarkDown Note taker	pacman
pdfarranger	PDF Page Arranger	pacman
xournalpp	PDF Annotation / Drawing	pacman
zathura	PDF Graphical Viewer	pacman
zathura-pdf-poppler	Zathura Poppler Backend	pacman

📁 Archivers and File Manager

📁 Archivers and File Manager

Package Name	Description	Src
fuse-zip	FUSE mount zip files	pacman
nemo	GUI File Manager	pacman
p7zip	CLI 7 Zip Archiver	pacman
unzip	Unzip .zip archives	pacman
vifm	TUI File Manager	pacman

📊 System Monitors and Managers

📊 System Monitors and Managers

Package Name	Description	Src
nvtop	GPU process monitor	pacman
powertop	Battery usage monitor	pacman
htim	CPU process monitor	aur

🖥️ Terminal

🖥️ Terminal

Package Name	Description	Src
fish	Modern Shell used as a Commandline	pacman
kitty	best of all terminals out there	pacman
starship	Cross Platform Prompt	pacman
tmux	Terminal Multiplexer	pacman

🖋️ Fonts

🖋️ Fonts

Package Name	Description	Src
fontconfig	Font Configuration	pacman
noto-fonts	Google Font for Unicode Support	pacman
noto-fonts-cjk	Google Font for Unicode Support	pacman
noto-fonts-emoji	Google Font for Unicode Support	pacman
ttf-jetbrains-mono-nerd	Nerd Font Icons patch	pacman

🥃 Screenshot

🥃 Screenshot

Package Name	Description	Src
grim	Screenshot Utility for Wayland	pacman
slurp	Region Selector for Wayland	pacman
tesseract	OCR Utility	pacman
tesseract-data-eng	Tesseract OCR Data English	pacman
tesseract-data-mal	Tesseract OCR Data Malayalam	pacman

🍇 Directed Dependency Diagram

graph LR
vifm(📁 <a href='https://github.com/MidHunterX/Hunter-OS/tree/master/.config/vifm'>VIFM</a>)
ls{{lsd}}
cat{{bat}}
exif{{exiv2}}
syntax{{highlight}}
nvim(📝 <a href='https://github.com/MidHunterX/HunterX-PDE'>NeoVim</a>)
kitty(🐱 <a href='https://github.com/MidHunterX/Hunter-OS/tree/master/.config/kitty/'>Kitty</a>)
fish(🐟 <a href='https://github.com/MidHunterX/Hunter-OS/tree/master/.config/fish/'>Fish Shell</a>)
vos(🔈 VOS)
volume{{pamixer}}
brs(🔆 BRS)
brillo{{brillo}}
waybar(🍫 <a href='https://github.com/MidHunterX/Hunter-OS/tree/master/.config/waybar/'>Waybar</a>)
nf(Nerd Font)

vifm --> ls
vifm --> nvim
vifm --> nf
vifm --> exif
vifm --> syntax
fish --> ls
ls --> nf
fish --> vifm
fish --> vos
fish --> brs
fish --> cat
nvim --> vifm
nvim --> nf
kitty --> nvim
kitty --> fish
waybar --> volume
waybar --> brillo
waybar --> nf
vos --> volume
brs --> brillo

Loading

🛎️ System Services

Service	Description
NetworkManager.service	Network connection manager
dhcpcd.service	DHCP/ IPv4LL/ IPv6RA/ DHCPv6 client
keyd.service	A key remapping daemon for linux

💽 System Configs

GRUB Bootloader

sudo cp -R ~/.config/GRUB/CyberEXS /boot/grub/themes
sudoedit /etc/default/grub
sudo grub-mkconfig -o /boot/grub/grub.cfg

📝 /etc/default/grub [add]

GRUB_THEME=/boot/grub/themes/CyberEXS/theme.txt

📝 /etc/default/grub [replace]

GRUB_TIMEOUT=1
# Setting "splash" for boot splash screen with plymouth
GRUB_CMDLINE_LINUX_DEFAULT="loglevel=3 quiet splash"
# Read other EFI with os-prober
GRUB_DISABLE_OS_PROBER=false

Plymouth Splash Screen

sudo cp -R ~/.config/PLYMOUTH/cuts_alt /usr/share/plymouth/themes
sudo plymouth-set-default-theme -R cuts_alt

Usergroups

sudo usermod -G wheel,audio,video,power,input,storage midhunter

Group	Purpose
wheel	Grants sudo privileges
audio	Access to audio devices
video	Access to GPU and hardware acceleration.
power	Control power states (suspend, reboot, etc.)
input	Access to input devices
storage	Raw access to storage devices

Verify currently active groups:

groups midhunter

KeyD Setup

sudo ln -s ~/.config/keyd/default.conf /etc/keyd/default.conf
systemctl enable keyd.service
systemctl start keyd.service

Sudoers

sudoedit /etc/sudoers

📝 /etc/sudoers [add]

# Sudo Stuff
Defaults timestamp_type=global      # Activate Sudo across terminals
Defaults timestamp_timeout = 10     # Activate Sudo for 10 minutes
Defaults passwd_timeout = 5         # Sudo prompt timeout after 5 minutes
# Login Stuff
Defaults insults                    # Incorrect Password Easteregg
Defaults pwfeedback                 # Visible Password Feedback

Skip Username

sudo mkdir -p /etc/systemd/system/[email protected]/
sudo touch /etc/systemd/system/[email protected]/skip-username.conf
sudoedit /etc/systemd/system/[email protected]/skip-username.conf

📝 /etc/systemd/system/[email protected]/skip-username.conf [add]

[Service]
ExecStart=
ExecStart=-/sbin/agetty -o '-p -- midhunter' --noclear --skip-login - $TERM

or use this line if you want to auto login to a specific user on TTY1

📝 /etc/systemd/system/[email protected]/skip-username.conf [add]

[Service]
ExecStart=
ExecStart=-/sbin/agetty --noissue --autologin 'midhunter' - $TERM

Colorful Pacman

sudoedit /etc/pacman.conf

📝 /etc/pacman.conf [add]

ParallelDownloads = 5
Color
ILoveCandy

🗒️ Personal Notes

Partition Sizes

Partition	Recommended Size	Max Used
/	~ 32G	18G
/boot	= 256M	230M
/tmp (swap)	= 4G	8K
/home	> 128G	40G