{"id":13738501,"url":"https://github.com/isms/dotfiles-copier","last_synced_at":"2025-08-08T04:38:41.811Z","repository":{"id":55880957,"uuid":"56496092","full_name":"isms/dotfiles-copier","owner":"isms","description":"A single script to copy all of your scattered config files to a specified directory. Can automatically `git commit` changes.","archived":false,"fork":false,"pushed_at":"2020-12-09T20:14:13.000Z","size":9,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-04T16:53:38.890Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/isms.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}},"created_at":"2016-04-18T09:47:14.000Z","updated_at":"2023-01-07T20:39:56.000Z","dependencies_parsed_at":"2022-08-15T08:31:04.672Z","dependency_job_id":null,"html_url":"https://github.com/isms/dotfiles-copier","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/isms/dotfiles-copier","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isms%2Fdotfiles-copier","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isms%2Fdotfiles-copier/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isms%2Fdotfiles-copier/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isms%2Fdotfiles-copier/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/isms","download_url":"https://codeload.github.com/isms/dotfiles-copier/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isms%2Fdotfiles-copier/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269365912,"owners_count":24405233,"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","status":"online","status_checked_at":"2025-08-08T02:00:09.200Z","response_time":72,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-08-03T03:02:24.199Z","updated_at":"2025-08-08T04:38:41.771Z","avatar_url":"https://github.com/isms.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# dotfiles-copier\n\nA single script to copy all of your scattered dotfiles and\nconfig folders to a specified directory. Can automatically\n`git commit` changes. Can additionally archive into `.tar.gz` file.\n\n### Example\n\nLet's say we want to keep a Github repo with our various config\nfiles, starting with my `.bashrc`. We define a configuration in\n`~/.dotfiles.yml`:\n\n```yaml\n---\ndest: \"~/.dotfiles\"\ntasks:\n  - src: \"~/.bashrc\"\n```\n\nThen run the script with the `--git-commit` option:\n\n```\n$ dotfiles.py --git-commit\nbackup directory specified as argument\nusing directory /home/isaac/.dotfiles\nhandling task: {'src': '~/.bashrc'}\ncopying file: from [/home/isaac/.bashrc] to [/home/isaac/.dotfiles/.bashrc]\nno git repo found; initializing a new repo\n[master (root-commit) 153aec5] \"Initial commit\"\n 1 file changed, 315 insertions(+)\n create mode 100644 .bashrc\n```\n\nNow let's say we change `~/.bashrc`. If we run the command again,\nit will commit those changes:\n\n```\n$ dotfiles.py --git-commit\n...\ncopying file: from [/home/isaac/.bashrc] to [/home/isaac/.dotfiles/.bashrc]\ncommitting changes to git\n\n[master 99f69c6] \"Updated 2016-04-18T05:32:26.834969\"\n 1 file changed, 1 insertion(+), 1 deletion(-)\n```\n\n### Installation\n\n1. Make sure that the requirements are installed. If you're\ngoing to use the `--git-commit` option, you'll need git installed.\n\n2. You'll probably want to install the Python dependencies system-wide\nso that you don't need to run in a virtual environment.\n\n3. Then just put `dotfiles.py` somewhere on your `PATH`.\n\n### Configuration\n\nYou tell `dotfiles.py` which files to copy into your backup\ndirectory (by default, `~/.dotfiles`) by changing the `tasks`\nentry in a config file (by default, `~/.dotfiles.yml`).\n\nEach task must have a key called `src` which is a file or\ndirectory on your system. By default, each of these `src`\nentries will be copied right into your backup directory.\n\nIf you wish to arrange the files specifically in a subdirectory\nof the backup directory, you can include a `subdir` entry in\nthe task.\n\nTo specify a .tar.gz file, include an archive tag with the path\nto where you want the archive.\n\nHere is an example with subdirs:\n\n```yaml\n---\ndest: \"~/.dotfiles\"\narchive: \"~/.dotfiles.tar.gz\"\ntasks:\n    # misc files from home directory\n  - src: \"~/.bashrc\"\n  - src: \"~/.vimrc\"\n  - src: \"~/.xprofile\"\n  \n  # i3 stuff\n  - src: \"~/.i3\"\n    subdir: \"i3/home\"\n  - src: \"/etc/i3\"\n    subdir: \"i3/etc\"\n  - src: \"/etc/i3status.conf\"\n    subdir: \"i3/etc\"\n\n  # system stuff\n  - src: \"/etc/fstab\"\n    subdir: \"etc\"\n```\n\nThis config will result in the following backup folder:\n\n`~/.dotfiles`\n```\n.\n├── .bashrc\n├── etc\n│   └── fstab\n├── i3\n│   ├── etc\n│   │   ├── i3\n│   │   │   ├── config\n│   │   │   └── config.keycodes\n│   │   └── i3status.conf\n│   └── home\n│       └── .i3\n│           └── config\n├── .vimrc\n└── .xprofile\n```\n\n### Usage\n\n```\nUsage: dotfiles.py [OPTIONS] [CONF_PATH]\n\nOptions:\n  --dotfiles_dir DIRECTORY\n  --git-commit / --no-commit\n  --help                      Show this message and exit.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fisms%2Fdotfiles-copier","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fisms%2Fdotfiles-copier","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fisms%2Fdotfiles-copier/lists"}