dotfiles

Personal configuration files, install scripts and project scaffolding — primarily for a Go-centric workflow across Linux, Termux and Windows.

git clone git@github.com:andrqxa-tools/dotfiles.git
cd dotfiles

Then symlink the pieces you need (see Usage).

Symlink or copy the configs to their real locations. Common targets:

# VS Code (Linux)
ln -sf "$PWD/Editors/VSCode/settings.json" ~/.config/Code/User/settings.json

# NvChad 2.5: bootstrap the starter first, then point config at this repo
#   git clone https://github.com/NvChad/starter ~/.config/nvim && rm -rf ~/.config/nvim/.git
ln -sfn "$PWD/Editors/NeoVim/NvChad/lua"          ~/.config/nvim/lua
ln -sf  "$PWD/Editors/NeoVim/NvChad/init.lua"     ~/.config/nvim/init.lua
ln -sf  "$PWD/Editors/NeoVim/NvChad/.stylua.toml" ~/.config/nvim/.stylua.toml

# Emacs
ln -sf "$PWD/Editors/Emacs/.emacs.d/init.el" ~/.emacs.d/init.el

# Helix
ln -sf "$PWD/Editors/helix/config.toml" ~/.config/helix/config.toml

# micro
ln -sf "$PWD/Editors/micro/settings.json" ~/.config/micro/settings.json

# tmux (Linux/macOS) — psmux on Windows reads the same file as ~/.tmux.conf
ln -sf "$PWD/Tmux/tmux.conf" ~/.config/tmux/tmux.conf

# IntelliJ IDEA VM options (OS-independent, version-independent)
export IDEA_VM_OPTIONS="$PWD/IDE/IntelliJ-IDEA/idea64.vmoptions"   # add to your shell rc

# Flutter/Android toolchain env (mabrook) — sourced by the profile.d loader
ln -sf "$PWD/Shell/profile.d/flutter.sh" ~/.config/profile.d/flutter.sh
# then run the installer for the SDK/JDK/FVM (see Flutter/README.md):
#   ./Flutter/setup-android-env.sh --emulator

VS Code extensions are managed by built-in Settings Sync, not tracked here.

./Fonts/install-linux.sh      # requires curl, jq, fontconfig
./Fonts/install-termux.sh     # Termux

.\Fonts\install-windows.ps1   # Windows (per-user font dir)

Install mpv, fzf and the console radio command on Linux:

./Radio/install-linux.sh
radio

The installer supports apt, dnf, pacman and zypper. It deploys only user files under ~/.local/bin and ~/.config/radio; the global mpv config is untouched.

Install mpv, fzf, a fresh yt-dlp (via pipx) and the console yt command:

./YouTube/install-linux.sh
yt queen bohemian rhapsody     # search, pick in fzf, listen
yt v <query|URL>               # video inside the terminal (kitty/sixel/tct)
yt fav                         # play a bookmarked channel or playlist

While playing: ←/→ seek ±5 s, Shift ±30 s, ↑/↓ ±60 s, 0…9 jump to 0…90 % of the length, t types an exact position (mm:ss, 42%, +30).

Deploys only user files under ~/.local/bin and ~/.config/yt. See YouTube/README.md for bookmarks, terminal-video backends and troubleshooting. For the full YouTube format list, add the Deno runtime below — yt-dlp needs a JS engine to decipher signatures.

Only reason it is here: yt-dlp needs a JavaScript runtime, and deno is the only one it enables by default. Without it YouTube exposes a truncated format list and yt-dlp warns No supported JavaScript runtime could be found.

./Deno/deno-install.sh                     # latest, auto arch
./Deno/deno-install.sh 2.9.4 amd64         # or pin version + arch
./Deno/deno-install.sh --force             # re-download the same version

powershell -ExecutionPolicy Bypass -File Deno\deno-install.ps1

• Linux: single static binary at /opt/programming/deno/bin/deno; env comes from Shell/profile.d/deno.sh, symlinked into ~/.config/profile.d/.
• Windows: C:\Programms\deno\bin\deno.exe + persistent per-user env/PATH.

Install / update the toolchain:

./Go/go-install.sh                         # Linux: install/update to latest (auto arch)
./Go/go-install.sh 1.26.2 amd64            # or pin version + arch

# Windows: install/update to the latest release (auto-detects arch)
powershell -ExecutionPolicy Bypass -File Go\go-install.ps1
powershell -ExecutionPolicy Bypass -File Go\go-install.ps1 -Version 1.26.2   # pin a version

• Linux: GOROOT /opt/programming/go, GOPATH $HOME/go; env written to ~/.config/profile.d/go.sh (+ fish conf.d/go.fish), wired for bash/zsh/fish.
• Windows: GOROOT C:\Programms\go, GOPATH %USERPROFILE%\go; persistent per-user env vars + PATH (visible to console and GUI). Re-run to upgrade.

Installing Go does not update the tools in $GOPATH/bin (gopls, dlv, staticcheck, …). After a major Go upgrade, rebuild them at latest:

./Go/update-go-tools.sh                    # Linux

powershell -ExecutionPolicy Bypass -File Go\update-go-tools.ps1   # Windows

The list is auto-discovered from each binary's module info; golangci-lint is skipped (it runs from a pinned Docker image — bump that by hand).

Scaffold a new Go project:

./Go/create_go_project.sh myapp clean 8080   # name, type, port (type/port prompted if omitted)

powershell -ExecutionPolicy Bypass -File Go\create_go_project.ps1 myapp clean 8080

• Type picks the layout: web (monolith), microservice (API/transport), clean (domain/usecase/adapter/infra), or minimal. Empty dirs get a .gitkeep so they survive git.
• Generates a working net/http server (/healthz + graceful shutdown), reading the address from HTTP_ADDR, so task run and the container start without arguments.
• Task (Taskfile.yml) replaces Make — task run|build|test|lint|tidy|dc; installed automatically via go install if missing.
• task lint runs a pinned golangci-lint Docker image, so every machine lints with the exact same version; shared config in .golangci.yml.
• Dockerfile (alpine, non-root) + Compose with a /healthz healthcheck.