https://github.com/ntsd/dotfiles
My Dotfiles
https://github.com/ntsd/dotfiles
Last synced: about 1 year ago
JSON representation
My Dotfiles
- Host: GitHub
- URL: https://github.com/ntsd/dotfiles
- Owner: ntsd
- Created: 2020-10-07T15:41:42.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2025-06-12T04:59:35.000Z (about 1 year ago)
- Last Synced: 2025-06-12T05:39:35.226Z (about 1 year ago)
- Language: Shell
- Size: 92.8 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# .files
These are my dotfiles. Take anything you want, but at your own risk.
It mainly targets macOS systems, but it works on at least Ubuntu as well.
> Warning The Linux is not working in the moment, beacuse the $HOME will change to /root
## Highlights
- Minimal efforts to install everything, using a [Makefile](./Makefile)
- Mostly based around Homebrew, Cask, ASDF, NPM, latest Bash + GNU Utils
- Fast and colored prompt
- Updated macOS defaults (Dock, Systen)
- The installation and runcom setup is
[tested on real Ubuntu and macOS machines](https://github.com/ntsd/dotfiles/actions) using
[a GitHub Action](./.github/workflows/ci.yml)
- Post install `dotfiles` command line to restall, update packages, etc.
## Packages Overview
- [Homebrew](https://brew.sh) (packages: [Brewfile](./install/Brewfile))
- [Homebrew Cask](https://github.com/Homebrew/homebrew-cask) (packages: [Caskfile](./install/Caskfile))
- [asdf](https://github.com/asdf-vm/asdf) (packages: [.tool-versions](./runcom/.tool-versions))
- [Vs Code](https://github.com/microsoft/vscode) (packages: [VSCodefile](./install/VSCodefile))
- Latest Git, Bash 4, GNU coreutils, curl
## Installation
On a sparkling fresh installation of macOS:
```bash
sudo softwareupdate -i -a
xcode-select --install
```
The Xcode Command Line Tools includes `git` and `make` (not available on stock macOS). Now there are two options:
1. Install this repo with `curl` available:
```bash
bash -c "`curl -fsSL https://raw.githubusercontent.com/ntsd/dotfiles/master/remote-install.sh`"
```
This will clone or download, this repo to `~/.dotfiles` depending on the availability of `git`, `curl` or `wget`.
1. Alternatively, clone manually into the desired location:
```bash
git clone https://github.com/ntsd/dotfiles.git ~/.dotfiles
```
Use the [Makefile](./Makefile) to install everything [listed above](#package-overview), and symlink [runcom](./runcom)
and [config](./config) (using [stow](https://www.gnu.org/software/stow/)):
```bash
cd ~/.dotfiles
make
```
## The `dotfiles` command
```bash
$ dotfiles help
Usage: dotfiles
Commands:
help This help message
clean Clean up caches (brew)
dock Apply macOS Dock settings
macos Apply macOS system defaults
test Run tests
asdf Update asdf global packages
brew Update Homebrew/Cask packages
node Update Node packages
update Update packages and pkg managers (OS, brew, npm)
```
## Customize
You can put your custom settings, such as Git credentials in the `system/.custom` file which will be sourced from
`.bash_profile` automatically. This file is in `.gitignore`.
Alternatively, you can have an additional, personal dotfiles repo at `~/.extra`. The runcom `.bash_profile` sources all
`~/.extra/*.sh` files.
## Credits
This dotfile is fork from [@webpro Dotfiles](https://github.com/webpro/dotfiles).
Many thanks to the [dotfiles community](https://dotfiles.github.io).