Skip to content

kergoth/dotfiles

BranchesTags

Repository files navigation

Kergoth's Dotfiles and Setup Scripts

BlueOak 1.0.0 License

This repository includes my personal application configuration and settings (dotfiles), as well as scripts for setting up systems per my personal preferences.

Prerequisites

  • (On macOS) Command-Line Tools or XCode must be installed (See scripts/extras/ for scripts to install these).

Usage

Initial dotfiles setup

This setup will apply the dotfiles, and will also install packages with home-manager, if nix is installed.

If the repository has not yet been cloned:

chezmoi init --apply kergoth/dotfiles

If the repository is already cloned and you've changed directory to it:

./script/setup

User Setup

This setup will apply the dotfiles, but will also apply other changes to the current user configuration.

After cloning the repository, and changing directory to it, run:

./script/setup-user

On windows (in powershell, not WSL), run this instead:

./script/setup-user.ps1

System Setup

The setup-system script is run by a non-root user with sudo/doas access, to perform system-level setup and configuration. This script will apply changes to the system as a whole. This may include installing packages through the package manager, installing nix, et cetera. Ideally this should be run prior to setting up the user, and should be run as a user with sudo access.

After cloning the repository, and changing directory to it, run:

./script/setup-system

On windows (in powershell, not WSL), run this instead:

./script/setup-system.ps1

Operating System Installation

WSL2 Chimera Linux Installation

  • Download the latest release zip file from ChimeraWSL (Install Chimera Linux as a WSL instance).
  • Unpack Chimera.zip into ~/Apps/Chimera
  • Run ~/Apps/Chimera/chimera.exe, which registers the new distro with WSL and unpacks the rootfs tarball, then enters the wsl as root
  • Initial setup, run the setup-root script, and exit wsl:
apk update
apk upgrade
apk add git
cd
git clone https://github.com/kergoth/dotfiles .dotfiles
./.dotfiles/script/chimera/setup-root
exit
  • Set our new user as default: ~/Apps/Chimera/chimera.exe config --default-user kergoth
  • Re-enter wsl, as the new user: wsl -d chimera
  • Clone the dotfiles repository and run the system and user setup:
cd
git clone https://github.com/kergoth/dotfiles .dotfiles
./.dotfiles/script/setup-full
  • Optionally, enable init and service management with dinit: doas nvim /etc/wsl.conf and add:
[boot]
systemd=true
  • If you set systemd=true, remember to shut down WSL so it will start init when you run it next: wsl.exe --shutdown.

Note: If you set systemd=true, it will run all the default Chimera Linux services, including PipeWire, but there's no need for this given the WSL2 system distro is already running PulseAudio. I need to determine which default services to disable in this situation.

Chimera Linux Installation

  • Attach the Chimera Linux Live CD ISO to a VM or USB drive and boot from it.
  • If not using a base ISO, wait for the graphical environment to load. It will take a few seconds.
  • If using a base ISO, log in as anon.
  • Run the Console app.
  • Note that the default password, when prompted, is chimera.
  • Clone the dotfiles repository and run the os-install script:
doas apk update
doas apk add git
git clone https://github.com/kergoth/dotfiles .dotfiles
doas ./.dotfiles/script/chimera/os-install
  • After rebooting:
    • Note: By default, there will be no graphical environment available, but this will be installed by my dotfiles setup.
    • Log in as the new user and:
doas dinitctl enable dhcpcd
# Wait a second for the DHCP client to get an IP address
~/.dotfiles/script/setup-full

Edit dotfiles

chezmoi edit --watch ~/.config/zsh/.zshrc

Apply dotfiles changes to the home directory

This step is implicitly done by the boostrap script. To run it manually, for example, after editing files inside the repository checkout, run this:

chezmoi apply

Update the dotfiles, including external files

chezmoi update -R

Update the dotfiles, external files, and home directory packages

./script/update

Manual Setup Steps

