{"id":15149006,"url":"https://github.com/szorfein/dots","last_synced_at":"2025-04-06T07:13:46.381Z","repository":{"id":40000113,"uuid":"254456529","full_name":"szorfein/dots","owner":"szorfein","description":"Use chezmoi to install my dotfiles easily on Gentoo, Arch, Void and Debian.","archived":false,"fork":false,"pushed_at":"2024-10-29T13:20:12.000Z","size":9150,"stargazers_count":103,"open_issues_count":0,"forks_count":12,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-10-29T16:02:32.565Z","etag":null,"topics":["archlinux","awesome-wm","awesomewm","chezmoi","debian","dotfiles","emacs","gentoo","kali","linux","pass","pentoo","vim","void"],"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/szorfein.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2020-04-09T19:07:35.000Z","updated_at":"2024-10-29T13:20:16.000Z","dependencies_parsed_at":"2024-10-30T12:31:55.189Z","dependency_job_id":null,"html_url":"https://github.com/szorfein/dots","commit_stats":{"total_commits":172,"total_committers":2,"mean_commits":86.0,"dds":0.005813953488372103,"last_synced_commit":"0a44b7815cd93241840df0da1cc07d8b699f6a35"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/szorfein%2Fdots","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/szorfein%2Fdots/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/szorfein%2Fdots/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/szorfein%2Fdots/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/szorfein","download_url":"https://codeload.github.com/szorfein/dots/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247445671,"owners_count":20939958,"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":["archlinux","awesome-wm","awesomewm","chezmoi","debian","dotfiles","emacs","gentoo","kali","linux","pass","pentoo","vim","void"],"created_at":"2024-09-26T13:41:09.514Z","updated_at":"2025-04-06T07:13:46.363Z","avatar_url":"https://github.com/szorfein.png","language":"Shell","funding_links":["https://liberapay.com/szorfein","https://www.patreon.com/szorfein"],"categories":[],"sub_categories":[],"readme":"# dots\nDotfiles managed by [chezmoi](https://www.chezmoi.io/), [pass](https://www.passwordstore.org/) and [reaver](https://github.com/szorfein/reaver).  \nOnly works on some Linux distro including:\n\n+ `Archlinux`\n+ `Debian`, ... *frozen* from now, i don't recommend install my dotfiles on it, need motivation and time here...\n+ `Gentoo`, tested with systemd, musl (openrc) and/or [binaries](https://wiki.gentoo.org/wiki/Binary_package_guide).\n+ `Void Linux`, tested on a clean install of the [rootfs-glibc](https://voidlinux.org/download/) and [rootfs-musl](https://voidlinux.org/download/).\n\nWhy i use chezmoi?\n+ Even with GNU/Stow, i have to modify a lot of files each time i install/reinstall a new system, i start hating this !\n+ Template are great.\n+ Possibility of encrypt files.\n+ Install and updates are easy.\n\n## Table of contents\n\n\u003c!--ts--\u003e\n\n   * [Packages](#packages)\n   * [Requirements](#requirements)\n   * [Install](#install)\n     * [Clone](#clone-this-repo)\n     * [Config](#config)\n     * [Apply](#apply)\n   * [Update](#update)\n   * [Final settings](#final-settings)\n   * [Left Over](#left-over)\n     * [Issues](#issues)\n     * [Support](#support)\n\n\u003c!--te--\u003e\n\n## Screenshots\n\n| Holy (Wayland) | Focus (Xorg) |\n| --- | --- |\n| ![](https://github.com/szorfein/unix-portfolio/raw/master/holy/clean.jpg) | ![](https://github.com/szorfein/unix-portfolio/raw/master/focus/clean.jpg) |\n\n## Packages\n\n| Cat | Name | Notes |\n|---|---|---|\n| Audio Driver | Alsa or Pulseaudio | Can be change in the config file |\n| Window Manager | Swayfx or Awesome | Wayland or Xorg |\n| Web browser | [brave](https://brave.com/) or [librewolf](https://librewolf.net) | |\n| Image Viewer | imv or feh | Depend of Wayland or Xorg |\n| Lock Screen | [betterlockscreen](https://github.com/pavanjadhaw/betterlockscreen) | Not yet for Wayland |\n| Music Daemon | mpd with playerctl | with ncmpcpp, mpc |\n| Video Player | mpv | |\n| Email reader | neomutt | with [isync](https://isync.sourceforge.io/), customized from [sheoak](https://github.com/sheoak/neomutt-powerline-nerdfonts/) |\n| Taking note | [notesnook](https://notesnook.com/) | Write notes (offline), encrypted, sync on all your devices. |\n| Screen capture | grim or [maim](https://github.com/naelstrof/maim) | Wayland or Xorg |\n| News Reader | [raven](https://ravenreader.app/) | Collect news, read them offline. |\n| Terminal multiplexer | tmux | with catppucin, mode indicator |\n| File Manager | NNN and Thunar or Nemo | Thunar (if choose Alsa) or Nemo (Pulseaudio). Dropped vifm [sdushantha](https://github.com/sdushantha/dotfiles) |\n| Code Editor | Neovim or [doomemacs](https://github.com/doomemacs/doomemacs) | Wayland or Xorg, doom don't work on wayland unless you install Xwayland |\n| IRC client | | Weechat will be dropped soon, Prefer Signal or better [Session](https://getsession.org/), not IRC |\n| Terminal | Wezterm or [xSt](https://github.com/gnotclub/xst) | Wayland or Xorg again |\n| zathura | PDF/Epub viewer | |\n| Shell | ZSH | With [ohmyzsh](https://github.com/ohmyzsh/ohmyzsh), [starship](https://starship.rs), [autosuggestion](https://github.com/zsh-users/zsh-autosuggestions/tree/master), and more... |\n\n## Requirements\n\n### Add an user\nIf need a new user (new system), create one:\n\n    useradd -m -s /bin/bash custom-username\n    passwd custom-username\n\nNext, you need to install and configure `sudo` or `doas`, we need permission to install packages:\n\n    # EDITOR=vi visudo\n    custom-username ALL=(ALL) ALL\n\n### Dependencies\nYou need to install `chezmoi` and `git`.\n\nWith `Gentoo`:\n\n    # emerge -av dev-vcs/git\n    $ curl -fsLS get.chezmoi.io | sh\n\nWith `Arch`:\n\n    # pacman -S chezmoi git vi\n\nWith `Debian`:\n\n    # apt-get install curl git\n    $ curl -fsLS get.chezmoi.io | sh\n\nFor `Voidlinux`:\n\n    # xbps-install -S chezmoi git\n\n## Install\nOnly 4 little steps here\n\n### Clone this repo\n\n    $ chezmoi init https://github.com/szorfein/dots.git\n\nTo test the ansible branch, (also look the branch for additionnal instructions)\n\n    $ chezmoi init https://github.com/szorfein/dots.git --branch=ansible\n\n### Config\nEdit the config file with your favorite text editor.\n\n    $ EDITOR=vim chezmoi edit-config\n\nYou can change for example in `[data]`:\n\n    [data]\n      sound = \"pulseaudio\"\n      web = \"librewolf\"\n\nIt will install firefox rather than brave-bin and modify a lot of things during the install.  \n\n### Apply\n`apply` will install all the dependencies and add files to your $HOME.\n\n    $ chezmoi apply\n\nIf /tmp is protected with `noexec`, you need to tell `chezmoi` to use another dir\n[#1929](https://github.com/twpayne/chezmoi/issues/1929)\n\n    $ mkdir $HOME/tmp\n    $ TMPDIR=$HOME/tmp chezmoi apply\n\n## Update\nFrom time to time, start the update simply with:\n\n    $ chezmoi diff\n    $ chezmoi update\n\n## Doom Emacs\nAfter the first install, if you need-want to use\n[doomemacs](https://github.com/doomemacs/doomemacs), you have to finish the\ninstallation with a single command:\n\n    $ doom sync\n\n## Final settings\nIf you have not yet configure X, change the keyboard layout like this:\n\n    $ localectl list-x11-keymap-layouts | grep fr\n    $ sudo localectl set-x11-keymap fr\n\n## Left Over\n\n### Issues\nFor any questions, comments, feedback or issues, submit a [new issue](https://github.com/szorfein/dots/issues/new).\n\n### Support\nAny support are greatly appreciated, star the repo, donations... thanks you!  \n[![Donate](https://img.shields.io/badge/don-liberapay-1ba9a4)](https://liberapay.com/szorfein) [![Donate](https://img.shields.io/badge/don-patreon-ab69f4)](https://www.patreon.com/szorfein)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fszorfein%2Fdots","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fszorfein%2Fdots","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fszorfein%2Fdots/lists"}