Skip to content
rc file (dotfile) management
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
arch Bump to 1.3.1, prepare for release Dec 26, 2016
bin avoid cd having issues with paths that begin with - Jul 6, 2018
debian
homebrew Update build docs and Homebrew Jul 13, 2018
maint
man
share
test Expand DOTFILE_DIR tilde in hooks Jul 13, 2018
.gitignore
.mailmap Run hooks in a defined order Nov 12, 2016
CODE_OF_CONDUCT.md
CONTRIBUTING.md
DEVELOPERS.md Remove myself from the package maintainers list Jul 13, 2018
INSTALL
LICENSE Update the copyright, assign it to thoughtbot May 5, 2014
Makefile.am Expand ~ in DOTFILES_DIRS Oct 27, 2017
NEWS.md.in
README.md Bump 1.3.3 Jul 13, 2018
autogen.sh
configure.ac Bump 1.3.3 Jul 13, 2018

README.md

rcm

This is a management suite for dotfiles. See the tutorial to get started quickly.

It assumes that you have a separate dotfiles directory, or are interested in creating one.

The programs provided are rcup(1), mkrc(1), rcdn(1), and lsrc(1). They are explained in the tutorial and configured using rcrc(5).

Installation

Alpine Linux:

sudo apk add rcm

Arch Linux:

https://aur.archlinux.org/packages/rcm/

Debian-based:

wget -qO - https://apt.thoughtbot.com/thoughtbot.gpg.key | sudo apt-key add -
echo "deb https://apt.thoughtbot.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/thoughtbot.list
sudo apt-get update
sudo apt-get install rcm

Fedora 22, 23, 24, 25:

sudo dnf copr enable seeitcoming/rcm
sudo dnf install rcm

FreeBSD:

sudo pkg install rcm

Gentoo:

emerge app-admin/rcm

Korora:

64-bit Korora 23:

sudo dnf copr enable seeitcoming/rcm fedora-23-x86_64
sudo dnf install rcm

Korora is similar to Fedora but with an additional version and architecture specification. Replace fedora-23-x86_64 as appropriate.

macOS with Homebrew:

brew tap thoughtbot/formulae
brew install rcm

macOS with MacPorts:

port install rcm

OpenBSD:

doas pkg_add rcm

openSUSE/RHEL/CentOS: instructions

Ubuntu:

sudo add-apt-repository ppa:martin-frost/thoughtbot-rcm
sudo apt-get update
sudo apt-get install rcm

Void Linux:

sudo xbps-install -S rcm

Elsewhere:

This uses the standard GNU autotools, so it's the normal dance:

curl -LO https://thoughtbot.github.io/rcm/dist/rcm-1.3.3.tar.gz &&

sha=$(sha256 rcm-1.3.3.tar.gz | cut -f1 -d' ') &&
[ "$sha" = "935524456f2291afa36ef815e68f1ab4a37a4ed6f0f144b7de7fb270733e13af" ] &&

tar -xvf rcm-1.3.3.tar.gz &&
cd rcm-1.3.3 &&

./configure &&
make &&
sudo make install

For more, see INSTALL.

Programs

  • rcup(1) is the main program. It is used to install and update dotfiles, with support for tags, host-specific files, and multiple source directories.
  • rcdn(1) is the opposite of rcup(1).
  • mkrc(1) is for introducing a dotfile into your dotfiles directory, with support for tags and multiple source directories.
  • lsrc(1) shows you all your dotfiles and where they would be symlinked to. It is used by rcup(1) but is provided for your own use, too.

Support

Pull requests welcome; see CONTRIBUTING.md.

License

Copyright 2013 Mike Burns. BSD license. Copyright 2014-2015 thoughtbot. BSD license.

About thoughtbot

thoughtbot

RCM is maintained and funded by thoughtbot, inc. The names and logos for thoughtbot are trademarks of thoughtbot, inc.

We adore open source software. See our other projects. We are available for hire.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.