🧈 butterscripts

A modular collection of scripts I use across my Debian setups — minimal and practical. These scripts automate installs, configure tools, apply theming, and tweak the system just how I like it.

---

Overview

Butterscripts is a collection of utility scripts that help streamline various tasks in Linux. These scripts are organized into different directories based on their functionality and purpose, making it easy to find the script you need.

Repository Structure

The repository is organized into the following directories:

/browsers

• Installation and Documentation
• brave: Brave browser
• firefox: Firefox latest
• floorp: Floorp
• zen: Zen browser
• more

---

/discord

• Installation and Documentation
• Install: Discord latest binary and built-in updater.

---

/fastfetch

• Installation and Documentation
• fastfetch: fastfetch latest
• Auto alias: for Bash, Zsh, and Fish
• 5 configurations: default, debian-red, fancy, minimal, neon, justaguy and server

---

/ghostty

• install_ghostty.sh: Installs Ghostty terminal emulator from ButterRepo (default terminal for all WM setups)
• config: Curated configuration file for Ghostty (GitHub Dark theme, splits, tabs, keybinds)
• style.css: Custom GTK CSS for Ghostty tab bar styling

---

/git

• Installation and Documentation
• ghee: The git workflow in one program — repo hub, stage/unstage cockpit, commit/file pickers, ssh picker, commit-and-push flow, multi-repo dashboard and sweep
• today.sh: Today's commit counts across repos

---

/kitty

• Installation and Documentation
• install_kitty.sh: Installs kitty terminal emulator from the official Debian repository (no third-party repo needed)
• kitty.conf: Curated configuration (GitHub Dark theme, splits, tabs, ALT keybinds)
• current-theme.conf: Default theme seed; swap with kitty +kitten themes
• themes/: Custom themes (Trapped in Amber) used by the WM theme switchers

---

/media

• Installation and Documentation
• clipmkv: Losslessly clip an mkv by start/end timestamps
• mergemkvs: Losslessly concatenate every mkv in ~/Videos
• stripgeo: Removes GPS/location metadata from images (exiftool)

---

/neovim

• Installation and Documentation
• neovim.sh: Installs Neovim + a JustAGuyLinux config (nvim vim-motions, or butter-nvim GUI keybinds)
• build-neovim.sh: Builds and installs Neovim from source code

---

/setup

• add_butterrepo.sh: Adds the ButterRepo APT repository
• install_caligula.sh: Installs Caligula disk imaging TUI
• install_geany.sh: Installs Geany text editor (APT or ButterRepo options)
• install_mise.sh: Installs mise (dev-tool version manager) + wires shell activation
• install_picom.sh: Installs Picom compositor
• optional_tools.sh: Interactive installer for development tools including ButterBash ⭐
• wm-chooser.sh: Multi-select window manager installer (awesome, bspwm, dwm, i3, openbox, qtile, sway, swayfx)

---

/st

• install_st.sh: Installs st (simple terminal)

---

/system

• install_bluetooth.sh: Installs and configures Bluetooth support
• install_lightdm.sh: Installs LightDM display manager
• install_printer_support.sh: Sets up printer support

---

/theming

• Installation and Documentation
• nerdfonts: Installs curated list of popular Nerd Fonts.
• install-theme: Installs my favorite GTK theme and Dracula Dark icon theme

---

/wezterm

• Installation and Documentation
• install_wezterm.sh: Installs WezTerm terminal emulator from official nightly repository (available via optional_tools)
• wezterm.lua: Curated lua configuration file for WezTerm

---

/zed

• settings.json: Curated configuration file for Zed text editor

---

Thanks to all contributors and the open source community for inspiration and code references.

🧈 Built For

• Butterbian Linux (and other Debian-based systems)
• Window manager setups (BSPWM, Openbox, etc.)
• Users who like things lightweight, modular, and fast

Butterbian Linux was a joke. The joke got an ISO. The ISO got a website. Send help.

---

License

GPL-2.0 - See LICENSE for details.

Support

Connect

• YouTube — tutorials and guides
• Butterforge — source code and projects
• The Butter Lab — Discourse forum
• The Churn — community chat (Fluxer)
• Wiki — documentation and guides
• Mastodon — @justaguylinux@fosstodon.org
• Butterbian — a Debian-based distro

---

Made with butter by JustAGuyLinux