{"id":18783719,"url":"https://github.com/tomkyle/dotfiles","last_synced_at":"2025-08-03T19:38:12.101Z","repository":{"id":77717052,"uuid":"90666252","full_name":"tomkyle/dotfiles","owner":"tomkyle","description":"My dotfiles for MacOS and Ubuntu","archived":false,"fork":false,"pushed_at":"2024-09-21T15:34:14.000Z","size":178,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-12-29T11:45:40.046Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/tomkyle.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":"2017-05-08T19:45:04.000Z","updated_at":"2021-11-08T07:33:24.000Z","dependencies_parsed_at":"2024-12-29T11:45:38.244Z","dependency_job_id":"e56d95b1-bde5-4f9b-966f-504bfae12424","html_url":"https://github.com/tomkyle/dotfiles","commit_stats":null,"previous_names":[],"tags_count":43,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomkyle%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomkyle%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomkyle%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomkyle%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tomkyle","download_url":"https://codeload.github.com/tomkyle/dotfiles/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239699579,"owners_count":19682574,"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":[],"created_at":"2024-11-07T20:40:24.003Z","updated_at":"2025-02-19T17:16:44.730Z","avatar_url":"https://github.com/tomkyle.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tomkyle/dotfiles\n\n[![Build Status](https://travis-ci.org/tomkyle/dotfiles.svg?branch=master)](https://travis-ci.org/tomkyle/dotfiles)\n\n**Please note:** This repo is under heavy development for now, including BC breaks being possible. So if you like to use it for yor own, you may do so (cautious) and feel warned ;-)\n\n## Dotfiles for your home directory\n\nFile | Purpose\n:----| :-------\n.ackrc | Obligatory parameters for [ack](http://beyondgrep.com/)\n.aliases | Common shell shortcuts \n.bash_prompt | Git-ready prompt in solarized dark theme style\n.editorconfig | Rules for certain filetypes, see [editorconfig.org](http://editorconfig.org/)\n.gitconfig | Global Git [configuration](http://git-scm.com/docs/git-config)\n.nanorc | Nano editor config file \n.nano/ | Syntax highlighting definitions \n.paths | Extensions for the `$PATH` variable\n.screenrc | Screen session info in shell's bottom line\n.zshrc | from [Oh My ZSH!](http://ohmyz.sh/), using the [risto theme](https://github.com/robbyrussell/oh-my-zsh/wiki/Themes#risto). \n\n## OS-specific dotfiles\n\n### Ubuntu\n\nThe installer will put these files from the **ubuntu/** directory into your home folder:\n\n- **.bashrc**\n- **.profile**\n- **.selected_editor**\n- **Brewfile**\n\n### MacOS\n\nThe installer will put these files from the **osx**/ directory into your home folder:\n\n- **.bashrc**\n- **.bash_profile**\n- **.profile**\n- **Brewfile** with latest *nano* 3.2\n\n\n\n## Installation\n\nYou can clone the repository wherever you want. The `install.sh` script will symlink all dotfiles into your `$HOME` directory.\n\n```bash\n$ git clone https://github.com/tomkyle/dotfiles.git dotfiles\n$ dotfiles/install.sh\n\n# On MacOS, run after installation:\n$ brew bundle install\n```\n\nThis installation notes are heavily inspired by [Mathias Bynens' dotfiles repo.](https://github.com/mathiasbynens/dotfiles)\n\n\n\n## Upgrading\n\nCall the **upgrade.sh** script to update the local `dotfiles` repository and call the installer again:\n\n```bash\n$ ~/dotfiles/upgrade.sh\n```\n\n\n\n## Integrate with your system\n\n### .aliases\nThis file contains some common shortcuts. You will want to have your own aliases; simply put them in a `~/.aliases.local`, they will be included automatically by both `.bashrc` and `.zshrc`. – [View source](./.aliases) \n\n### .gitconfig\nMany people use `.gitconfig` for storing their username or email or credentials cache lifetime – nothing a config file to bother with. Instead, store them in a `.gitconfig.local`, it will be included automatically.  – [View source](./.gitconfig) \n\n### .gitignore_global\nList of rules for ignoring files in every Git repository on your computer.\nSee the article [https://help.github.com/articles/ignoring-files/](https://help.github.com/articles/ignoring-files/) on GitHub Help.\n\n### .lessrc\n\nSome configuration for the *less* command, after Top Bug Net's article [“Make the less Command More Powerful”](https://www.topbug.net/blog/2016/09/27/make-gnu-less-more-powerful/). – [View source](./.lessrc) \n\n### .nanorc\n\nNano editor configuration, with syntax hightlighting.\n**N.B.** this file will not be installed as regular file rather than symlink.\n[View source](./.nanorc) \n\n### .paths\n\nThis essentially adds typical bin directories like  `~/bin` and `/usr/local/bin` to the `$PATH` variable, if they exist. Both `.bashrc` and `.zshrc` will include this file. [View source](./.paths)\n\nif you like to add more paths locally, store them in a file `~/.paths.local` which will then be included as well. **Example:**\n\n```bash\n# ~/.paths.local\n\n# Prepend these to the $PATH, if they exist.\ndeclare -a PREPEND_PATHS=(\n\t\"$HOME/foo\"\n)\n\n# Apppend these to the $PATH, if they exist.\ndeclare -a APPEND_PATHS=(\n\t\"$HOME/bar\"\n)\n\n# Prepend Directories\nfor some_dir in \"${PREPEND_PATHS[@]}\"\ndo\n\tif [ -d \"${some_dir}\" ] \u0026\u0026 [[ ${PATH} != *\"${some_dir}\"* ]]; then\n\t    export PATH=\"${some_dir}:${PATH}\"\n\tfi\ndone\n\n# Append Directories\nfor some_dir in \"${APPEND_PATHS[@]}\"\ndo\n\tif [ -d \"${some_dir}\" ] \u0026\u0026 [[ ${PATH} != *\"${some_dir}\"* ]]; then\n\t    export PATH=\"${PATH}:${some_dir}\"\n\tfi\ndone\n\n# Outro\nunset PREPEND_PATHS APPEND_PATHS some_dir;\n```\n\n\n\n### .zshrc\nThis essentially is the default `.zshrc` from [Oh My ZSH!](http://ohmyz.sh/). It additionally includes the `.paths` and `.aliases` to make them available both in bash and zsh. – [View source](./.zshrc) \n\n\n\n## Development\n\nIt is recommended to use **git-flow-avh**\n\n```bash\n# bash \ngit clone https://github.com/tomkyle/dotfiles.git\ncd dotfiles\ngit flow init -d\n\n# should be now on branch 'develop'\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomkyle%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftomkyle%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomkyle%2Fdotfiles/lists"}