My Dotfiles

I keep my desktop configs in a public repo: github.com/osmancoskun/dotfiles.

It is a Sway + Waybar setup with a small setup script. I tested it on Fedora, Debian/Ubuntu, and Arch. This post explains what is in the repo and how I use it. It is not a copy of the README.

Repo layout

Everything is in one stow package:

~/.dotfiles/
├── home/                 # stow package → symlinked into $HOME
│   ├── .vimrc
│   └── .config/
│       ├── alacritty/
│       ├── sway/
│       └── waybar/
├── setup.sh              # setup script with menu
├── lib/                  # shell files used by setup.sh
├── tui/menu.sh           # text menu
├── scripts/setup/        # helper scripts
└── docker/               # test setup.sh in clean containers

The home/ folder is the main part. Clone the repo, then:

git clone https://github.com/osmancoskun/dotfiles.git ~/.dotfiles
cd ~/.dotfiles
stow --restow --target="$HOME" home

Every file under home/ becomes a symlink in $HOME. After git pull, run stow --restow again to update links. To remove links: stow --delete --target="$HOME" home.

If you only want the configs, that is all you need.

Setup script

setup.sh helps set up a new machine. Run it with no arguments to open a menu:

  1) Update system
  2) Repository packages (git, jq, Node.js, yarn, pnpm, …)
  3) Third-party applications (Chrome, VS Code, Cursor, Discord, …)
  4) Dotfiles & shell (Oh My Zsh, chsh to zsh)
  5) Monitors — Sway (layout / outputs)
  6) Wallpaper (Bing / NASA / Wikipedia — swaybg)
  7) Waybar config — link ~/.config/waybar from dotfiles
  Q) Quit

You can also run each step directly:

./setup.sh repo       # pick repo packages
./setup.sh apps       # pick third-party apps
./setup.sh dotfiles   # Oh My Zsh + chsh
./setup.sh monitors   # Sway monitor wizard
./setup.sh wallpaper  # daily wallpaper installer
./setup.sh waybar     # link waybar config

For scripts, you can skip the menu and pass env vars:

REPO_APPS=git,jq,ripgrep,nodejs,yarn   ./setup.sh repo-install
DESKTOP_APPS=chrome,vscode,cursor      ./setup.sh apps-install
DOTFILES_APPS=omz,chsh                 ./setup.sh dotfiles-install

Logs go to ~/setup.log. Third-party repos (Chrome, VS Code, Cursor, Cloudflare WARP, …) are added only when you pick one of those apps. If you only pick repo packages, no third-party repo is added.

The lib/ folder has the code behind the menu: detect.sh finds your distro, repo-packages.sh and desktop-apps.sh handle the pickers, repos.sh adds third-party repos, omz.sh / shell.sh handle the shell step.

What each step installs

You choose what to install. Nothing installs unless you pick it in the menu or pass keys in env vars.

Step 2 — repository packages (./setup.sh repo / REPO_APPS=…)

Only packages from your distro repos. No third-party repos.

Step 3 — third-party applications (./setup.sh apps / DESKTOP_APPS=…)

Native packages only — no Flatpak. A third-party repo is added only for apps you pick.

Step 4 — dotfiles & shell (./setup.sh dotfiles / DOTFILES_APPS=…)

Step 4 does not run stow or link configs. You still do that by hand (see above).

Steps 5–7 — Sway helpers

These set up parts of your machine. They do not install Sway:

• 5 Monitors — wizard that writes a config.d/ file for your screens
• 6 Wallpaper — installs wallpaper-daily.env + sway autostart; you need swaybg and curl from your distro
• 7 Waybar — links ~/.config/waybar from the repo

Steps 5 and 7 are greyed out in the menu if sway is not installed.

What setup.sh does not install

The setup script is for CLI tools, third-party apps, and shell setup. It does not install your full desktop or link dotfiles for you.

For configs only: install git + stow, clone, and stow. Everything else is optional.

Sway

Sway config is split between home/.config/sway/config and small files in config.d/. Files load in name order — the number at the start sets the order.

The main config is mostly default Sway with a few changes: $mod on Super, vim-style hjkl keys, Alacritty as terminal, Rofi as launcher ($mod+d).

Window rules are in separate files — easy to turn on, off, or move. Dual-monitor layout starts from 50-dual-monitor-layout.conf:

