v3.1.2

Professional Shell Environment for Linux Power Users on Debian 13

DXSBash is a shell enhancement suite designed for developers, system administrators, and Linux power users. It provides a consistent, feature-rich experience across multiple shells, combining productivity tools, visual improvements, and optimized workflows.

Tested extensively on Debian 13. Please test on any system and send e-mail with detailed info with results, bugs, etc...

For a comprehensive list of all available commands and aliases in DXSBash, see the Commands Reference.

Or discover commands live in your shell:

aliases            # interactive fzf picker with a preview pane (if fzf is installed)
aliases git        # plain grep by substring; pipe-friendly

With fzf available, aliases (no args) opens a fuzzy-filter list; the preview pane shows the full definition of the selected alias or function. Without fzf — or when stdout is piped/redirected — it prints a plain sorted listing.

• Ctrl+R - Search command history with fuzzy matching
• Ctrl+F - Launch interactive directory navigator
• Alt+C - Change to selected directory via fuzzy finder

• Debian 13 (extensively tested)
• Limited support still for Debian 12
• Arch Linux (moderately tested)
• Ubuntu 20.04+ (limited tested)
• Administrative privileges (sudo mostly)

git clone --depth=1 https://github.com/digitalxs/dxsbash.git
cd dxsbash
chmod +x setup.sh
./setup.sh

The installer provides an interactive experience:

1. Shows an Install / Repair / Uninstall menu
2. Detects your Linux distribution automatically
3. Lets you choose your preferred shell (Bash, Zsh, or Fish)
4. Installs all required dependencies
5. Configures your chosen shell with enhanced features
6. Sets up visual elements and productivity tools
7. Configures KDE terminal Konsole and Yakuake profiles and defaults

./setup.sh --install --shell bash --yes        # end-to-end, no prompts
DXSBASH_SHELL=zsh ./setup.sh --install --yes   # same via env var
./setup.sh --install --dry-run                 # show plan without changes

All output is mirrored to ~/.dxsbash/logs/install-YYYYMMDD-HHMMSS.log. If DXSBash is already installed, the installer suggests dxsbash-repair instead of reinstalling — use --yes to force a reinstall anyway.

Update to the latest version:

update-dxsbash

If symlinks or helper commands break after a system update or partial install, re-link everything without touching your settings or history:

dxsbash-repair            # interactive; auto-detects your shell
dxsbash-repair --dry-run  # preview changes
dxsbash-repair --deps     # also reinstall missing dependencies

Tune DXSBash interactively without hand-editing rc files:

dxsbash-config

The menu lets you change:

• Default text editor ($EDITOR / $VISUAL)
• Shell history sizes (HISTSIZE, HISTFILESIZE)
• Prompt style (Starship vs. built-in custom)
• Starship theme (DXS, Tokyo Night, Gruvbox Rainbow, Catppuccin, …)
• Fastfetch on startup (on/off)
• Reset everything to defaults

Changes are written to ~/.dxsbash/user.conf and take effect in new shell sessions (or after source ~/.bashrc / source ~/.zshrc).

• .bashrc - Enhanced Bash configuration
• .zshrc - Zsh configuration with plugins
• config.fish - Fish shell configuration

• Starship - Cross-shell prompt with rich information
• Zoxide - Smarter directory navigation
• FZF - Fuzzy finder for files and history
• Fastfetch - Optimized system information display
• FiraCode Nerd Font - Programming font with ligatures and icons

• Ctrl+R - Search command history with fuzzy matching
• Ctrl+F - Launch interactive directory navigator
• Alt+C - Change to selected directory via fuzzy finder

• update - Update system packages
• install [package] - Install packages with updates
• whatsmyip - Show internal and external IP addresses

• extract <file> - Extract any archive type automatically
• mkdirg <dir> - Create and navigate to directory
• cpg <src> <dest> - Copy and go to destination
• mvg <src> <dest> - Move and go to destination

• .., ..., .... - Go up 1, 2, or 3 directories
• bd - Go back to previous directory
• up <n> - Go up n directories

• gs - Git status
• ga - Git add
• gc - Git commit
• gp - Git push
• gl - Git log
• gb - Git branch
• gco - Git checkout

DXSBash installs and uses the following software packages to enhance the Linux terminal experience and DXSBash would not be possible without them:

You can customize your environment even more by editing:

• Shell configuration: .bashrc, .zshrc, or ~/.config/fish/config.fish
• Edit aliases: .bash_aliases
• Prompt: ~/.config/starship.toml
• System info: ~/.config/fastfetch/config.jsonc

• Linux-specific Commands: Some commands (like netstat-based aliases) might not work correctly on all Linux distributions or might have different output formats.
• X11-dependent Features: Commands like clickpaste rely on X11 utilities (xdotool) which won't work in Wayland or headless environments.
• Hardware-dependent Commands: The cpu function assumes a specific format in /proc/stat, which might not be consistent across all Linux kernels.
• Terminal-specific Features: The Konsole and Yakuake configurations might not translate well to other terminal emulators.

Full uninstall — backs up your current configs, removes all DXSBash files, restores Debian 13 defaults from /etc/skel/, and optionally reverts your login shell to bash:

dxsbash-uninstall                 # interactive
dxsbash-uninstall --dry-run       # preview only
dxsbash-uninstall --yes           # non-interactive
dxsbash-uninstall --keep-repo     # keep ~/linuxtoolbox/dxsbash
dxsbash-uninstall --no-restore    # skip /etc/skel restore

Or, to only revert shell rc files to defaults without removing the repo:

sudo reset-shell-profile [username]

You can also reach these from the installer menu:

./setup.sh            # interactive menu: Install / Repair / Uninstall
./setup.sh --repair
./setup.sh --uninstall

DXSBash was successfully compatibility tested with:

• Debian 13
• Konsole 25.04.2
• Yakuake 25.04.0
• XFce Terminal 1.0.4 (Need to change font settings to Firacode Nerd Font Regular)
• Kitty 0.26.5

If you find DXSBash valuable for your workflow, consider supporting its development:

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

• GitHub: digitalxs/dxsbash
• Email: luis@digitalxs.ca
• Website: https://digitalxs.ca