Manual Setup Steps for macOS

  • Enable secure keyboard entry in Terminal

  • ./scripts/extras/enable-filevault

  • System Settings > Lock Screen

    • Set “Require password after screen saver begins or display is turned off” to after 5 seconds or less.

  • System Settings > Privacy & Security > Security

    • Set “Allow applications downloaded from App Store and identified developers” at most.

  • System Settings > Privacy & Security > Full Disk Access

    • Add Terminal, iTerm, and any other terminal emulators you use.
    • Add VSCode, and any other editors you use.

  • Run vscode, enable settings sync

  • Run vivaldi, enable sync

  • Run deliveries, click yes to import from iCloud

  • Run musicharbor, click yes to import from iCloud

  • Run appcleaner, preferences, enable smartdelete

  • Run alfred, preferences, advanced, enable sync to ~/Sync/App Settings/Alfred

  • Safari

    • Change the default scale to 85%
    • Add site settings icon
    • Add cloud tabs icon
    • Rearrange icons

  • Syncthing Shares

    • Sync/dotfiles-local
    • Sync/App Settings
    • Library/Fonts
    • Library/Application Support/Zed/extensions

Manual Setup Steps for Windows

  • Set up all my Syncthing shares

    • AppData/Local/Zed/extensions

  • Restore from backup:

    • $USERPROFILE/Apps
    • Vivaldi: AppData/Local/Vivaldi/User Data/Default/
    • archwsl disk image

  • Run QuickLook, right click its icon, click start at login

  • Create link to CapsLockCtrlEscape.exe in Startup (win-r -> shell:startup)

  • Install Fonts from Sync/Fonts

  • Run vscode, enable settings sync

  • Remove Edge, Store, Mail from the task bar pins.

What's Included

Dotfiles

Zsh Plugins

Fonts

  • iA-Fonts: iA Writer Mono, Duo, and Quattro.
  • MesloLGS NF: Meslo Nerd Font patched for Powerlevel10k.

Installed CLI Software

  • curl: Command line tool and library for transferring data with URLs.

  • wget: A free software package for retrieving files using HTTP, HTTPS, FTP and FTPS.

  • gh: GitHub’s official command line tool.

  • git: A free and open source distributed version control system designed to handle everything from small to very large projects with speed and efficiency.

  • git-lfs: An open source Git extension for versioning large files.

  • neovim: Hyperextensible Vim-based text editor.

  • gnupg: A complete and free implementation of the OpenPGP standard.

  • python: A programming language that lets you work quickly and integrate systems more effectively.

  • uv: An extremely fast Python package installer and resolver, written in Rust.

  • atuin: ✨ Magical shell history.

  • bat: A cat(1) clone with syntax highlighting and Git integration.

    • bat-extras: Scripts that integrate bat with various command line tools.

  • choose: A human-friendly and fast alternative to cut and (sometimes) awk.

  • Claude Code: Anthropic's agentic coding tool for your terminal. Available via brew (claude-code), official installer, and npm.

  • delta: A syntax-highlighting pager for git, diff, and grep output.

  • direnv: An extension for your shell which can load and unload environment variables depending on the current directory.

  • duf: Disk Usage/Free Utility - a better 'df' alternative.

  • dua: View disk space usage and delete unwanted data, fast. This is a faster version of ncdu.

  • restic (Open-Source): Fast, secure, efficient backup program.

  • rsync: Fast, versatile file copying tool for remote and local files.

  • eza or exa: A modern replacement for ls.

  • fd: A simple, fast and user-friendly alternative to 'find'.

  • fzf: A command-line fuzzy finder.

  • ghq: Remote repository management made easy.

  • git-absorb: git commit --fixup, but automatic.

  • git-imerge: Incremental merge for git.

  • git-revise: A handy tool for doing efficient in-memory commit rebases & fixups.

  • jira-cli (Only on Work machines): Feature-rich interactive Jira command line.

  • jujutsu (Open-Source): Git-compatible VCS that is both simple and powerful.

  • jq: A lightweight and flexible command-line JSON processor.

  • ripgrep: A line-oriented search tool that recursively searches the current directory for a regex pattern.

  • rusage.com: Provides the best possible way to report resource usage statistics when launching command line programs.

  • sad: CLI search and replace | Space Age seD.

  • sd: Intuitive find & replace CLI (sed alternative).

  • shellcheck: A static analysis tool for shell scripts.

  • shfmt: Format shell programs.

  • tealdeer: Simplified, example based and community-driven man pages.

  • uv (Open-Source): An extremely fast Python package and project manager, written in Rust.

  • zoxide: A smarter cd command, inspired by z and autojump.

  • zstd: Zstandard - Fast real-time compression algorithm.

