{"id":15712397,"url":"https://github.com/ovk/dotfiles","last_synced_at":"2025-04-30T22:49:18.375Z","repository":{"id":43473905,"uuid":"274001969","full_name":"ovk/dotfiles","owner":"ovk","description":"Configuration files for common *nix tools","archived":false,"fork":false,"pushed_at":"2025-01-01T19:27:28.000Z","size":162,"stargazers_count":20,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-30T22:49:12.521Z","etag":null,"topics":["arch-linux","archlinux","dotfiles","fish","linux","neovim","sway","vifm"],"latest_commit_sha":null,"homepage":"","language":"Lua","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/ovk.png","metadata":{"files":{"readme":"README.md","changelog":"newsboat/config","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-06-21T23:53:39.000Z","updated_at":"2025-01-01T19:27:32.000Z","dependencies_parsed_at":"2023-01-30T18:45:38.924Z","dependency_job_id":"d444db2d-0e86-4cf4-bf48-61b89c66e3a0","html_url":"https://github.com/ovk/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/ovk%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ovk%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ovk%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ovk%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ovk","download_url":"https://codeload.github.com/ovk/dotfiles/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251795387,"owners_count":21645019,"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":["arch-linux","archlinux","dotfiles","fish","linux","neovim","sway","vifm"],"created_at":"2024-10-03T21:15:59.726Z","updated_at":"2025-04-30T22:49:18.351Z","avatar_url":"https://github.com/ovk.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n### :house:\n\n\u003c/div\u003e\n\n## Overview\n\nThis repository contains my dotfiles (those that can be safely shared).\nDotfiles are managed with [dotref](https://github.com/ovk/dotref) tool,\nwhich is a simple Python tool that I created to help me manage dotfiles for multiple devices.\n\n\u003e **Note**\n\u003e\n\u003e Many dotfiles in this repo require software to be on the most recent versions.\n\u003e While this is usually not a problem for distros like Arch, it may not work\n\u003e for distros that contain outdated software by default (like Debian or Ubuntu).\n\n### Screenshots\n\n![image](https://user-images.githubusercontent.com/693072/185769726-b8eeb07b-0938-4720-be8e-daf404bc6ee6.png)\n\n![image](https://user-images.githubusercontent.com/693072/185769737-782ba3b6-ef67-47d7-8c1b-58602f1beb0c.png)\n\n![image](https://user-images.githubusercontent.com/693072/185769746-622331cf-5e0e-4fd1-9925-18213557234a.png)\n\n## Included configuration\n\n### Colors\n\nIn general, Nord-like low contrast colors are used in most places (except GTK and Qt themes, see below).\n\n### Basic tools\n\nThe `base` profile includes configurations for the most essential tools:\n\n- [Fish](https://fishshell.com/) - smart and user-friendly command line shell\n- [Neovim](https://neovim.io/) - hyperextensible Vim-based text editor\n- [Vifm](https://vifm.info/) - file manager with curses interface, which provides Vim-like environment for managing objects within file systems\n- [Git](https://git-scm.com/) - distributed version control system\n- [Tig](https://jonas.github.io/tig/) - text-mode interface for Git\n- [Tmux](https://github.com/tmux/tmux) - terminal multiplexor\n- [Htop](https://htop.dev/) - interactive process viewer\n\n### Desktop\n\nThe `desktop` profile builds on top of the `base` profile and contains configuration\nfor the desktop environment based on Sway:\n\n- [Foot](https://codeberg.org/dnkl/foot) - fast, lightweight and minimalistic Wayland terminal emulator\n- [Sway](https://swaywm.org/) - tiling Wayland compositor\n- [Waybar](https://github.com/Alexays/Waybar) - highly customizable Wayland bar for Sway and Wlroots based compositors\n- [Wofi](https://hg.sr.ht/~scoopta/wofi) - launcher/menu program for Wlroots based Wayland compositors such as Sway\n- [Swaylock](https://github.com/swaywm/swaylock) - screen locker for Wayland\n- [Mako](https://github.com/emersion/mako) - lightweight Wayland notification daemon\n- [Imv](https://sr.ht/~exec64/imv/) - command line image viewer intended for use with tiling window managers\n- [Newsboat](https://newsboat.org/) - RSS/Atom feed reader for the text console\n\nPlease note, that this repository only contains user dotfiles and system config files\n(such as, for example, for login manager) are not part of this repo.\n\n#### Fonts and themes\n\nGraphical environment is configured to use [Noto](https://fonts.google.com/noto) fonts,\nwhile terminal uses [Ubuntu](https://design.ubuntu.com/font/) font.\n[Nerd Fonts](https://www.nerdfonts.com/) used for icons.\n\nDotfiles also include configuration for Qt and GTK themes.\nArc is used at the main theme and Papirus as the icon theme.\n\n## XDG\n\nWhere possible, dotfiles follow [XDG Base Directory specification](https://wiki.archlinux.org/title/XDG_Base_Directory).\n[xdg-ninja](https://github.com/b3nj5m1n/xdg-ninja) is a great tool that can help to detect and move\nconfig files from home directory to appropriate XDG directory.\n\nDotfiles in this repository assume that all XDG user directories are at their default locations.\n\n## Environment\n\nMaking sure that user environment variables are consistent across all login sessions is notoriously\ndifficult in Linux (see [this](https://mywiki.wooledge.org/DotFiles) great article for a short overview).\nEven more so, after `pam_environment` deprecation.\n\nIn this repository, all user environment variables are configured in `~/.profile` file.\nWhile this file is read by most login managers (e.g. Greetd, which is what I use) and POSIX shells (such as bash),\nfish shell doesn't read it.\nAs a workaround, `config.fish` runs this file in a bash login session and imports additional\nenvironment. See `import_posix_env ` function in the `fish/functions/import_posix_env .fish` file.\nThis is only done if environment variables from the `~/.profile` weren't already imported (e.g. by login manager).\n\n## How to use\n\nSee [dotref](https://github.com/ovk/dotref) page for the complete documentation on\nhow to use Dotref for dotfile management.\nThe easiest way to start is to clone this repository somewhere, select `base` profile and apply it\nto the system.\n\nClone the dotfiles repository:\n\n```\ngit clone --depth 1 https://github.com/ovk/dotfiles\ncd dotfiles\n```\n\nCheck Dotref profiles list with `dotref profiles` and select `base` profile:\n\n```\ndotref init -p base\n```\n\nSee what will be changed with `dotref status` command, and if it looks sane,\napply the dotfiles:\n\n```\ndotref sync\n```\n\nPlease note, that if there are any conflicts (i.e. you already have a config file which should otherwise\nbe overwritten by dotref) you have to resolve them manually, for example, by backing up and\nremoving conflicting config files.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fovk%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fovk%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fovk%2Fdotfiles/lists"}