shell

My dotfiles and install script.

Install 🚀

Install is easy, just run this one-liner for a nice TUI that shows your options.

sh <(curl https://marx.sh)

See INSTALL.md for more options

Dotfiles 🧩

Git

.gitconfig — Git configuration

GnuPG

gpg-agent.conf — GnuPG agent configuration
gpg.conf — GnuPG configuration

Raycast

clear-format.sh — Strip formatting (while preserving whitespace) from clipboard

skhd

.skhdrc — Configure the hotkey daemon I use (mainly to manage Yabai)

tmux

.tmux.conf — Clean UI, useful info only, Vim-like keybindings

Vim

.vimrc — Vim configuration

yabai

.yabairc — Manage yabai, the tiling window manager I use

Zsh

.aliases — Useful aliases, built to work across all UNIX systems
.functions — Useful functions, built to work across all UNIX systems
.zshrc — My go-to shell setup, leveraging Oh My Zsh (if available)
t3.zsh-theme — A nice, clean theme with everything you need, and nothing more

Packages 📦

The install command is not a package manager, it merely leverages your system’s package manager, whether it be apt, homebrew, dnf, or pacman. It can also run install scripts for packages not in the above indices.

All packages available to install are located in the packages.toml file. Packages are grouped into lists to be installed together. In the TOML file, packages and package groups are initialized as tables ([package_group.packages.package_name]). Each package should have a name key to display when installing the package, as well as description and url keys to assist in building this README. Other possible keys for each package are apt_name, brew_name, brew_cask_name, dnf_name, pacman_name, and install_command.

Core

Core packages I use daily

bat - A cat clone with wings.
cURL - A command line tool for transferring data with URL syntax.
exa - A modern replacement for ls.
fd - A simple, fast and user-friendly alternative to find.
fzf - A command-line fuzzy finder.
git - A fast, scalable, distributed revision control system.
GnuPG - A complete and free implementation of the OpenPGP standard.
Node - A JavaScript runtime built on Chrome's V8 JavaScript engine.
Oh My Zsh - A delightful community-driven framework for managing your zsh configuration.
OpenSSL - A robust, commercial-grade, and full-featured toolkit for the Transport Layer Security (TLS) and Secure Sockets Layer (SSL) protocols.
ripgrep - A line-oriented search tool that recursively searches your current directory for a regex pattern.
tmux - A terminal multiplexer.
Vim - A highly configurable text editor built to enable efficient text editing.
Zsh - A shell designed for interactive use, although it is also a powerful scripting language.

Design

Packages for visual and sound design.

FFmpeg - A complete, cross-platform solution to record, convert and stream audio and video.
ImageMagick - A software suite to create, edit, compose, or convert bitmap images.

GUI Core

GUI apps I use daily.

Clean My Mac - A macOS app to clean up your Mac.
Docker Desktop - A desktop app for MacOS and Windows machines for the building and sharing of containerized applications and microservices.
Dropbox - A file hosting service that offers cloud storage, file synchronization, personal cloud.
IINA - The modern video player for macOS.
iTerm2 - A terminal emulator for macOS that does amazing things.
Little Snitch - A firewall application for macOS that monitors outgoing network connections and allows or denies them.
Mullvad VPN - A VPN service that helps keep your online activity, identity, and location private.
Parallels Desktop - A software for running Windows, Linux, or any other operating system on a Mac without rebooting.
Raycast - A smart command line productivity tool for macOS.
Zoom - A video conferencing, online chat, and web conferencing software.

GUI Design

GUI apps for visual and sound design.

Adobe Creative Cloud - A collection of desktop and mobile apps and services for photography, design, video, web, UX and more.
Cycling ‘74 Max/MSP - A visual programming language for music, audio, and multimedia.
Glyphs - A powerful font editor for macOS.
Rhino 3D - A 3D modeling software for Windows, macOS, and Linux.

williamwmarx/shell