CLI Software on Linux and macOS

  • nix: Nix is a tool that takes a unique approach to package management and system configuration.

CLI Software on Linux, macOS, and FreeBSD

  • patchutils: A small collection of programs that operate on patch files.

    • On Windows, patchutils can be used via either WSL or MSYS2 (which can be installed via scoop and run as msys2, ex. msys2 -c 'exec filterdiff "$@"' -).

  • ssh-copy-id: Install your identity.pub in a remote machine’s authorized_keys.

    • On Windows, I have a powershell function which does this, and is aliased to ssh-copy-id.

  • tmux: An open-source terminal multiplexer.

    • There are no good options for tmux or tmux-equivalent on Windows. The closest you can get is just splits in Windows Terminal, which doesn't give you the ability to disconnect.

CLI Software on Linux (non-Chimera), macOS, FreeBSD, and Windows

  • unar: Universal archives extractor. Available via brew, nix, and scoop.

CLI Software on FreeBSD

  • go: An open source programming language supported by Google

    • Installed so we can go install various tools.

  • rust: A multi-paradigm, general-purpose programming language.

    • Installed so we can cargo install various tools.

CLI Software on macOS

  • lima: Linux virtual machines, typically on macOS, for running containerd.
  • colima: Container runtimes on macOS (and Linux) with minimal setup. Conditional: This is installed when a container runtime is enabled.
  • duti: A command-line tool to select default applications for document types and URL schemes on Mac OS X.
  • mas: Mac App Store command line interface.
  • reattach-to-user-namespace: Reattach to the per-user bootstrap namespace. This is needed for tools like tmux, though tmux 2.6+ apparently incorporates this functionality already.
  • trash: A small command-line program for OS X that moves files or folders to the trash.

CLI Software on Linux and FreeBSD

  • zsh: A shell designed for interactive use, although it is also a powerful scripting language. This is installed by default on macOS.
CLI Software on Arch Linux
  • openssh: The premier connectivity tool for remote login with the SSH protocol.
  • avahi: A system which facilitates service discovery on a local network via mDNS.
  • nss-mdns: A GNU Libc NSS module that provides mDNS host name resolution.
CLI Software on WSL2
  • socat: Multipurpose relay for bidirectional data transfer. This is required for npiperelay.
CLI Software on Chimera Linux
  • podman: A daemonless container engine for developing, managing, and running OCI Containers. Conditional: This is installed when the containers flag is enabled.
  • podman-compose: A script to run docker-compose.yml using podman. Conditional: This is installed when the containers flag is enabled.
    • Note: Chimera Linux uses podman instead of docker due to potential compatibility issues with docker on its BSD userland.

CLI Software on Windows

  • gow: Unix command line utilities installer for Windows.
  • gsudo: Sudo for Windows.
  • npiperelay: Access Windows named pipes from WSL.
  • recycle-bin: Move files and folders to the Windows recycle bin within command line.
  • scoop: A command-line installer for Windows.
  • starship: A cross-shell prompt.
  • winget: Windows Package Manager CLI.

Powershell Modules

  • DirColors: Provides dircolors-like functionality to all System.IO.FilesystemInfo formatters.
  • PSFzf: A PowerShell wrapper around the fuzzy finder fzf.

Powershell Modules on Windows only

Installed GUI Software

  • Zed: A cross-platform text editor. Available via brew, installer script, scoop, or download.

GUI Software on Windows and macOS

  • 1Password: A password manager developed by AgileBits.
  • Discord: A VoIP and instant messaging social platform.
  • Obsidian: A powerful knowledge base that works on top of a local folder of plain text Markdown files. Available on Linux, macOS, and Windows via brew, scoop, flatpak, or download.
  • Vivaldi: Web browser with built-in email client focusing on customization and control.
  • VLC (Open-Source): A free and open source cross-platform multimedia player.
  • If the gaming flag is enabled:
    • Steam: A digital distribution platform for purchasing and playing video games.

GUI Software on Windows

  • SquirrelDisk (Open-Source): Beautiful, Cross-Platform and Super Fast Disk Usage Analysis Tool. Available via scoop, winget.
  • SumatraPDF: A free PDF, eBook, XPS, DjVu, CHM, Comic Book reader for Windows.

