{"id":19938158,"url":"https://github.com/2kabhishek/mac2k","last_synced_at":"2025-05-03T14:32:01.353Z","repository":{"id":170033700,"uuid":"604758595","full_name":"2KAbhishek/mac2k","owner":"2KAbhishek","description":"Ultimate Dev Setup for Mac OS 🚀🍎","archived":false,"fork":false,"pushed_at":"2025-04-05T23:23:02.000Z","size":418,"stargazers_count":22,"open_issues_count":0,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-06T00:20:38.062Z","etag":null,"topics":["cli","command-line","dev","dotfiles","macos","nvim","tiling","tooling","vim"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/2KAbhishek.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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},"funding":{"github":"2kabhishek","buy_me_a_coffee":"2kabhishek"}},"created_at":"2023-02-21T18:19:55.000Z","updated_at":"2025-04-05T23:23:05.000Z","dependencies_parsed_at":"2023-10-15T16:22:55.000Z","dependency_job_id":"7ba9d486-9e34-4a8a-9bc8-4ecde4e8397b","html_url":"https://github.com/2KAbhishek/mac2k","commit_stats":null,"previous_names":["2kabhishek/macfiles","2kabhishek/mac2k"],"tags_count":0,"template":false,"template_full_name":"2KAbhishek/bare-minimum","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2KAbhishek%2Fmac2k","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2KAbhishek%2Fmac2k/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2KAbhishek%2Fmac2k/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2KAbhishek%2Fmac2k/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/2KAbhishek","download_url":"https://codeload.github.com/2KAbhishek/mac2k/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252203265,"owners_count":21710925,"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":["cli","command-line","dev","dotfiles","macos","nvim","tiling","tooling","vim"],"created_at":"2024-11-12T23:38:34.904Z","updated_at":"2025-05-03T14:31:56.344Z","avatar_url":"https://github.com/2KAbhishek.png","language":"Shell","funding_links":["https://github.com/sponsors/2kabhishek","https://buymeacoffee.com/2kabhishek"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align = \"center\"\u003e\n\n\u003ch1\u003e\u003ca href=\"https://github.com/2kabhishek/mac2k\"\u003emac2k\u003c/a\u003e\u003c/h1\u003e\n\n\u003ca href=\"https://github.com/2KAbhishek/mac2k/blob/main/LICENSE\"\u003e\n\u003cimg alt=\"License\" src=\"https://img.shields.io/github/license/2kabhishek/mac2k?style=flat\u0026color=eee\u0026label=\"\u003e \u003c/a\u003e\n\n\u003ca href=\"https://github.com/2KAbhishek/mac2k/graphs/contributors\"\u003e\n\u003cimg alt=\"People\" src=\"https://img.shields.io/github/contributors/2kabhishek/mac2k?style=flat\u0026color=ffaaf2\u0026label=People\"\u003e \u003c/a\u003e\n\n\u003ca href=\"https://github.com/2KAbhishek/mac2k/stargazers\"\u003e\n\u003cimg alt=\"Stars\" src=\"https://img.shields.io/github/stars/2kabhishek/mac2k?style=flat\u0026color=98c379\u0026label=Stars\"\u003e\u003c/a\u003e\n\n\u003ca href=\"https://github.com/2KAbhishek/mac2k/network/members\"\u003e\n\u003cimg alt=\"Forks\" src=\"https://img.shields.io/github/forks/2kabhishek/mac2k?style=flat\u0026color=66a8e0\u0026label=Forks\"\u003e \u003c/a\u003e\n\n\u003ca href=\"https://github.com/2KAbhishek/mac2k/watchers\"\u003e\n\u003cimg alt=\"Watches\" src=\"https://img.shields.io/github/watchers/2kabhishek/mac2k?style=flat\u0026color=f5d08b\u0026label=Watches\"\u003e \u003c/a\u003e\n\n\u003ca href=\"https://github.com/2KAbhishek/mac2k/pulse\"\u003e\n\u003cimg alt=\"Last Updated\" src=\"https://img.shields.io/github/last-commit/2kabhishek/mac2k?style=flat\u0026color=e06c75\u0026label=\"\u003e \u003c/a\u003e\n\n\u003ch3\u003eUltimate Dev Setup for Mac OS 🚀🍎\u003c/h3\u003e\n\n\u003cfigure\u003e\n  \u003cimg src=\"images/screenshot.jpg\" alt=\"mac2k in action\"\u003e\n  \u003cbr/\u003e\n  \u003cfigcaption\u003emac2k in action\u003c/figcaption\u003e\n\u003c/figure\u003e\n\n\u003c/div\u003e\n\nmac2k is a set of handcrafted configs for setting up a complete dev environment on Mac OS.\n\nIt makes developing on Mac much more pleasant for CLI lovers.\n\n## ✨ Features\n\n- Sets up a complete dev environment within minutes\n- Sets up brew and installs essential packages with Brewfile\n- Configures optimal settings for developers\n- All the power and tools provider by [dots2k](https://github.com/2kabhishek/dots2k)\n- Powerful personalized editing with [nvim2k](https://github.com/2kabhishek/nvim2k)\n- Keyboard driven browsing support with [qute2k](https://github.com/2kabhishek/qute2k)\n- Tiling window management with [Aerospace](https://github.com/nikitabobko/AeroSpace)\n- More!!\n\n## Setup\n\n### 🚀 Installation\n\n```bash\ngit clone https://github.com/2kabhishek/mac2k\ncd mac2k\n\n./setup.sh\n```\n\nThis will install all necessary packages, symlinks and setup symlinks for you.\n\nTo manually run steps from [dots2k setup](https://github.com/2kabhishek/dots2k/tree/main/setup.sh) you can run `https://github.com/2kabhishek/dots2k/tree/main/setup.sh`\n\n### 💻 Usage\n\n#### Keybindings\n\nI also set up some keybindings manually, you can find them in the following docs.\n\n\u003e Hint: Cmd = ⌘/Command/Windows, Opt = ⌥/Option/Alt, Ctrl = ⌃/Control, fn = Function\n\n- [MacOS](./docs/macos.md)\n- [Raycast](./docs/raycast.md)\n- [Aerospace](./docs/aerospace.md)\n- [Arc Browser](./docs/arc.md)\n  - [Uses vimium from dots2k](https://github.com/2kabhishek/dots2k/tree/main/docs/vimium.md)\n- [Alacritty from dots2k](https://github.com/2kabhishek/dots2k/tree/main/docs/alacritty.md)\n- [Tmux from tmux-tilit](https://github.com/2kabhishek/tmux-tilit)\n- [Neovim from nvim2k](https://github.com/2kabhishek/nvim2k)\n- [Qutebrowser from qute2k](https://github.com/2kabhishek/qute2k)\n\n#### Aliases\n\nThis also comes with a bunch of mac aliases in [dots2k shell/aliases.sh](https://github.com/2kabhishek/dots2k/tree/main/config/shell/aliases.sh) to make your life easier.\n\n- `aerr`, `aert`, `aerc` for aeropace reload config, toggle and editing config\n- `bri`, `brr`, `brc`, `brs`, `bru` to brew install, uninstall, cleanup, search, update respectively\n- `macdis` to disable mac's internal display, useful when using external display, needs restart to re-enable\n\n#### Other Configs\n\nFor most tools I'm symlinking configs over from [dots2k](https://github.com/2kabhishek/dots2k).\n\n##### Setting up iTerm\n\n\u003e I use Alacritty as my default terminal now\n\nRun iTerm and open \"Preferences\", Go to \"Profiles\" tab and click on \"Other Actions\" and then click on \"Import JSON Profiles\"\n\nSelect the [./configs/iterm/preofile.json](./configs/profile.json) file and import it.\n\nYou can also use the [helper script](./config/iterm/iterm) to open iterm from terminal by symlinking it to your path and running `iterm`.\n\n##### Tiling Window Management\n\n\u003e I use [Aerospace](./config/aerospace/aerospace.toml) as my tiling window manager now\n\n`yabai` and `skhd` together provide a tiling window management system for MacOS.\n\n```bash\n# Symlink yabai and skhd configs\nln -sfn \"$PWD/config/.yabairc\" \"$HOME/\"\nln -sfn \"$PWD/config/.skhdrc\" \"$HOME/\"\n\n# Start yabai and skhd\nyabai --start-service\nskhd --start-service\n\n# Add alias to restart yabai and skhd\nalias macres=\"yabai --restart-service \u0026\u0026 skhd --restart-service\"\n```\n\n## Behind The Code\n\n### 🌈 Inspiration\n\nI am a big fan of CLI and Tiling WMs, MacOS by default doesn't provide a good solution for those, so I decided to configure my own.\n\n### 💡 Challenges/Learnings\n\n- Some hiccups with brew and services\n- Learned and implemented recursive git submodules\n\n### 🧰 Tooling\n\n- [dots2k](https://github.com/2kabhishek/dots2k) — Personalized Dev Environment\n- [nvim2k](https://github.com/2kabhishek/nvim2k) — Personalized Editor\n\n\u003chr\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n\u003cstrong\u003e⭐ hit the star button if you found this useful ⭐\u003c/strong\u003e\u003cbr\u003e\n\n\u003ca href=\"https://github.com/2KAbhishek/mac2k\"\u003eSource\u003c/a\u003e\n| \u003ca href=\"https://2kabhishek.github.io/blog\" target=\"_blank\"\u003eBlog \u003c/a\u003e\n| \u003ca href=\"https://twitter.com/2kabhishek\" target=\"_blank\"\u003eTwitter \u003c/a\u003e\n| \u003ca href=\"https://linkedin.com/in/2kabhishek\" target=\"_blank\"\u003eLinkedIn \u003c/a\u003e\n| \u003ca href=\"https://2kabhishek.github.io/links\" target=\"_blank\"\u003eMore Links \u003c/a\u003e\n| \u003ca href=\"https://2kabhishek.github.io/projects\" target=\"_blank\"\u003eOther Projects \u003c/a\u003e\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F2kabhishek%2Fmac2k","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F2kabhishek%2Fmac2k","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F2kabhishek%2Fmac2k/lists"}