{"id":25450823,"url":"https://github.com/xf5i/dotfiles","last_synced_at":"2026-04-09T08:43:34.752Z","repository":{"id":276818000,"uuid":"930401410","full_name":"xf5i/dotfiles","owner":"xf5i","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-10T16:24:17.000Z","size":25099,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-17T20:55:26.293Z","etag":null,"topics":["dotfiles","dotfiles-macos","fastfetch","fish-shell","ghostty-terminal","nvim","skhd","yabai"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xf5i.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-10T15:21:03.000Z","updated_at":"2025-02-10T16:24:21.000Z","dependencies_parsed_at":"2025-02-10T16:44:40.957Z","dependency_job_id":null,"html_url":"https://github.com/xf5i/dotfiles","commit_stats":null,"previous_names":["explicitlymeanbutsupercoolusernameabcde/dotfiles"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xf5i%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xf5i%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xf5i%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xf5i%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xf5i","download_url":"https://codeload.github.com/xf5i/dotfiles/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254505202,"owners_count":22082153,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dotfiles","dotfiles-macos","fastfetch","fish-shell","ghostty-terminal","nvim","skhd","yabai"],"created_at":"2025-02-17T22:16:12.362Z","updated_at":"2026-04-09T08:43:34.713Z","avatar_url":"https://github.com/xf5i.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# 🖥️ macOS Dotfiles \u0026 Configuration  \n\nThis repository contains my **personal macOS configuration** tailored for Apple Silicon (M1/M2/M3) users. It includes a **tiling window manager**, a **customized terminal experience**, and an optimized **Neovim** setup.\n\n\nHere are some screenshots:\n\n![Image 0](./images/img0.png)\n![Image 1](./images/img1.png)\n![Image 2](./images/img2.png)\n\n## **🚀 Features**\n- **Window Manager**: [yabai](https://github.com/koekeishiya/yabai) - dynamic tiling window manager for macOS.\n- **Hotkey Daemon**: [skhd](https://github.com/koekeishiya/skhd) - global keyboard shortcuts.\n- **Terminal**: [Ghostty](https://ghostty.dev) - modern, GPU-accelerated terminal.\n- **Shell**: [Fish Shell](https://fishshell.com) - user-friendly, autosuggestion-based shell.\n- **Prompt**: [Starship](https://starship.rs) - fast and customizable prompt.\n- **Editor**: [Neovim](https://neovim.io) with [LazyVim](https://www.lazyvim.org/) for a feature-rich experience.\n- **Package Manager**: [Homebrew](https://brew.sh) for easy package management.\n\n### **1️⃣ Install Required Packages**  \nInstall essential dependencies using **Homebrew**:  \n\n```sh\nbrew install ghostty\nbrew install yabai\nbrew install skhd\nbrew install nvim\nbrew install lazyvim\nbrew install fish\nbrew install starship\nbrew install git\n```\n### **2️⃣ Install Extra Utilities (optional, but recommended)**\n```sh \nbrew install bat          # Better cat with syntax highlighting\nbrew install borders      # Floating window decorations for yabai\nbrew install fastfetch    # System info display (faster than neofetch)\nbrew install fortune      # Display random quotes\nbrew install zoxide       # Smarter cd command\n```\n\n### **3️⃣ Clone This Repository**\n`git clone https://github.com/xf6i/dotfiles.git ~/.config`\n\n### **4️⃣ Enable Services**\nStart yabai and skhd to ensure they launch at startup:\n```sh \nbrew services start yabai\nbrew services start skhd\n```\n\n## **📂 Folder Structure**\nHere’s how the repository is structured:\n```\n~/.config/\n├── borders/\n│   └── bordersrc         # Configuration for floating window decorations\n├── fastfetch/\n│   └── config.jsonc      # Configuration for system info display\n├── fish/\n│   ├── functions/        # Custom Fish functions\n│   └── config.fish       # Main Fish shell configuration\n├── ghostty/\n│   ├── shaders/          # Shader files for terminal effects\n│   └── ghostty           # Terminal configuration file\n├── karabiner/\n│   └── karabiner.json    # Hotkey remapping configuration\n├── nvim/\n│   ├── lua/              # Lua-based Neovim configurations\n│   ├── init.lua          # Main Neovim configuration\n│   ├── lazy-lock.json    # Lockfile for LazyVim plugins\n│   └── lazyvim.json      # LazyVim-specific configuration\n├── skhd/\n│   └── skhdrc            # Hotkey configuration file\n├── yabai/\n│   ├── startup.sh        # Script to start Yabai\n│   └── window_gap        # Custom gaps configuration\n├── starship.toml         # Starship prompt configuration\n└── README.md             # Documentation for the configuration\n\n```\n## **🎛️ Custom Keybindings (SKHD)**\nThe **skhd** configuration includes custom keybindings for efficient window and system management.\n\n| Keybinding        | Action                                 |\n|-------------------|---------------------------------------|\n| `cmd + j`         | Focus window down                    |\n| `cmd + k`         | Focus window up                      |\n| `cmd + h`         | Focus window left                    |\n| `cmd + l`         | Focus window right                   |\n| `cmd + enter`     | Swap window with the main window      |\n| `cmd + shift + r` | Restart **yabai**                    |\n\nCustomize keybindings in `~/.config/skhd/skhdrc`.\n\n\n## **🌟 Customization**\n- **Neovim**: Add or remove plugins in `~/.config/nvim/lua/plugins/`.\n- **Yabai**: Edit tiling window manager settings in `~/.config/yabai/startup.sh`.\n- **Fish Shell**: Adjust shell options in `~/.config/fish/config.fish`.\n- **Starship Prompt**: Change the appearance in `~/.config/starship.toml`.\n\n## **📜 License**\nThis repository is licensed under the **MIT License**. Feel free to use and modify it.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxf5i%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxf5i%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxf5i%2Fdotfiles/lists"}