GUI Software on macOS (Pre-Sonoma Only)

  • Aerial (Open-Source): A macOS screensaver that lets you play videos from Apple's tvOS screensaver.

GUI Software on macOS

  • AppCleaner: A small application which allows you to thoroughly uninstall unwanted apps.
  • BlockBlock: Monitors common persistence locations and alerts whenever a persistent component is added.
  • Brooklyn (Open-Source): Screen saver based on animations presented during Apple Special Event Brooklyn.
  • Calibre (Open-Source): E-books management software.
  • DaisyDisk: Disk space visualizer. Get a visual breakdown of your disk space in form of an interactive map, reveal the biggest space wasters, and remove them with a simple drag and drop.
  • DevDocs for macOS (Open-Source): An unofficial DevDocs API Documentation viewer for macOS.
  • ForkLift: Advanced dual pane file manager and file transfer client for macOS. Available via brew as forklift.
  • Ice (Open-Source): Powerful menu bar manager for macOS.
  • Karabiner-Elements (Open-Source): A powerful and stable keyboard customizer for macOS.
  • Keka (Open-Source): The macOS file archiver.
  • kitty (Open-Source): The fast, feature-rich, GPU based terminal emulator.
  • LilyView
  • LuLu: The free, open-source firewall that aims to block unknown outgoing connections.
  • Maccy (Open-Source): Lightweight clipboard manager for macOS.
  • MusicHarbor
  • Play: Bookmark and organize videos to watch later.
  • PopClip: Instant text actions.
  • Raycast: Productivity tool, application launcher, snippets, clipboard history, and automation.
  • Readwise Reader: Save everything to one place, highlight like a pro, and replace several apps with Reader.
  • Rectangle (Open-Source): Move and resize windows in macOS using keyboard shortcuts or snap areas.
  • Shifty: Menu bar app that provides more control over Night Shift.
  • If the work flag is enabled:
    • Slack: Team communication and collaboration platform.
    • Zoom: Video conferencing and online meetings.
  • If the gaming flag is enabled:
  • SwiftBar]: Powerful macOS menu bar customization tool. Conditional: This is installed when a container runtime is enabled, as I use this to start/stop colima.
  • SyncThing (Open-Source): A continuous file synchronization program.
  • Transmission Remote GUI (Open-Source): A feature rich cross platform Transmission BitTorrent client. Faster and has more functionality than the built-in web GUI.
  • UnPlugged
  • WhatsYourSign: Add a menu item to Finder to display a file's cryptographic information.
  • WiFi Explorer: Best Wi-Fi Analyzer & Monitor.
  • WiFi Signal: WiFi Connection Status Monitor.
Safari Extensions
QuickLook Plugins
  • Apparency: Preview the contents of a macOS app
  • BetterZip: A trialware file archiver. I only install this for the QuickLook plugin.
  • Suspicious Package: Preview the contents of a standard Apple installer package

GUI Software on Windows

Installed Software on the Steam Deck

  • Decky Loader: A plugin loader for the Steam Deck.
  • CryoUtilities: A utility to improve performance and help manage storage on Steam Deck.
  • EmuDeck: Emulation made easy on steamOS.
  • Shortix: A script that creates human readable symlinks for Proton game prefix.
  • SteamDeckGyroDSU: DSU (cemuhook protocol) server for motion data running on Steam Deck.
  • Firefox: A fast, private, and secure web browser.
  • Flatseal: Manage Flatpak permissions.
  • Protontricks: A wrapper that does winetricks things for Proton enabled games.
  • Ludusavi: Backup tool for PC game saves.
  • Google Chrome: A fast, secure, and free web browser.
    • Only installed to use Kiosk mode for site-specific browsers from Game Mode, which I automatically set up via Steam ROM Manager from my ROM Library setup.

Installed CLI Software on the Steam Deck

  • pkgx: A blazingly fast, standalone, cross‐platform binary that runs anything.
  • rclone: Rsync for cloud storage.
  • restic: Fast, secure, efficient backup program.

Installed Decky Plugins on the Steam Deck

  • NonSteamLaunchers: A Decky Plugin for the integration of Non-Steam launchers and the games installed with them.

