{"id":20174280,"url":"https://github.com/guiltydolphin/dotfiles","last_synced_at":"2025-04-10T03:42:28.353Z","repository":{"id":21496763,"uuid":"24815685","full_name":"GuiltyDolphin/dotfiles","owner":"GuiltyDolphin","description":"Various config files for Linux systems.","archived":false,"fork":false,"pushed_at":"2024-05-27T18:13:37.000Z","size":910,"stargazers_count":11,"open_issues_count":9,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-24T05:01:44.883Z","etag":null,"topics":["bashrc","config","dotfiles","emacs-configuration","guix","keyboard-layout","recipe","vimrc"],"latest_commit_sha":null,"homepage":"","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GuiltyDolphin.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.org","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-10-05T12:57:08.000Z","updated_at":"2023-05-11T15:23:07.000Z","dependencies_parsed_at":"2022-08-21T16:00:46.792Z","dependency_job_id":"89006d7a-3dea-4e38-a33e-30dec6291aa9","html_url":"https://github.com/GuiltyDolphin/dotfiles","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuiltyDolphin%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuiltyDolphin%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuiltyDolphin%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GuiltyDolphin%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GuiltyDolphin","download_url":"https://codeload.github.com/GuiltyDolphin/dotfiles/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248154963,"owners_count":21056541,"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":["bashrc","config","dotfiles","emacs-configuration","guix","keyboard-layout","recipe","vimrc"],"created_at":"2024-11-14T01:42:09.846Z","updated_at":"2025-04-10T03:42:28.318Z","avatar_url":"https://github.com/GuiltyDolphin.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"# dotfiles\n\nMy configuration files for Linux systems.\n\nHosted on [GitHub](https://github.com/GuiltyDolphin/dotfiles).\n\n## Installing\n\n### Overview\n\n#### Setting up the installer\n\nTo set up the installer, you first need to make sure you have\nPerl installed. To check if you have a Perl executable, simply\nrun `type -p perl` in a terminal. If you see a path displayed\n(as in `/usr/bin/perl`), you can move on to the next step,\notherwise you'll need to grab a copy of Perl for your\ndistribution.\n\n**NOTE: By default the bootstrapper tries to configure Perl in\n`~/.local`, if you want to use a different directory, specify\nthe flag `--perl-install-dir` (e.g.,\n`--perl-install-dir=~/.local`)**\n\nOnce you have Perl installed, you can proceed to run\n`./install/bootstrap.pl` (or `perl ./install/bootstrap.pl`),\nwhich will try and configure the installer, and will let you\nknow if it encounters any issues (e.g., missing dependencies\nthat the bootstrapper can't install). If something is failing\nand you're not sure what, try running the bootstrap script\nwith the `--debug` flag.\n\nIf you see a message saying the bootstrapping has been\nsuccessful (e.g., \"Installer bootstrapped!\") at the end of the\noutput, then the installer has been configured, and is ready\nto use!\n\n##### Root\n\nMuch of the software will likely require elevated privileges in order\nto install. Recommended is the `sudo` program with\n\n```\nDefaults\u003eusername !lecture\nusername ALL=(ALL) ALL\n```\n\nin the `/etc/sudoers` file.\n\n#### Commands\n\nFor a complete installation, run the following command: `git\nclone https://github.com/GuiltyDolphin/dotfiles \u0026\u0026 cd dotfiles\n\u0026\u0026 ./install/bootstrap.pl \u0026\u0026 make configure_all` (making sure\nyou have `perl` somewhere on your `PATH`).\n\nIf a full setup is not desired, individual packages can be configured\nvia Make, or the following commands\n(which should be run from the `dotfiles` directory) can be used:\n\n* `make configure_dev`   - sets up a basic development environment.\n* `make configure_tools` - sets up some tools for miscellaneous tasks.\n* `make configure_web`   - configures software for web use.\n\nMore recipes can be found in the `Makefile` file in the `dotfiles` directory.\n\n##### Other Commands\n\n* `make get_solarized_colors` to download the solarized color-scheme\nfor terminal.\n* `make setup_ycm` will configure the `YouCompleteMe` plug-in for\nVim - this may take a while.\n\nTo install/link individual programs, you can use `install_prog` or\n`link_prog` (where `prog` is the required program). Thus `link_tmux`\nwill only install and link `tmux` (and any dependencies).\n\nUsing `install_prog` recipes (e.g., `install_tmux`) will _only_\ninstall the given package (and its dependencies), and will not\nperform any additional configuration.\n\n#### Are my files safe?\n\nThis will (hopefully) not overwrite any existing files when attempting\nto perform a link - it will instead warn you that an existing file\nexists and differs from the source (if you wish to link that file,\nyou will need to move (or remove) the existing file).\n\n##### Configuration Files Used\n\nThe following files are placed/linked when configuring\n(or linking) the given packages:\n\n* `bash`       - will link `.bash/`, `.profile`, and `.bashrc`.\n* `emacs`      - will link `.emacs.d/custom/` and `.emacs.d/init.el`.\n* `ghci`       - will link `.ghci`.\n* `git`        - will link `.gitconfig`.\n* `irb`        - will link `.irbrc`.\n* `tmux`       - will link `.tmux.config`.\n* `tmuxinator` - will link `.tmuxinator`.\n* `vim`        - will link `.vimrc` and `.vim/UltiSnips`.\n* `vimperator` - will link `.vimperatorrc`.\n* `vundle`     - will place `Vundle` in `.vim/bundle/Vundle.vim/`.\n\n#### Caveats\n\nSome of the software is installed via `apt-get install`, which will\nrequire root privileges on most systems, this can be fixed by running\nthe appropriate `make` command with `sudo`; this is not recommended\nhowever, and I am working on making as much of the software install-able\nand configurable without requiring root privileges.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguiltydolphin%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fguiltydolphin%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguiltydolphin%2Fdotfiles/lists"}