{"id":17086514,"url":"https://github.com/arl/dotfiles","last_synced_at":"2025-04-12T21:12:36.898Z","repository":{"id":36936367,"uuid":"41243670","full_name":"arl/dotfiles","owner":"arl","description":"My dotfiles config... Feel free to use","archived":false,"fork":false,"pushed_at":"2025-03-26T10:23:30.000Z","size":1764,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-12T21:12:23.230Z","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":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/arl.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}},"created_at":"2015-08-23T09:27:58.000Z","updated_at":"2025-03-26T10:23:35.000Z","dependencies_parsed_at":"2023-01-17T07:20:17.786Z","dependency_job_id":"b230c94b-e3db-48cc-88a0-57e49856699e","html_url":"https://github.com/arl/dotfiles","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arl%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arl%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arl%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arl%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arl","download_url":"https://codeload.github.com/arl/dotfiles/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248631681,"owners_count":21136562,"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-10-14T13:28:51.112Z","updated_at":"2025-04-12T21:12:36.876Z","avatar_url":"https://github.com/arl.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"```\n   ____  __ __  ____     ___  _      ____    ___  ____   __  _____\n  /    ⎞⎟  ⎞  ⎞⎟    \\   /  _]⎟ ⎞    l    ⎠  /  _]⎟    \\ ⎛  ⎟/ ___/\n ⎛  A  ⎟⎟  ⎟  ⎟⎟  D  ) /  [_ ⎟ ⎟     ⎟  ⎛  /  [_ ⎟  _  ⎞⎩_ (   \\_\n ⎟     ⎟⎟  ⎟  ⎟⎟    / ⎛    _]⎟ l___  ⎟  ⎟ ⎛    _]⎟  ⎟  ⎟  \\⎠\\__  ⎞\n ⎟  _  ⎟⎟  :  ⎟⎟    \\ ⎟   [_ ⎟     ⎞ ⎟  ⎟ ⎟   [_ ⎟  ⎟  ⎟    /  \\ ⎟\n ⎟  ⎟  ⎟⎟     ⎟⎟  .  ⎞⎟     ⎞⎟     ⎟_⎠  l ⎟     ⎞⎟  ⎟  ⎟    \\    ⎟\n ⎩__⎠__⎠\\__,__⎠⎩__⎠\\_⎠⎩_____⎠⎩_____⎠⎩____⎠⎣_____⎠⎩__⎠__⎠     \\___j\n  ___     ___   ______  _____  ____  _        ___  _____\n ⎟   \\   /   \\ ⎟      ⎞⎟     ⎟l    ⎞⎟ ⎞      /  _]/ ___/\n ⎟    \\ /     ⎞⎟      ⎟⎟   __⎠ ⎟  ⌠ ⎟ ⎟     /  [_(   \\_ \n ⎟  D  ⎞|  O  ⎟⎝_⌠  ⌡_⌡⎟  l_   ⎟  ⎟ ⎟ l___ ⎛    _]\\__  ⎞\n ⎟     ⎟|     ⎟  ⎟  ⎟  ⎟   _]  ⎟  ⎟ ⎟     ⎞⎟   [_ /  \\ ⎟\n ⎟     ⎟⎝     ⎠  ⎟  ⎟  ⎟  T    ⎠  ⎝ ⎟     ⎟⎟     T\\    ⎟\n ⎩_____⎠ \\___/   ⎩__⎠  ⎩__⎠   ⎟____⎠⎩_____⎠⎩_____⎠ \\___⎠\n```\n\n   * [Download and Installation](#download-and-installation)\n   * [Stow packages](#stow-packages)\n     * [dev package](#dev-package)\n     * [os package](#os-package)\n     * [term package](#term-package)\n     * [vim package](#vim-package)\n   * [Disclaimer](#disclaimer)\n   * [Credits and Thanks](#credits-and-thanks)\n   * [\u003ca href=\"LICENSE\"\u003eLICENSE\u003c/a\u003e ](#license)\n\n\n# Welcome to my dotfiles!\n-------------------------\n\nThis is my collection of dotfiles, I use it to manage my bash-vim-tmux\nconfiguration.\n\nSymlinks to `$HOME` directory are handled with the excellent [GNU\nStow](http://www.gnu.org/software/stow/), available by default on every NIX\nsystem package manager, nothing else is needed.  Dot files and dot folders are\nencapsulated into 4 main stow packages\n\n + No error-prone homemade install script\n + Home folder is not polluted with version control files\n + simplicity\n + sobriety\n + clean organization \n\n\n## Download and Installation\n\n**Get The Code**\n\nClone this repository, or better, fork it and clone **yours**:\n\n```sh\n$ cd $HOME\n$ git clone github.com/USERNAME/dotfiles\n$ cd dotfiles\n```\n\nTwo features of my configuration are provided by Github-hosted external projects:\n\n * [vim-plug](https://github.com/junegunn/vim-plug) Minimalist Vim Plugin Manager\n * [gitmux](https://github.com/arl/gitmux) Git in your tmux status bar\n\n\n**Install the dotfiles**\n\nIf your dotfiles repository is located under your `$HOME`, you can simply do,\nwhile you are in your `dotfiles` repository:\n\n```sh\n$ stow dev\n```\n\nThis will create symlinks of everything located under the `dev` stow package\n(i.e the `dev` folder) in your home.\n\nBy default stow assumes you want to place the symlinks in the parent of the\ncurrent working directory, if that's not the case, pass `-t/--target` to set the\ntarget directory, as in `stow -t $HOME dev`\n\n\nYou can also install multiple packages at once. To install *everything*:\n\n```sh\n$ stow bash dev os term vim\n```\n\n## Stow packages\n----------------\nStow packages are simple folders located under the repository root. They\nrepresent and contain the 4 categories of dotfiles:\n \n+ os: operating system global configuration files\n+ vim: full vim configuration (plugins, colorschemes, etc.)\n+ dev: software development tools config\n+ term: terminal configuration\n\n\n### dev package\n\nGlobal configuration for development tools like pylint, gdb and git\n\n\n### os package\n\n - *Consolas* font, patched for use with [Vim lightline](https://github.com/itchyny/lightline.vim)\n - `.profile`\n - a simple system that lets you have some *unversioned* machine-specific settings\n\n\n### term package\n\nPackage aimed at improving your terminal and shell:\n\n+ customized customized tmux config: status-bar, 256 colors, loads of bindings, \n+ a powerful inputrc (global readline configuration file) improving your \n  productivity with each of your tools internally relying on readline (so\nvirtually everywhere you can write!). Every feature is detailed in the\ncomments in [.inputrc](./term/.inputrc)\n+ A clear and informative prompt with colorful .dircolors [github.com/trapd00r/LS_COLORS](https://github.com/trapd00r/LS_COLORS)\n![terminal screenshot](./screenshot.png)\n\n\n### bash package\n\nbash-specific stuff\n+ configuration files\n+ aliases\n+ functions\n+ completion\n\nAll ordered in nice and tidy `.bashrc` files, under `.bashrc.d` directory.\n\n### vim package\n\nI use [vim-plug](https://github.com/junegunn/vim-plug) to manage my vim plugins.\nHere are *some* of them:\n\n - [nerdtree](https://github.com/scrooloose/nerdtree)\n - [vim-go](https://github.com/fatih/vim-go)\n - [vim-fugitive](https://github.com/tpope/vim-fugitive)\n - [taglist](https://github.com/vim-scripts/taglist.vim)\n - [vim-repeat](https://github.com/tpope/vim-repeat)\n - [vim-surround](https://github.com/tpope/vim-surround)\n - [ctrlp](https://github.com/ctrlpvim/ctrlp.vim)\n - [lightline](https://github.com/itchyny/lightline.vim)\n - [deoplete](https://github.com/Shougo/deoplete.nvim)\n\nMy [`.vimrc`](./vim/.vimrc) is well categorized and commented so that you and I\ncan easily find and modify what we are looking for.  Loads of colorschemes, I\nchange them often but eventually come back to\n[desert256](http://www.vim.org/scripts/script.php?script_id=1243)\n\n\n## Disclaimer\n\nI only use Linux (Debian-based) OSes so i can't guarantee those configurations\nwill work anywhere else, not even that you will like any of it ;-) That being\nsaid, mostly everything should work out of the box or with some minor changes,\nadaptations or renamings in order to make it work on other Linux distros or\nOSX (A lot of good stuff comes from other dotfiles repos that targets OSX)\n\nKeep in mind that these dotfiles have been slowly and carefully crafted to suit\nMY needs. I update them regularly as my needs, habits or mood change.\nAnyway, share, transform, use it as a source of inspiration. I'd love to hear\nthat you found something useful here.\n\n\n## Credits and Thanks\n\n+ [Paulirish's Dotfiles](https://github.com/paulirish/dotfiles).\n+ I decided to use GNU stow to manage my dotfiles after reading [Using GNU Stow to manage your dotfiles](http://brandon.invergo.net/news/2012-05-26-using-gnu-stow-to-manage-your-dotfiles.html).\n+ Ascii art generated on [bigtext.org](http://bigtext.org/).\n+ To everybody developing and maintaining the project, files and plugins found here.\n+ TOC generated with [github-markdown-tow](https://github.com/ekalinin/github-markdown-toc)\n\n\n## [LICENSE](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farl%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farl%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farl%2Fdotfiles/lists"}