Installed Decky Plugins on the Steam Deck via ROM Library, not this setup

Apps I install on an as-needed basis

As needed CLI Software

  • asciinema]: Recording terminal sessions and sharing them on the web. Available via brew, nix, and python.
  • aria2: A lightweight multi-protocol & multi-source, cross platform download utility operated in command-line. It supports HTTP/HTTPS, FTP, SFTP, BitTorrent and Metalink. Available via brew, nix, and scoop.
  • broot: A new way to see and navigate directory trees. Available via brew, nix, scoop, and cargo.
  • chars. Tool to display names and codes for unicode codepoints. Available via brew, nix, and cargo.
  • csview: 📠 Pretty and fast csv viewer for cli with cjk/emoji support. Available via brew, nix, scoop, and cargo.
  • csvkit: A suite of utilities for converting to and working with CSV. Available via brew, nix, and python.
  • dasel: Select, put and delete data from JSON, TOML, YAML, XML and CSV files with a single tool. Available via brew, nix, scoop, and go.
  • dirdiff: Efficiently compute the differences between two directories. Available via cargo as dirdiff-ocamlpro.
  • dog: A command-line DNS client. Available via brew as dog, nix as dogdns, and cargo from the source.
  • doxx: Expose the contents of .docx files without leaving your terminal. Available via cargo from the source.
  • entr: Run arbitrary commands when files change. Available via brew and nix.
  • eva: A simple calculator REPL, similar to bc. Available via brew, nix, and cargo.
  • fast: Minimal zero-dependency utility for testing your internet download speed from terminal. Available via nix as fast-cli and go.
  • fclones: Finds and removes duplicate files. Available via brew, nix, and cargo.
  • ffmpeg: A complete, cross-platform solution to record, convert and stream audio and video. Available via brew, nix, and scoop.
  • flint: Check your project for common sources of contributor friction. Available via brew as flint-checker and go.
  • git-filter-repo: Quickly rewrite git repository history (filter-branch replacement).
  • glab: A GitLab CLI tool bringing GitLab to your command line. Available via system packages (Arch: glab, FreeBSD: glab), Nix, Homebrew, MacPorts, scoop, winget (GLab.GLab), and eget.
  • go: An open source programming language supported by Google
  • hexyl: A simple hex viewer for the terminal. Available via brew, nix, and cargo.
  • htop: An interactive process viewer. Available via brew and nix.
  • httpie: A command-line HTTP client. Available via brew, nix, and python.
  • huniq: Command line utility to remove duplicates from the given input. Available via nix and cargo. Uses less memory than awk/uniq-seen. Rarely needed.
  • hyperfine: A command-line benchmarking tool. Available via brew, nix, and cargo.
  • jc: CLI tool and python library that converts the output of popular command-line tools, file-types, and common strings to JSON, YAML, or Dictionaries. Available via brew, nix, scoop, and pypi.
  • petname: Generate human readable random names. Available via pypi and cargo.
  • procs: A modern replacement for ps written in Rust. Available via brew, nix, scoop, and cargo.
  • pup: A command line tool for processing HTML. Available via brew, nix, and go.
  • qemu: A generic and open source machine emulator and virtualizer. Available via brew, nix, scoop, FreeBSD Ports, winget (as SoftwareFreedomConservancy.QEMU), apk on chimera linux.
  • rclone: Rsync for cloud storage. Available via brew, nix, and scoop.
  • rust: A multi-paradigm, general-purpose programming language.
  • titlecase: A small tool that capitalizes English text. Available via cargo.
  • vivid: A generator for the LS_COLORS environment variable. Available via brew, nix, and cargo.
  • yt-dlp: A feature-rich command-line audio/video downloader. Available via brew, nix, scoop, winget, pacman, FreeBSD ports, pip/uv, and release binaries. Often requires ffmpeg and deno binaries.
    • The release binary can quickly be installed with eget: eget --upgrade-only --asset='^zip' --to=~/.local/bin/yt-dlp yt-dlp/yt-dlp

On my NAS, to download what I own

  • lgogdownloader: Unofficial downloader for GOG.com. Available via brew and nix.

