{"id":20812336,"url":"https://github.com/kutu-dev/nubosa","last_synced_at":"2025-09-04T10:34:19.076Z","repository":{"id":243312546,"uuid":"812031201","full_name":"kutu-dev/nubosa","owner":"kutu-dev","description":"Ergonomic, pragmatical dotfiles and scripts for personal usage.","archived":false,"fork":false,"pushed_at":"2024-11-03T14:33:14.000Z","size":5538,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-18T14:53:19.427Z","etag":null,"topics":["home-manager","home-manager-config","macos","nix","nix-darwin","nixos","nvim","nvim-configs","theme","theme-switcher","theming","wallpaper-changer"],"latest_commit_sha":null,"homepage":"","language":"Nix","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kutu-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-07T20:07:00.000Z","updated_at":"2024-11-03T14:33:18.000Z","dependencies_parsed_at":"2024-07-11T12:11:59.933Z","dependency_job_id":"b862ae30-8931-45b4-b492-d4543e2555fb","html_url":"https://github.com/kutu-dev/nubosa","commit_stats":null,"previous_names":["kutu-dev/nubosa"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kutu-dev%2Fnubosa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kutu-dev%2Fnubosa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kutu-dev%2Fnubosa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kutu-dev%2Fnubosa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kutu-dev","download_url":"https://codeload.github.com/kutu-dev/nubosa/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243158972,"owners_count":20245669,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["home-manager","home-manager-config","macos","nix","nix-darwin","nixos","nvim","nvim-configs","theme","theme-switcher","theming","wallpaper-changer"],"created_at":"2024-11-17T20:53:03.646Z","updated_at":"2025-03-12T04:45:24.643Z","avatar_url":"https://github.com/kutu-dev.png","language":"Nix","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"./static/cloud-texture-10.jpg\" alt=\"Photo of a cloudy sky\" width=\"275\"\u003e\n\u003ch1\u003eNubosa\u003c/h1\u003e\n    \n![nixpkgs version logo](https://img.shields.io/badge/nixpkgs-unstable-informational.svg?style=flat\u0026logo=nixos\u0026logoColor=CAD3F5\u0026colorA=24273A\u0026colorB=8aadf4)\n![nixOS logo](https://img.shields.io/badge/NixOS-24273A.svg?style=flat\u0026logo=nixos\u0026logoColor=CAD3F5)\n![macOS logo](https://img.shields.io/badge/macOS-000000?style=flat\u0026logo=apple\u0026labelColor=000000)\n![Python version logo](https://img.shields.io/badge/python%203.12.3%2B-3776AB?style=flat\u0026logo=python\u0026logoColor=FFFFFF)\n\nErgonomic, 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.\n\u003c/div\u003e\n\n## Usage\n### Prerequisites\n- Have the [`nix`](https://nixos.org/download/) package manager installed (builtin with NixOS).\n\n### Steps\nFirst make available the [`just`](https://just.systems/man/en/) and [`git`](https://git-scm.com/) for the current terminal session\n```sh\nnix-shell -p just -p git\n```\n\nIt is expected the dotfiles to be located at `$HOME/documents/dev/nubosa`, so set it up there:\n```sh\nmkdir -p $HOME/documents/dev/nubosa\ncd $HOME/documents/dev/nubosa\ngit clone git@github.com:kutu-dev/nubosa.git\n```\n\nThen bootstrap your nix config to allow the usage of `flake`s and the new `nix` command:\n```sh\njust setup\n```\nFinally you just need to chose a host and apply it!  \nThere 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:\n\n#### For `valhalla` (NixOS only)\nFirst set your own `hardware-configuration.nix`:\n```sh\nnixos-generate-config\ncp /etc/nixos/hardware-configuration.nix modules/nixos/\n```\n\nAnd apply the config:\n```sh\nsudo hostnamectl set-hostname valhalla\njust switch\n```\n\n#### For `nirvana` (macOS only)\nJust apply the config and let it run:\n```sh\nsudo scutil --set HostName nirvana\njust switch\n```\n\n### The `cumulus` CLI\nNubosa 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:\n\nList all the defined themes:\n```sh\ncumulus theme list\n```\n\nApply a theme:\n```sh\ncumulus theme apply oxocarbon\n```\n\nRandomly set a wallpaper that matches the aesthetics of the theme:\n```sh\ncumulus wallpaper set\n```\n\nThis wallpaper is extracted from a pool located at: `$HOME/pictures/wallpapers/\u003ctheme-name\u003e`.\n\n### Personal notes\nImperative configurations that are not generic and may (and probably) need manual adjustment:\n\n#### Steam (`valhalla` host only)\n1. Activate compatibility for all titles.\n2. Set `GE-Proton` as the default Proton runtime.\n3. Add `/home/kutu/mounts/bravo` as default install point.\n\n#### Syncthing\n1. Enter the UI at: https://localhost:8384\n2. Disallow anonymous Usage Reporting? No.\n3. No set any password for the web GUI.\n3. Remove default folder with `rm -r $HOME/Sync`.\n4. Add the other devices.\n5. Set up the following shared directories:\n    - `$HOME/documents/dev`\n    - `$HOME/pictures/wallpapers`\n    - `$HOME/documents/aorta`\n\n## Hacking\nIf you are interested on modifing Nubosa to tailor it to your needs it is recommended to first read the [`HACKING.md`](./HACKING.md) file.\n\n## Acknowledgements\n- Created with :heart: by [Jorge \"Kutu\" Dobón Blanco](https://dobon.dev).\n- [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/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkutu-dev%2Fnubosa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkutu-dev%2Fnubosa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkutu-dev%2Fnubosa/lists"}