{"id":16255144,"url":"https://github.com/fatso83/dotfiles","last_synced_at":"2025-04-08T11:15:01.548Z","repository":{"id":13451054,"uuid":"16140513","full_name":"fatso83/dotfiles","owner":"fatso83","description":"Cross-platform dotfiles shared by macOS and Linux (native and WSL2)","archived":false,"fork":false,"pushed_at":"2024-10-08T14:16:25.000Z","size":1523,"stargazers_count":299,"open_issues_count":1,"forks_count":110,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-10-11T15:27:57.657Z","etag":null,"topics":["cross-platform","dotfiles","inotify","linux","tmux","utilities","vim"],"latest_commit_sha":null,"homepage":"","language":"Vim Script","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"wyouflf/xUtils","license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fatso83.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":"2014-01-22T13:51:05.000Z","updated_at":"2024-10-08T14:16:29.000Z","dependencies_parsed_at":"2023-11-20T04:31:58.881Z","dependency_job_id":"8ddc1a28-58d0-46c0-a892-48632d7247e5","html_url":"https://github.com/fatso83/dotfiles","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fatso83%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fatso83%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fatso83%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fatso83%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fatso83","download_url":"https://codeload.github.com/fatso83/dotfiles/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247829512,"owners_count":21002997,"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":["cross-platform","dotfiles","inotify","linux","tmux","utilities","vim"],"created_at":"2024-10-10T15:28:29.490Z","updated_at":"2025-04-08T11:15:01.516Z","avatar_url":"https://github.com/fatso83.png","language":"Vim Script","readme":"My dot files\n========================\n[![Say Thanks!](https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg)](https://saythanks.io/to/fatso83)\n\nThese are my config files for Bash, VIM, Python, tmux and more. Also includes a handful of [utility scripts](./utils/scripts) \nand quite a lot of [aliases/functions](https://github.com/fatso83/dotfiles/blob/7958268/common-setup/bash.d/aliases_functions) I find useful and re-use quite often.\n\nThis repo is under a [do as you please license](./LICENSE) :)\n\n\n## Intentionally simple\nI really hate code or configuration that I don't understand. It might do magical things, but when things ago awry, and they do, I need to be able to fix it. In this setup, I have handwritten (or at least hand copied :smiley:) every line, and I have tried to document (commit msg or inline comment) why the line exists if it is scary or weird in some way. I encourage you to read the various setup files to understand how it works and prod around yourself :)\n\n\n## Supports per machine/os settings\n\n_Which_ programs to install and _how_ is of course unique to every operating system. This setup supports this quite fine, so I can get my tools, no matter if macOS or WSL2. \n\nSee [`per-host-config/README.md`](./per-host-config/README.md)\n\n### OS independant utils (macOS and Linux friendly)\nSome of the common utilities uses environment switches to handle BSD vs GNU issues and such automatically. Examples of this are `util.esed`  and `util.size`. This way I can use these utils to get (mostly) platform independant scripts :)\n\n## Installation\n\n### WARNING\nThis repo and its configs includes _my settings_, which means that if you run the `./setup.sh` script, it will _overwrite_ your existing configuration files. \nI have taken steps to ensure that any _personal_ settings involving names are not re-used (was causing issues), so your Git committer info will be safe :)\n\n### Steps\n```\ngit clone https://github.com/fatso83/dotfiles\n./dotfiles/setup.sh # and wait until completion ...\n```\n![install vid](./dotfiles-install.gif \"Install video\")\n\nThe first time you run the install it will take some time, mostly due [YouCompleteMe](https://github.com/Valloric/YouCompleteMe), which needs to be downloaded and compiled. It might seem as if the install hangs on this step, but this only takes a lot of time the first time you run setup. On subsequent `./setup.sh` runs, it should not take more than a second or two.\n\n## Debugging\n\n### bash.rc related shell issues\nFor debugging an issue after installing, the first thing is to uncomment the line in `~/.bashrc` that says \"# DEBUG=1\". This will print out lots of debugging info. The second thing to do, once you now approximately where things go wrong is to add `set -x` (print lots of debugging info on commands executing) and `set -e` (exit on first error - should mostly already be set)l\n\n### sourced files\nIf you encounter an issue in a sourced file, it might be a bit difficult to debug if they contain `exit 1` or calls to the `error` util. Just do this instead:\n```\nbash -c \"ROOT=$PWD source ./shared.lib\"\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffatso83%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffatso83%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffatso83%2Fdotfiles/lists"}