To deal with icons and images

  • icoutils: A set of command-line programs for extracting and converting images in Microsoft Windows(R) icon and cursor files. Available via brew and nix.
  • imagemagick: Create, edit, compose, or convert digital images. Available via brew, nix, and scoop.

For beets

  • mp3val: A small, high-speed, free software tool for checking MPEG audio files' integrity. Available via brew and nix. Also available as direct binary download for Windows.
  • par2cmdline: Available via brew as par2, nix, and scoop.

As Needed CLI Software for macOS

  • makeicns: Create icns files from the command line. Available via brew.
  • terminal-notifier: A command-line tool to send macOS User Notifications. Available via brew and nix.

As Needed CLI Software for Windows

As Needed GUI Software

  • 86Box: Emulator for vintage IBM PC and compatibles. Available via brew as 86box and direct download.
  • Raspberry Pi Imager: Imaging utility to install operating systems to a microSD card. Available via brew as raspberry-pi-imager, winget as RaspberryPiFoundation.RaspberryPiImager, and scoop as extras/raspberry-pi-imager.
  • Battle.net: Blizzard games client. Available via brew as battle-net.
  • CPDT (Cross Platform Disk Test): A disk benchmarking tool for Windows, macOS, and Linux. Available via direct download.
  • czkawka: Multi functional app to find duplicates, empty folders, similar images etc.
  • dupeGuru: A cross-platform GUI tool to find duplicate files in a system.
  • HandBrake: The open source video transcoder. Available via brew as handbrake and winget as HandBrake.HandBrake.
  • jDownloader: A download management tool. Available via brew as jdownloader.
  • Kegworks: A user-friendly tool used to make wine wrapped ports of Windows software for macOS. Formerly Wineskin Winery.
  • LocalSend: Share files to nearby devices. Available via brew as localsend, winget as LocalSend.LocalSend, and scoop as localsend.
  • Malwarebytes: Warns about malware, adware and spyware.
  • MusicBrainz Picard: A cross-platform music tagger. Available via brew as musicbrainz-picard, nix as picard, Microsoft Store, winget as MusicBrainz.Picard, and scoop as picard.
  • Ollama: Get up and running with large language models locally. Available via brew as ollama.
  • Steam: A digital distribution platform. Available via brew, nix, and winget as Valve.Steam.
  • Subler: A macOS app to mux and tag mp4 files. Available via brew as subler.
  • SyncTERM: BBS terminal program. Available via brew as syncterm and direct download for Windows.
  • Transmission: A Fast, Easy and Free Bittorrent Client for macOS, Windows and Linux.
  • Video Duplicate Finder: Cross-platform software to find duplicated video (and image) files on hard disk based on similiarity.

As Needed GUI Software for Windows and macOS

  • SD Card Formatter: Official SD Memory Card Formatter from the SD Association for formatting SD/SDHC/SDXC cards.

As Needed GUI Software for macOS

  • Adapter: Convert Video, Audio and Images. Available via brew as adapter.
  • AmorphousDiskMark: Disk benchmark utility. Available via brew as amorphousdiskmark.
  • AnyToISO: Convert CD/DVD images to ISO format or extract files from them. Available via brew as anytoiso.
  • Apple Configurator: Configure and deploy iPhone, iPad, and Apple TV. Available via Mac App Store.
  • Audio Overload: Emulator for retro video game music. Available via brew as audio-overload.
  • Blackmagic Disk Speed Test: Test your disk performance. Available via Mac App Store.
  • Burn: Simple but advanced burning for Mac OS X. Optional, as disk images can be burned with Finder or hdiutil. Available via brew as burn.
  • Byword: Markdown editor. Available via Mac App Store.
  • DeltaPatcher: GUI and CLI application for creating and applying BPS, IPS, UPS, and xdelta3 binary patches. Available via brew as deltapatcher.
  • Exporter: Export Apple Notes to various formats. Available via Mac App Store.
  • Fluid: Turn Your Favorite Web Apps into Real Mac Apps. Available via brew as fluid.
  • Gemini 2: The intelligent duplicate file finder. Available via brew as gemini.
  • Kindle: Read Kindle books on your Mac. Available via brew as kindle.
  • KnockKnock: See what's persistently installed on your Mac.
  • Marked 2: Markdown previewer. Available via brew as marked.
  • MuffinTerm: A terminal emulator for macOS crafted for the classic BBS experience.
  • Numbers: Create impressive spreadsheets. Available via Mac App Store.
  • Onyx: Verify system files structure, run miscellaneous maintenance and more. Available via brew as onyx.
  • Pages: Documents that stand apart. Available via Mac App Store.
  • PhotoSweeper: A fast & powerful duplicate photos cleaner for Mac. Available via brew as photosweeper-x.
  • Pixelmator Classic: Powerful, full-featured image editor for Mac. Available via Mac App Store.
  • Platypus: Create native Mac applications from command line scripts. Available via brew as platypus.
  • Pocket Sync: Manage your Analogue Pocket's games, saves, and more. Available via brew as pocket-sync.
  • SiteSucker: Download websites from the Internet. Available via Mac App Store.
  • TaskExplorer: Explore all the tasks (processes) running on your Mac with TaskExplorer.
  • TestFlight: Test beta versions of apps. Available via Mac App Store.
  • UTM (Open-Source): Virtual machine manager for macOS. Available via brew as utm and Mac App Store.
  • XLD: Lossless audio decoder.

