DOTFile Manager, mirror repository: notabug.org/gearsix/dotfm
License
gearsix/dotfm
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
master
Could not load branches
Nothing to show
Could not load tags
Nothing to show
{{ refName }}
default
Name already in use
A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code
-
Clone
Use Git or checkout with SVN using the web URL.
Work fast with our official CLI. Learn more about the CLI.
- Open with GitHub Desktop
- Download ZIP
Sign In Required
Please sign in to use Codespaces.
Launching GitHub Desktop
If nothing happens, download GitHub Desktop and try again.
Launching GitHub Desktop
If nothing happens, download GitHub Desktop and try again.
Launching Xcode
If nothing happens, download Xcode and try again.
Launching Visual Studio Code
Your codespace will open once ready.
There was a problem preparing your codespace, please try again.
Latest commit
Git stats
Files
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
NAME dotfm - a simple script to manage dotfiles. SYNOPSIS dotfm [-h] [-d] [-v] [-q] COMMAND DOTFILE... DESCRIPTION dotfm is designed to be simple and easy to use. It's really just a short-hand for managing symlinks of dotfiles (it's also helpful if you don't want to remember or type out the location of a dotfile everytime you want to modify it). ARGUMENTS -h --help Displays help printout -s --skip Skip prompts where necessary and just use defaults -d --debug Display debug logs -v --version Display dotfm version -q --quiet Tell dotfm to shutup (hide info logs) COMMANDS Multiple DOTFILE args can be passed to each command. Some terminology to avoid confusion: - DOTFILE refers to the filepath of the dotfile to be installed - DESTINATION refers to the location you would usually find a dotfile at. For example, the location for bashrc is ~/.bashrc - ALIAS refers to any name used to call a dotfile installed by dotfm. dotfm recognises the source filepath (DOTFILE) as an alias install, in <DOTFILE> ... Create a symlink to DOTFILE from it's DESTINATION and register it. DOTFILE should be the filepath of the dotfile to install. If this path matches its DESTINATION, then a symlink won't be created but the file will still be registered by dotfm. If DOTFILE is recognised by dotfm, then you will be prompted for an install location and aliases to call the dotfile by. If the --skip option was passed then the defaults will be used. update, up <ALIAS> <DOTFILE> update the source DOTFILE path (of the dotfm-registered dotfile matching ALIAS) that DESTINATION points to. link, ln <FILE> ... hardlink FILE to another destination, ideally a repository with a collection of your dotfiles. remove, rm <ALIAS> ... If ALIAS is recognised, then the DESTINATION of the dotfile will be removed. This is a destructive function, use it carefully. Will only remove the file if the file has been installed by dotfm (and can be found in DOTFM CSV FILE). edit, ed <ALIAS> ... Open DOTFILE in $EDITOR or nano if $EDITOR is not present. DOTFILE should be an alias of the dotfile to edit. list, ls <ALIAS> ... Print a table of the install locations and aliases for all registered dotfiles. If one or more DOTFILE arguments are present, then only dotfiles with matching aliases will be listed. INSTALL Go to the source folder of dotfm and run "sudo make install" or "sudo make link". - "sudo make install" - copy dotfm to the install location (recommended for most users). - "sudo make link" - create a symlink of dotfm from its current location to the install location (useful for development). By default the install location of dotfm is /usr/local/bin/dotfm. To modify this, just edit the value of DESTBINDIR in the Makefile. UNINSTALL Go to the source folder of dotfm and run "sudo make uninstall". ENVIRONMENT EDITOR The text editor to edit dotfiles with. If not present, nano will be used. HOME The home directory of the current user DFMDIR The directory in which your collection of dotfiles live. HINTS I would recommend modifying the "KNOWN" array in src/ dotfm.py to suite your own needs if i've missed any dotfiles you frequently use. AUTHORS & CONTRIBUTORS - gearsix <gearsix@tuta.io> = original author - marta dias - https://www.instagram.com/marta.dias.z/ = the logo
About
DOTFile Manager, mirror repository: notabug.org/gearsix/dotfm