{"id":20095942,"url":"https://github.com/pirafrank/dotfiles","last_synced_at":"2025-05-06T05:31:24.070Z","repository":{"id":55073252,"uuid":"417577613","full_name":"pirafrank/dotfiles","owner":"pirafrank","description":"My cross-platform and portable terminal setup. Preview via GitHub Codespace or via my workspace project. Many config, much wow. YMMV.","archived":false,"fork":false,"pushed_at":"2025-04-30T22:07:28.000Z","size":922,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-30T23:20:48.055Z","etag":null,"topics":["alacritty","dotfiles","fzf","git","gnupg","lazygit","linux","neovim","p10k","prezto","scripts-collection","shell","tmux","vim","vimrc","vscode","wezterm","windows-terminal","yazi","zsh"],"latest_commit_sha":null,"homepage":"https://github.com/pirafrank/workspace","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/pirafrank.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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,"zenodo":null}},"created_at":"2021-10-15T17:08:29.000Z","updated_at":"2025-04-30T22:07:31.000Z","dependencies_parsed_at":"2024-01-25T11:43:35.973Z","dependency_job_id":"df9df1b7-2790-4944-baad-aef847bf9199","html_url":"https://github.com/pirafrank/dotfiles","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pirafrank%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pirafrank%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pirafrank%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pirafrank%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pirafrank","download_url":"https://codeload.github.com/pirafrank/dotfiles/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252628902,"owners_count":21779101,"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":["alacritty","dotfiles","fzf","git","gnupg","lazygit","linux","neovim","p10k","prezto","scripts-collection","shell","tmux","vim","vimrc","vscode","wezterm","windows-terminal","yazi","zsh"],"created_at":"2024-11-13T16:57:06.772Z","updated_at":"2025-05-06T05:31:24.058Z","avatar_url":"https://github.com/pirafrank.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# dotfiles\n\nMy dotfiles, simple as that.\n\nThis repo is a never-ending WIP. It's not meant to be sensible for everybody, or anyone, as YMMV. But I hope it may be useful to you somehow.\n\n## Supported platforms\n\nMy daily drivers currently are ~~alacritty~~ wezterm + zsh + tmux on:\n\n- ~~Ubuntu 20.04 WSL 2 on Windows 10 (20H2)~~, upgraded to Ubuntu 22.04 WSL 2 on Windows 11\n- ~~Ubuntu 20.04 desktop~~, upgraded to Ubuntu 22.04 desktop\n\nThese dotfiles are also used on:\n\n- Debian ~~10~~ server accessed via mosh connection on iPad, upgraded to Debian ~~11~~ 12\n- [workspace](https://github.com/pirafrank/workspace) Docker image ([link](https://hub.docker.com/r/pirafrank/workspace))\n- GitHub Codespaces\n- ~~occasionally macOS 10.15 (via iTerm2)~~ I gifted the MacBook to my family!\n\n## Try it out\n\n[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/pirafrank/dotfiles?quickstart=1)\n\nor\n\n```sh\ndocker run -it pirafrank/workspace:latest\n```\n\n## Install\n\nFirst clone the repo to your $HOME.\n\n```sh\ncd \u0026\u0026 git clone https://github.com/pirafrank/dotfiles.git\n```\n\nThen symlink config you want to use or install them all running `zsh install.sh all`. You can also symlink a specific set of dotfiles by running `zsh install.sh SOME_FEATURE`. Check the script content to know more.\n\n`~/.zsh_custom` is automatically sourced if it exists. Create it to add any machine-specific non-interactive (doesn't print to sysout) entries. If you need to add interactive scripts, or scripts that output to sysout, please create `~/.zsh_custom_pre`. It will be loaded in `~/.zshrc` BEFORE Powerlevel10k caching. This is to enable Powerlevel10k instant prompt.\n\n`~/bin2` is automatically added to `$PATH`, if it exists. It is not part of the repo. Create it to add your-own or machine-specific executables.\n\nThat's part of it, there is no real how-to actually. For more info just look at the code.\n\n## Getting started\n\n[`GUIDE.md`](https://github.com/pirafrank/dotfiles/blob/main/GUIDE.md) may (hopefully) help, yet it will forever be incomplete.\n\n## Utilities\n\nLittle utilities are provided in different forms in the following dirs:\n\n- `bin`, as scripts with the dir itself being added to `$PATH`;\n- `zsh/autoloaded`, as zsh functions automatically loaded at shell start;\n- `zsh/common/zsh_aliases`, as shell aliases.\n\nMany of the files and scripts in the `bin` folder come from some other repos of mine and here are gathered. Although those repositories are publicly available on GitHub, I am going to only maintain them in this repo.\n\n## Credits\n\n### Scripts\n\nI wrote most of the scripts in the `bin` folder, with some of them already publicly available as [gists](https://gist.github.com/pirafrank). But others come or contain pieces from the web (twitter? google? stackoverflow?). Honestly I can't remember where I got them from, but you should find the original authors in the comments.\n\n### Themes\n\nThose without *pirafrank* in their name come from the web, credits go to their creators. I keep them here for the sake of simplicity. I'll try to keep this readme updated to keep them all.\n\n- vim themes\n  - [*noctu*](https://github.com/noahfrederick/vim-noctu)\n  - [*dim*](https://github.com/jeffkreeftmeijer/vim-dim)\n- *themerdev*-prefixed themes come from [themer.dev](https://themer.dev/).\n\n## License\n\nCode in this repo is given away for free, as-is and with NO WARRANTY as per the MIT license.\n\nBy the way, if something really blows your mind, I'll be happy if you get in touch with me. I always appreciated feedback!\n\nEnjoy!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpirafrank%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpirafrank%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpirafrank%2Fdotfiles/lists"}