As Needed GUI Software for Windows (All are available via winget)

  • Autoruns (from Sysinternals): See what programs are configured to startup automatically when your system boots and you login.
  • BleachBit: Clean Your System and Free Disk Space. Available via winget as BleachBit.BleachBit.
  • Exact Audio Copy: Audio grabber for audio CDs using standard CD and DVD-ROM drives
  • foobar2000: Advanced freeware audio player. Available via winget as PeterPawlowski.foobar2000 and scoop as foobar2000.
  • ImDisk: Mount image files of hard drive, cd-rom or floppy.
  • ImgBurn: A lightweight CD / DVD / HD DVD / Blu-ray burning application. Available via winget as LIGHTNINGUK.ImgBurn.
  • Paint.NET: Free image and photo editing software for Windows. Available via scoop as paint.net and winget as dotPDNLLC.paintdotnet.
  • Process Explorer (from Sysinternals): Find out what files, registry keys and other objects processes have open, which DLLs they have loaded, and more.
  • WinImage: A fully-fledged disk-imaging suite for easy creation, reading and editing of many image formats and fileystems.
  • WinSCP: A popular SFTP client and FTP client for Microsoft Windows. Available via scoop, and winget as WinSCP.WinSCP.

As Needed GUI Software for Windows and Linux

  • HexChat: An IRC client based on XChat. Available via brew, nix, scoop, and winget as HexChat.HexChat.

Formerly-Used

Formerly-Used Services

  • Instapaper: A service for saving web pages for later reading.
  • IRCCloud: IRC client. When I do use IRC, I just use a local client on an as-needed basis.

Formerly-Used Fonts

Formerly-Used CLI Software

  • pipx: Install and run python applications in isolated environments. Superceded by uv tool in my workflows.
  • git-branchless: High-velocity, monorepo-scale workflow for Git. I rarely used this, and there are other options for this workflow.
  • sapling: A Scalable, User-Friendly Source Control System. Evaluated but not actively used in my workflows.
  • GNU Screen: A terminal multiplexer. Replaced by tmux.
  • Bitlbee: An IRC to other chat networks gateway.
  • Centericq: A text mode menu- and window-driven instant messaging interface.
  • weechat: A fast, light and extensible chat client.
  • irssi: A modular chat client that is most commonly known for its text mode user interface.
  • EPIC: The Enhanced Programmable IRC-II Client.
  • BitchX: An IRC client.
  • ircii: A terminal-based IRC and ICB client.
  • abduco: Session manager.
  • dvtm: Dynamic virtual terminal manager.
  • dtach: Emulates the detach feature of screen.
  • asdf: Version manager.
  • pyenv: Python version manager.

Formerly-Used GUI Software

