https://github.com/kutu-dev/nubosa
Ergonomic, pragmatical dotfiles and scripts for personal usage.
https://github.com/kutu-dev/nubosa
home-manager home-manager-config macos nix nix-darwin nixos nvim nvim-configs theme theme-switcher theming wallpaper-changer
Last synced: 9 months ago
JSON representation
Ergonomic, pragmatical dotfiles and scripts for personal usage.
- Host: GitHub
- URL: https://github.com/kutu-dev/nubosa
- Owner: kutu-dev
- License: apache-2.0
- Created: 2024-06-07T20:07:00.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-11-03T14:33:14.000Z (over 1 year ago)
- Last Synced: 2025-01-18T14:53:19.427Z (over 1 year ago)
- Topics: home-manager, home-manager-config, macos, nix, nix-darwin, nixos, nvim, nvim-configs, theme, theme-switcher, theming, wallpaper-changer
- Language: Nix
- Homepage:
- Size: 5.28 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
Nubosa
Ergonomic, pragmatical dotfiles and scripts for personal usage powered by [Nix](https://nixos.org/) available on both NixOS and macOS. With an integrated CLI for theme and wallpaper management.
## Usage
### Prerequisites
- Have the [`nix`](https://nixos.org/download/) package manager installed (builtin with NixOS).
### Steps
First make available the [`just`](https://just.systems/man/en/) and [`git`](https://git-scm.com/) for the current terminal session
```sh
nix-shell -p just -p git
```
It is expected the dotfiles to be located at `$HOME/documents/dev/nubosa`, so set it up there:
```sh
mkdir -p $HOME/documents/dev/nubosa
cd $HOME/documents/dev/nubosa
git clone git@github.com:kutu-dev/nubosa.git
```
Then bootstrap your nix config to allow the usage of `flake`s and the new `nix` command:
```sh
just setup
```
Finally you just need to chose a host and apply it!
There are two different available hosts `valhalla`, a desktop PC with NixOS, and `nirvana`, a MacBook Air M2 with [nix-darwin](https://daiderd.com/nix-darwin/), select the one that matches your needs and follow this steps:
#### For `valhalla` (NixOS only)
First set your own `hardware-configuration.nix`:
```sh
nixos-generate-config
cp /etc/nixos/hardware-configuration.nix modules/nixos/
```
And apply the config:
```sh
sudo hostnamectl set-hostname valhalla
just switch
```
#### For `nirvana` (macOS only)
Just apply the config and let it run:
```sh
sudo scutil --set HostName nirvana
just switch
```
### The `cumulus` CLI
Nubosa bundles a Python package destinated for theme and wallpaper management at the [`cumulus`](./cumulus) directory of the repository. It reads themes defined at [`dotfiles/cumulus`](./dotfiles/cumulus) and applies them all over the system, you can:
List all the defined themes:
```sh
cumulus theme list
```
Apply a theme:
```sh
cumulus theme apply oxocarbon
```
Randomly set a wallpaper that matches the aesthetics of the theme:
```sh
cumulus wallpaper set
```
This wallpaper is extracted from a pool located at: `$HOME/pictures/wallpapers/`.
### Personal notes
Imperative configurations that are not generic and may (and probably) need manual adjustment:
#### Steam (`valhalla` host only)
1. Activate compatibility for all titles.
2. Set `GE-Proton` as the default Proton runtime.
3. Add `/home/kutu/mounts/bravo` as default install point.
#### Syncthing
1. Enter the UI at: https://localhost:8384
2. Disallow anonymous Usage Reporting? No.
3. No set any password for the web GUI.
3. Remove default folder with `rm -r $HOME/Sync`.
4. Add the other devices.
5. Set up the following shared directories:
- `$HOME/documents/dev`
- `$HOME/pictures/wallpapers`
- `$HOME/documents/aorta`
## Hacking
If you are interested on modifing Nubosa to tailor it to your needs it is recommended to first read the [`HACKING.md`](./HACKING.md) file.
## Acknowledgements
- Created with :heart: by [Jorge "Kutu" Dobón Blanco](https://dobon.dev).
- [Cloud Texture 10](https://www.flickr.com/photos/31288116@N02/3909270081) image by [SixRevisions](https://www.flickr.com/photos/31288116@N02/) licensed under [CC BY 2.0](https://creativecommons.org/licenses/by/2.0/).