exec_always bash -c '"$HOME/.config/sway/scripts/apply-dual-monitor-layout.sh" >/dev/null 2>&1 &'

Reload after edits: Mod+Shift+c.

Scripts

There are three groups of scripts.

Sway — home/.config/sway/scripts/

apply-dual-monitor-layout.sh — sets up a 4K + 2K dual monitor layout. Runs from the sway config above. Logs to ~/.local/state/sway-dual-monitor.log. Needs jq and swaymsg.

wallpaper-daily.sh — downloads daily wallpapers from Bing, NASA APOD, and/or Wikipedia, then shows them with swaybg. Saves files by date in WALLPAPER_DATA_DIR. Runs in the background from config.d/91-wallpaper-daily.conf.

Useful commands:

wallpaper-daily.sh --once          # download and apply today, then exit
wallpaper-daily.sh --daemon        # change wallpaper on a timer
wallpaper-daily.sh --apply FILE    # use a local image file

Settings are in ~/.config/sway/wallpaper-daily.env (created by ./setup.sh wallpaper):

WALLPAPER_PROVIDERS=bing,nasa
WALLPAPER_ROTATE_SEC=300
WALLPAPER_DATA_DIR="$HOME/.local/share/wallpapers/daily"

Note: 99-background-solid.conf loads after 91-wallpaper-daily.conf. If you never see wallpapers, the solid background may be covering them — turn off or delete that file.

Waybar — home/.config/waybar/

disk-mounts.sh — shows disk used/total. Click to switch between disks. USB disks are added automatically.

DISKS=(/dev/nvme1n1 /dev/nvme0n1)   # change for your machine

net-cycle.sh — shows network icon + IP. Click to switch interface. Skips lo, docker*, veth*, etc.

Both scripts print JSON. config.jsonc already has "return-type": "json".

Setup helpers — scripts/setup/

Waybar

config.jsonc defines the bar layout and connects the custom modules above. style.css sets colours and size.

The disk tooltip shows lsblk --tree in a fixed-width font. The network module only shows real interfaces — not every Docker or libvirt interface.

After config changes: pkill -SIGUSR2 waybar or reload sway.

Vim

home/.vimrc is a full Vim setup. vim-plug installs itself on first run and downloads plugins with PlugInstall --sync. First run can take a while.

Leader key is Space. Undo is saved in ~/.vim/undodir. Clipboard works with unnamedplus. No swap files.

Plugins

UI & theme

Files & search

Editing

Languages & LSP (coc.nvim)

Git

Other

Svelte in Vim

Three things handle Svelte files:

1. Syntax — evanleck/vim-svelte highlights .svelte files
2. LSP — coc-svelte gives code completion and go-to-definition (installs with :CocInstall on first run)
3. Format — Prettier runs on save for *.svelte

coc extensions in .vimrc:

coc-tsserver, coc-json, coc-html, coc-css, coc-eslint,
coc-prettier, coc-pyright, coc-svelte, coc-snippets,
coc-pairs, coc-highlight, coc-spell-checker

Emmet treats Svelte like HTML — in .vimrc:

let g:user_emmet_settings = {
  'svelte' : { 'extends' : 'html' },
}

Web files (including Svelte) use 2-space tabs. Prettier on save for *.js, *.jsx, *.ts, *.tsx, *.css, *.html, *.svelte, *.json, and *.py.

Keys I use most

Tools Vim needs

Some plugins need CLI tools on your system. Many are the same as step 2 in setup.sh:

The dotfiles repo does not install these. Pick nodejs, ripgrep, and git in menu step 2, or install them yourself.

Alacritty

Very small config — home/.config/alacritty/alacritty.toml:

[font]
size = 12.0
[font.normal]
family = "Cascadia Code"
style = "Regular"

That is all. Sway uses Alacritty as the terminal. Everything else is default.

Docker tests

docker/ runs setup.sh in clean Fedora, Debian, and Arch containers:

./docker/run-smoke.sh              # Fedora (default)
./docker/run-smoke.sh debian
./docker/run-smoke.sh arch
./docker/run-smoke.sh all

The repo is mounted read-only at /dotfiles. Only the container changes. Good for checking that setup.sh still works without touching your real machine.

Updating

cd ~/.dotfiles
git pull
stow --restow --target="$HOME" home

Reload sway (Mod+Shift+c) or restart waybar after config changes.

More info

All details — every config file, env var, and setup step — are in the repo README. License is WTFPL v2.