{"id":13581029,"url":"https://github.com/felipecrs/dotfiles","last_synced_at":"2025-05-16T08:07:01.731Z","repository":{"id":37787011,"uuid":"274472059","full_name":"felipecrs/dotfiles","owner":"felipecrs","description":"Bootstrap your Ubuntu in a single command!","archived":false,"fork":false,"pushed_at":"2025-03-28T17:15:36.000Z","size":1062,"stargazers_count":324,"open_issues_count":16,"forks_count":50,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-09T04:01:47.718Z","etag":null,"topics":["bash","chezmoi","convenience-script","dotfiles","linux","shell","ubuntu","wsl","zsh"],"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/felipecrs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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":["felipecrs"]}},"created_at":"2020-06-23T17:48:27.000Z","updated_at":"2025-04-07T13:55:32.000Z","dependencies_parsed_at":"2024-01-14T16:10:17.275Z","dependency_job_id":"361c2b7d-7af2-4ea6-945b-fbf758984908","html_url":"https://github.com/felipecrs/dotfiles","commit_stats":{"total_commits":688,"total_committers":5,"mean_commits":137.6,"dds":0.007267441860465129,"last_synced_commit":"30e90c2057deb20f499d59b6d3894156b8ac2ff5"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipecrs%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipecrs%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipecrs%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipecrs%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/felipecrs","download_url":"https://codeload.github.com/felipecrs/dotfiles/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254493385,"owners_count":22080127,"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","chezmoi","convenience-script","dotfiles","linux","shell","ubuntu","wsl","zsh"],"created_at":"2024-08-01T15:01:57.389Z","updated_at":"2025-05-16T08:06:56.716Z","avatar_url":"https://github.com/felipecrs.png","language":"Shell","readme":"# Felipe Santos' dotfiles\n\nBootstrap your Ubuntu in a single command!\n\n![Sample dotfiles image](https://user-images.githubusercontent.com/29582865/173688885-acd1e312-4741-4ec1-bc9d-b1f31e289749.png)\n\nThis dotfiles repository is currently aimed for [**Ubuntu on WSL**](https://ubuntu.com/wsl), [**Ubuntu Server**](https://ubuntu.com/server), and [**Ubuntu Desktop**](https://ubuntu.com/desktop), tested against versions **20.04**, **22.04** and **24.04**. See how to get started with WSL [here](https://docs.microsoft.com/pt-br/windows/wsl/install-win10).\n\nIt's also suitable for use in [**GitHub Codespaces**](https://docs.github.com/codespaces/customizing-your-codespace/personalizing-codespaces-for-your-account#dotfiles), [**Gitpod**](https://www.gitpod.io/docs/config-dotfiles), [**VS Code Remote - Containers**](https://code.visualstudio.com/docs/remote/containers#_personalizing-with-dotfile-repositories), or even Linux distributions that are not Ubuntu, through the [**minimum mode**](#minimum-mode).\n\nManaged with [`chezmoi`](https://chezmoi.io), a great dotfiles manager.\n\n## Getting started\n\nYou can use the [convenience script](./scripts/install_dotfiles.sh) to install the dotfiles on any machine with a single command. Simply run the following command in your terminal:\n\n```bash\nsh -c \"$(wget -qO- https://git.io/felipecrs-dotfiles)\"\n```\n\n\u003e 💡 We use `wget` here because it comes preinstalled with most Ubuntu versions. But you can also use `curl`:\n\u003e\n\u003e ```bash\n\u003e  sh -c \"$(curl -fsSL https://git.io/felipecrs-dotfiles)\"\n\u003e ```\n\n### Demo\n\nhttps://user-images.githubusercontent.com/29582865/173691636-63a016b2-3e9b-49a4-bb7c-5514c28a77a3.mp4\n\n### Minimum mode\n\nThe installation will ask if you want a **minimum mode installation**. The minimum mode only installs the needed dotfiles for the command prompt and is compatible with more distributions other than Ubuntu.\n\nIt will be enabled by default when running in a Dev Container or in distributions other than Ubuntu. For example, I use it in order to bring my environment to the [Home Assistant VS Code Add-on](https://github.com/hassio-addons/addon-vscode).\n\n## Configuring the terminal font\n\nThis dotfiles uses the ZSH theme [Powerlevel10k](https://github.com/romkatv/powerlevel10k), so it requires you to install a font on your host machine with support for the [Nerd Fonts](https://github.com/ryanoasis/nerd-fonts) glyphs. I recommend the [`FiraCode Nerd Font Mono`](https://github.com/ryanoasis/nerd-fonts/tree/HEAD/patched-fonts/FiraCode#readme).\n\nFor **WSL** and **Ubuntu Desktop**, the dotfiles installation will automatically take care of installing the font and set it up for you in **VS Code**, **Windows Terminal** (for WSL), and **GNOME Terminal** (for Ubuntu Desktop).\n\nOn other systems or terminal emulators, **you will need to configure it manually**. Here are some tips:\n\n### Installing the font on **Windows**\n\n1. [Download it by clicking here](https://raw.githubusercontent.com/ryanoasis/nerd-fonts/HEAD/patched-fonts/FiraCode/Regular/FiraCodeNerdFontMono-Regular.ttf).\n2. Open it and click in **_Install_**.\n3. Restart any applications that you want to load the font into.\n\n### Configuring the font in **VS Code**\n\n1. On **VS Code**, press \u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003e,\u003c/kbd\u003e to open the settings.\n2. Search for \"**Terminal Font Family**\", and write `FiraCode Nerd Font Mono` in the entry named **_Terminal › Integrated: Font Family_**. Like below:\n\n   ![VS Code font configuration example](https://user-images.githubusercontent.com/29582865/218275934-13c6579b-e470-47cf-982d-a192c9627c8e.png)\n\n### Configuring the font in **Windows Terminal**\n\n1. On **Windows Terminal**, press \u003ckbd\u003eCtrl\u003c/kbd\u003e+\u003ckbd\u003e,\u003c/kbd\u003e to open the settings.\n2. Go to **_Profiles -\u003e Defaults_** in the left panel. Then, go to **_Additional settings -\u003e Appearance_**.\n3. At **_Text -\u003e Font face_**, select **_FiraCode Nerd Font Mono_**. Like below:\n\n   ![Windows Terminal font configuration example](https://user-images.githubusercontent.com/29582865/218276062-1b8a299c-cef3-4e80-b557-66cb5ff8a78b.png)\n\n---\n\n## Documentation\n\n**If you followed the steps above so far, you already finished installing the dotfiles. Have fun!**\n\nThe below information is more for reference purposes.\n\n### Convenience script\n\nThe [getting started](#getting-started) step used the [convenience script](./scripts/install_dotfiles.sh) to install this dotfiles. There are some extra options that you can use to tweak the installation if you need.\n\nIt supports some environment variables:\n\n- `DOTFILES_REPO_HOST`: Defaults to `https://github.com`.\n- `DOTFILES_USER`: Defaults to `felipecrs`.\n- `DOTFILES_BRANCH`: Defaults to `master`.\n\nFor example, you can use it to clone and install the dotfiles repository at the `beta` branch with:\n\n```console\nDOTFILES_BRANCH=beta sh -c \"$(wget -qO- https://git.io/felipecrs-dotfiles)\"\n```\n\n### Installing without the convenience script\n\nIf you prefer not to use the convenience script to install the dotfiles, you can also do it manually:\n\n```bash\ngit clone https://github.com/felipecrs/dotfiles \"$HOME/.dotfiles\"\n\n\"$HOME/.dotfiles/install.sh\"\n```\n\n---\n\n### Forking guide\n\nIf you are forking this repository, don't forget to change the following places:\n\n- [`README.md`](./README.md)\n  - Replace all occurrences of `https://git.io/felipecrs-dotfiles` with `https://raw.githubusercontent.com/\u003cyour-username\u003e/dotfiles/HEAD/scripts/install_dotfiles.sh`\n- [`scripts/install_dotfiles.sh`](./scripts/install_dotfiles.sh)\n  - Replace all occurrences of `felipecrs` with `\u003cyour-username\u003e`\n- [`home/.chezmoi.yaml.tmpl`](./home/.chezmoi.yaml.tmpl)\n  - Change the name and email to yours.\n\nWhere `\u003cyour-username\u003e` is your GitHub username.\n\n---\n\n### Extra scripts\n\nThere are some scripts here to help you automate tricky activities when setting up your machine.\n\nIf you already have this dotfiles [installed](#getting-started), you can use these scripts right away. Or, if you want to run it without installing the dotfiles, you can do something like:\n\n```bash\nbash -c \"$(curl -fsSL \"https://raw.githubusercontent.com/felipecrs/dotfiles/master/scripts/\u003cscript-name\u003e\")\" -- \u003carguments\u003e\n```\n\nJust replace `\u003cscript-name\u003e` and `\u003carguments\u003e` with the desired values. Example:\n\n```bash\nbash -c \"$(curl -fsSL \"https://raw.githubusercontent.com/felipecrs/dotfiles/master/scripts/create_alternative_chrome_shortcut.sh\")\" -- --force\n```\n\n#### [`create_alternative_chrome_shortcut.sh`](scripts/create_alternative_chrome_shortcut.sh)\n\n##### Usage\n\n```sh-session\n$ scripts/create_alternative_chrome_shortcut.sh --help\nUsage: scripts/create_alternative_chrome_shortcut.sh [-f|--(no-)force] [-h|--help] [\u003cdisplay-name\u003e]\n        \u003cdisplay-name\u003e: The name which will be displayed in the app launcher (default: 'Alternative')\n        -f, --force, --no-force: Do not ask for confirmation (off by default)\n        -h, --help: Prints help\n\nThis script creates a new shortcut for Google Chrome which opens using a\ndifferent user data directory. This lets you have different icons for different\ninstances of Google Chrome.\n```\n\n##### Examples\n\n```bash\nscripts/create_alternative_chrome_shortcut.sh Personal\n```\n\n##### Demo\n\n![Opening two Chrome instances using different icons](./docs/images/create_alternative_chrome_shortcut.gif)\n","funding_links":["https://github.com/sponsors/felipecrs"],"categories":["Shell","bash"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelipecrs%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffelipecrs%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelipecrs%2Fdotfiles/lists"}