Dotfiles Manager

Centralized management of your dotfiles, backups, symlinks, and scripts on Linux.

This project allows you to easily manage your configuration files (dotfiles) by linking or copying them from a central repository to your system. It also supports running utility scripts to automate common tasks (backup, install, updates, etc.).

📦 Project Structure

🛠 Installation

1. Install package:

   pip install manager-dotfiles
   

2. Create the ~/.dotfile file:

   echo "/path/to/your/dotfiles" > ~/.dotfile
   

   Example:

   echo "~/.config/dotfiles" > ~/.dotfile
   

🚀 Usage

Main Commands

cli can be invoked by dotfiles-manager or dm, with previous command:

dm init
dm init-link
dm init-copy
dm link ~/.bashrc
dm unkink ~/.bashrc
dm copy /etc/host
dm run backup.sh

Global Options

Examples

1. Initialize all dotfiles:

   dotfiles-manager init
   

2. Symlink a specific file:

   dotfiles-manager link files/home.link/.bashrc
   

3. Copy a system file (requires sudo):

   dotfiles-anager --sudo copy /etc/hosts
   

4. Run a utility script:

   dotfiles-manager run backup
   

📂 Structure

~/.dotfile → /path/to/dotfiles
/path/to/dotfiles/
├── files/
│   ├── home.link/
│   │   ├── .bashrc
│   │   ├── .vimrc
│   │   └── ...
│   ├── home.copy/
│   │   ├── .config/...
│   │   └── ...
│   ├── system.link/
│   │   └── etc/...
│   └── system.copy/
│       └── etc/...
└── scripts/
    ├── backup.sh
    ├── install-docker.sh
    ├── pin.py
    └── ...

📝 Notes

• system.link and system.copy commands can be require sudo.
• The ~/.dotfile file must contain the absolute path to your repository.
• Scripts in scripts/ must be executable (chmod +x) with shebang (#!/usr/bin/env bash or #!/usr/bin/env python3).

🤝 Contributing

Contributions are welcome! Open an issue or a pull request.

📄 License

MIT