{"id":13395526,"url":"https://github.com/alrra/dotfiles","last_synced_at":"2025-05-14T12:07:04.497Z","repository":{"id":1933415,"uuid":"2862212","full_name":"alrra/dotfiles","owner":"alrra","description":"💻 macOS / Ubuntu dotfiles","archived":false,"fork":false,"pushed_at":"2025-05-05T00:00:48.000Z","size":1800,"stargazers_count":1482,"open_issues_count":0,"forks_count":297,"subscribers_count":48,"default_branch":"main","last_synced_at":"2025-05-05T00:28:03.744Z","etag":null,"topics":["bash","dotfiles","git","macos","shell","snippets","tmux","ubuntu","vim"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alrra.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2011-11-27T18:30:28.000Z","updated_at":"2025-05-05T00:00:51.000Z","dependencies_parsed_at":"2023-07-05T16:00:11.400Z","dependency_job_id":"e4118b3a-6950-40c8-9673-355fd65a2150","html_url":"https://github.com/alrra/dotfiles","commit_stats":{"total_commits":958,"total_committers":15,"mean_commits":63.86666666666667,"dds":"0.018789144050104345","last_synced_commit":"67164523e4dc774cabb33f522a47d1bac4592264"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alrra%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alrra%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alrra%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alrra%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alrra","download_url":"https://codeload.github.com/alrra/dotfiles/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254140741,"owners_count":22021218,"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":["bash","dotfiles","git","macos","shell","snippets","tmux","ubuntu","vim"],"created_at":"2024-07-30T17:02:04.518Z","updated_at":"2025-05-14T12:07:04.428Z","avatar_url":"https://github.com/alrra.png","language":"Shell","readme":"# [Cătălin][repo]’s dotfiles\n\n[![CI status for macOS][ci badge macos]][ci link macos]\n[![CI status for Ubuntu][ci badge ubuntu]][ci link ubuntu]\n\nThese are the base dotfiles that I start with when I set up\na new environment (for more specific local needs I use the\n[`*.local`](#local-settings) files).\n\n## Table of Contents\n\n* [🔧 Setup](#setup)\n* [📸 Screenshots](#screenshots)\n  * [🔁 Git](#git)\n  * [⌨️  Vim](#vim)\n* [💄 Customize](#customize)\n  * [🔀 Forks](#forks)\n  * [🌐 Local Settings](#local-settings)\n    * [🐚 `~/.bash.local`](#bashlocal)\n    * [🔁 `~/.gitconfig.local`](#gitconfiglocal)\n    * [⌨️  `~/.vimrc.local`](#vimrclocal)\n* [↕️  Update](#update)\n* [📑 License](#license)\n\n## Setup\n\nTo set up the dotfiles run the appropriate snippet in the terminal:\n\n\u003e [!CAUTION]\n\u003e __DO NOT__ run the setup script if you do not fully understand\n\u003e [what it does][setup]. Seriously, __DON'T__!\n\n| OS | Snippet |\n|:---|:---|\n| macOS | `bash -c \"$(curl -LsS https://raw.github.com/alrra/dotfiles/main/src/os/setup.sh)\"` |\n| Ubuntu | `bash -c \"$(wget -qO - https://raw.github.com/alrra/dotfiles/main/src/os/setup.sh)\"` |\n\nThat's it! ✨\n\nThe setup process will:\n\n* Download the dotfiles on your computer\n  (by default it will suggest `~/projects/dotfiles`).\n* [Symlink][symlink] the [Git], [shell], [tmux],\n  and [Vim] related files.\n* Install applications / command-line tools for\n  [macOS][install macos] / [Ubuntu][install ubuntu].\n* Set custom [macOS][preferences macos] /\n  [Ubuntu][preferences ubuntu] preferences.\n* Install the [Vim][vim plugins] and\n  [VS Code][vscode plugins] plugins.\n\nSetup process in action:\n\n\u003c!-- markdownlint-disable MD033 --\u003e\n| \u003cvideo src=\"https://user-images.githubusercontent.com/1223565/236653425-5beae04a-39e3-4f29-8113-009e402818e6.mp4\" title=\"Setup process on macOS\"/\u003e |\u003cvideo src=\"https://user-images.githubusercontent.com/1223565/236653424-1702c359-1b68-4815-b3cc-96f6665c5e88.mp4\" title=\"Setup process on Ubuntu\"/\u003e |\n|:---:|:---:|\n\u003c!-- markdownlint-enable MD033 --\u003e\n\n## Screenshots\n\n### Git\n\nOutput for `git status`:\n\n| ![Output for Git status on macOS][git output macos] | ![Output for Git status on Ubuntu][git output ubuntu] |\n|:---:|:---:|\n| macOS | Ubuntu |\n\nOutput for `git log`:\n\n| ![Output for Git log on macOS][git log macos] | ![Output for Git log on Ubuntu][git log ubuntu] |\n|:---:|:---:|\n| macOS | Ubuntu |\n\n### Vim\n\n| ![Vim on macOS][vim macos] | ![Vim on Ubuntu][vim ubuntu] |\n|:---:|:---:|\n| macOS | Ubuntu |\n\n## Customize\n\n### Local Settings\n\nThe dotfiles can be easily extended to suit additional local\nrequirements by using the following files:\n\n#### `~/.bash.local`\n\nThe `~/.bash.local` file will be automatically sourced after all\nthe other [Bash related files][shell], thus, allowing its content\nto add to or overwrite the existing aliases, settings, `PATH`, etc.\n\nHere is an example:\n\n```shell\n#!/bin/bash\n\n# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -\n\n# Set PATH additions.\n\nPATH=\"/Users/alrra/projects/dotfiles/src/bin/:$PATH\"\n\nexport PATH\n\n# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -\n\n# Set local aliases.\n\nalias g=\"git\"\n```\n\n#### `~/.gitconfig.local`\n\nThe `~/.gitconfig.local` file will be automatically included after\nthe configurations from `~/.gitconfig`, thus, allowing its content\nto overwrite or add to the existing Git configurations.\n\n__Note:__ Use `~/.gitconfig.local` to store sensitive information\nsuch as the Git user credentials, e.g.:\n\n```gitconfig\n[commit]\n\n    # Sign commits using GPG.\n    # https://help.github.com/articles/signing-commits-using-gpg/\n\n    gpgSign = true\n\n[user]\n\n    name = Your Name\n    email = account@example.com\n    signingKey = XXXXXXXX\n```\n\n#### `~/.vimrc.local`\n\nThe `~/.vimrc.local` file will be automatically sourced after\n`~/.vimrc`, thus, allowing its content to add or overwrite the\nsettings from `~/.vimrc`.\n\nHere is an example:\n\n```vim\n\" Disable arrow keys in insert mode.\n\ninoremap \u003cDown\u003e  \u003cESC\u003e:echoe \"Use j\"\u003cCR\u003e\ninoremap \u003cLeft\u003e  \u003cESC\u003e:echoe \"Use h\"\u003cCR\u003e\ninoremap \u003cRight\u003e \u003cESC\u003e:echoe \"Use l\"\u003cCR\u003e\ninoremap \u003cUp\u003e    \u003cESC\u003e:echoe \"Use k\"\u003cCR\u003e\n\n\" Disable arrow keys in normal mode.\n\nnnoremap \u003cDown\u003e  :echoe \"Use j\"\u003cCR\u003e\nnnoremap \u003cLeft\u003e  :echoe \"Use h\"\u003cCR\u003e\nnnoremap \u003cRight\u003e :echoe \"Use l\"\u003cCR\u003e\nnnoremap \u003cUp\u003e    :echoe \"Use k\"\u003cCR\u003e\n```\n\n### Forks\n\nIf you decide to [fork] this project, do not forget to substitute\nmy username with your own in the [setup snippets](#setup) and [in\nthe setup script][setup script].\n\n## Update\n\nTo update the dotfiles you can either run the [setup script][setup]\nor, if you want to update one particular part, run the appropriate\n[os script](src/os).\n\n## License\n\nThe code is available under the [MIT license][license].\n\n\u003c!-- Link labels: --\u003e\n\n[ci badge macos]: https://github.com/alrra/dotfiles/workflows/macOS/badge.svg\n[ci badge ubuntu]: https://github.com/alrra/dotfiles/workflows/Ubuntu/badge.svg\n[ci link macos]: https://github.com/alrra/dotfiles/actions?query=workflow%3AmacOS\n[ci link ubuntu]: https://github.com/alrra/dotfiles/actions?query=workflow%3AUbuntu\n[fork]: https://help.github.com/en/github/getting-started-with-github/fork-a-repo\n[git log macos]: https://user-images.githubusercontent.com/1223565/101947422-519fc580-3ba5-11eb-90bc-1438072a45e1.png\n[git log ubuntu]: https://user-images.githubusercontent.com/1223565/101947420-51072f00-3ba5-11eb-9061-efb30ace1c21.png\n[git output macos]: https://user-images.githubusercontent.com/1223565/101947419-51072f00-3ba5-11eb-9e8e-fea987ac97c2.png\n[git output ubuntu]: https://user-images.githubusercontent.com/1223565/101947417-506e9880-3ba5-11eb-805c-0732602c34b3.png\n[Git]: src/git\n[install macos]: src/os/installs/macos\n[install ubuntu]: src/os/installs/ubuntu\n[license]: LICENSE.txt\n[preferences macos]: src/os/preferences/macos\n[preferences ubuntu]: src/os/preferences/ubuntu\n[repo]: https://github.com/alrra\n[setup script]: https://github.com/alrra/dotfiles/blob/main/src/os/setup.sh#L3\n[setup]: src/os/setup.sh\n[shell]: src/shell\n[symlink]: src/os/create_symbolic_links.sh\n[tmux]: src/tmux\n[vim macos]: https://user-images.githubusercontent.com/1223565/101947425-52385c00-3ba5-11eb-9a2a-13e7910d3673.png\n[vim plugins]: src/vim/vim/pack/minpac/start\n[vim ubuntu]: https://user-images.githubusercontent.com/1223565/101947424-519fc580-3ba5-11eb-83b1-e4c3573315a3.png\n[Vim]: src/vim\n[vscode plugins]: src/os/installs/macos/vscode.sh\n","funding_links":[],"categories":["Shell","HarmonyOS","bash"],"sub_categories":["Windows Manager"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falrra%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falrra%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falrra%2Fdotfiles/lists"}