Setup Overview

This section documents the tools, configs, and workflows behind my daily setup. It combines real dotfiles, short tutorials, and practical context so the system is not just shown, but also explained.

The topics below cover the desktop, terminal, shell, notifications, widgets, Git, and supporting tools. Documentation files can be read as rendered guides, while config files stay available as raw source.

Selection

Selected File

workspaces.lua

.config/hypr/lua/workspaces.lua

local M = {}

local special_workspaces = {
    { name = "term", command = function(programs) return programs.terminal end, gaps_out = 48 },
    { name = "firefox", command = "firefox", gaps_out = 48 },
    { name = "discord", command = "discord", gaps_out = 48 },
    { name = "notes", command = "obsidian", gaps_out = { top = 32, right = 240, bottom = 32, left = 240 } },
    { name = "files", command = function(programs) return programs.terminal .. " -e yazi" end, gaps_out = 48 },
    { name = "music", command = "chromium --app=https://music.youtube.com", gaps_out = 48 },
    { name = "cmus", command = function(programs) return programs.terminal .. " -e cmus" end, gaps_out = 48 },
}

function M.setup(programs)
    for _, workspace in ipairs(special_workspaces) do
        local command = workspace.command

        if type(command) == "function" then
            command = command(programs)
        end

        hl.workspace_rule({
            workspace = "special:" .. workspace.name,
            on_created_empty = command,
            gaps_out = workspace.gaps_out,
        })
    end
end

return M