Formerly-Used macOS Software

  • Bartender: Organize your menu bar icons. Replaced by Hidden bar, then Ice.
  • CleanMyDrive 2
  • Colloquy (Source): An advanced IRC, SILC & ICB client.
  • f.lux: Software to make your life better. Replaced by macOS Night Shift.
  • FlyCut: Clipboard manager.
  • GoodLinks: Save links, read later. Replaced by Readwise Reader.
  • Hidden Bar (Open-Source): Hide menubar items. Replaced by Ice.
  • Itsycal for Mac: A tiny menu bar calendar. I mostly just click on the date/time and see the calendar widget in the notification panel now.
  • Jumpcut: Clipboard manager.
  • LimeChat (Open-Source): An IRC client for Mac OS X.
  • MacDown: Markdown editor.
  • MacVim: Vim - the text editor - for macOS
  • Magnet: Organize your workspace. Replaced by Rectangle.
  • QLColorCode (Open-Source): QuickLook plugin for syntax highlighting source code. No longer maintained.
  • qlImageSize (Open-Source): QuickLook plugin to display image size and resolution. No longer needed.
  • QLMarkDown (Open-Source): QuickLook plugin for Markdown files. No longer maintained.
  • QLPrettyPatch (Open-Source): QuickLook plugin for patch files. No longer maintained.
  • QLStephen (Open-Source): QuickLook plugin for plain text files without extensions. No longer maintained.
  • quicklook-csv (Open-Source): QuickLook plugin for CSV files. No longer maintained.
  • QuickLookASE (Open-Source): QuickLook plugin for Adobe ASE Color Swatches. No longer needed.
  • QuickLookJSON: QuickLook plugin for JSON files. No longer maintained.
  • QuickSilver: Launcher.
  • SwiftDefaultApps (Open-Source): A preference pane to view and change default application associations. Last release in 2019.
  • Textual: Application for interacting with Internet Relay Chat (IRC) chatrooms. Available via brew.
  • TotalFinder: Finder enhancement.
  • WebPQuickLook (Open-Source): QuickLook plugin for WebP image files. No longer needed.
  • Wineskin Winery: A user-friendly tool used to make ports of Microsoft Windows software to macOS. Replaced by Kegworks.

Formerly-Used Linux Software

Formerly-Used Windows Software

Formerly-Used in Windows 3.x

  • Bitstream MakeUp for Windows: Typographic special effects for desktop publishing.
  • Timeworks Publish-It!: Desktop publishing.

Formerly-Used in Windows 95/98

Formerly-Used DOS Software

  • Mace Utilities from Paul Mace Software, for DOS. I used this much less than the others.
  • PFS Professional Write
  • PFS Professional File
  • Quicken for DOS
  • Norton Utilities for DOS
    • Norton Disk Doctor
    • Norton Speed Disk
  • PC Tools
    • PC Shell
  • Norton Ghost
  • PKUnzip/Zip (pkz204g), Arc, Arj, etc
  • Paragon Partition Manager for DOS
  • Partition Magic

Formerly-Used Browser Extensions

Intentionally Avoided Software

Software that I've used in the past but now actively avoid due to specific issues or problems.

  • Balena Etcher: USB/SD card imaging tool. Caused frequent corruption on SD cards, so I avoid it and use other tools like dd, Raspberry Pi Imager, or Rufus instead.

Implementation Notes

  • Chezmoi is used to apply my dotfiles changes.
  • A script is run by chezmoi which applies my nix home-manager configuration, if nix is installed.
  • .config/git/config is not my main configuration, but is instead a small file which includes my main configuration. This allows for automatic git configuration changes such as vscode's change to credential.manager to be obeyed without it altering my stored git configuration. The downside to this is that these changes will not be highly visible. I may change this back, or keep the including file but track it so the changes are visible.

Reference

Chezmoi Usage

Supported Platforms

  • Linux. Tested on Arch, Ubuntu, and Debian.
  • MacOS.
  • FreeBSD.
  • Windows.

Help

Questions and comments are always welcome, please open an issue.

Contributing

Contributions of all kinds, including feedback, are always welcome!

See CONTRIBUTING.md for ways to get started.

Please adhere to this project's Code of Conduct and follow The Ethical Source Principles.

License

Distributed under the terms of the Blue Oak Model License 1.0.0 license.

See Also

Superseded Projects

Mostly Superseded Projects

About

Primary dotfiles & scripts repository

Resources

Readme

License

View license

Code of conduct

Code of conduct

Contributing

Contributing
Activity

Stars

26 stars

Watchers

4 watching

Forks

1 fork
Report repository

Releases

No releases published

Packages

No packages published

Contributors 2

Languages