https://github.com/xorcare/dotfiles
This repository stores the configuration files of system and programs, as well as a script to automate various tasks.
https://github.com/xorcare/dotfiles
dotfiles dotfiles-automation dotfiles-install dotfiles-installer dotfiles-linux dotfiles-macos dotfiles-management dotfiles-setup
Last synced: 5 months ago
JSON representation
This repository stores the configuration files of system and programs, as well as a script to automate various tasks.
- Host: GitHub
- URL: https://github.com/xorcare/dotfiles
- Owner: xorcare
- License: bsd-3-clause
- Created: 2017-02-27T19:30:33.000Z (over 9 years ago)
- Default Branch: main
- Last Pushed: 2025-05-02T17:52:40.000Z (about 1 year ago)
- Last Synced: 2025-05-02T18:43:54.591Z (about 1 year ago)
- Topics: dotfiles, dotfiles-automation, dotfiles-install, dotfiles-installer, dotfiles-linux, dotfiles-macos, dotfiles-management, dotfiles-setup
- Language: Shell
- Homepage:
- Size: 163 KB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Dotfiles
## Setting preferences
**For macOS only.** If you haven't installed Xcode or command line tools yet, use
`xcode-select --install` to download and install them, or check the Apple developer site. And only
after installing the developer tools, it will execute the following the command in the directory
with the **dotfiles** project:
```bash
make install
```
**Note:** On macOS Catalina, the default interactive shell is now zsh. To update your account to use
bash, please run `chsh -s /bin/bash`. For more For details, please
visit https://support.apple.com/kb/HT208050
### Optional, install oh-my-zsh
Use the command from the official site [oh-my-zsh](https://ohmyz.sh/#install)
```bash
/bin/bash -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
```
## Installing software
### Install macOS dependencies
Homebrew must be installed to correctly install the software for macOS use the command from the
official site [Homebrew](https://brew.sh)
```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
### Software installation
You can install the software using the scripts described in the **scripts** directory, for
software installation on macOS using the brew tool, for Linux standard package managers with the
addition of third-party repositories. To start the installation, execute the following the command
in the directory with the **dotfiles** project:
```bash
make install-software
```
Running this command can lead to the execution of irreversible actions on your system, since fully
clean the system from the installed software with the ability to reliably determine what exactly was
installed by the command and which intermediate files might not have been created seems possible.
## Undo changes
Automated rollback of changes is not provided, you can try to manually analyze changes made to the
system or will be restored from a backup copy if you have one.