{"id":14035438,"url":"https://github.com/namishh/crystal","last_synced_at":"2025-10-01T06:32:05.729Z","repository":{"id":50554818,"uuid":"519420513","full_name":"namishh/crystal","owner":"namishh","description":"nix dotfiles for chilly people","archived":false,"fork":false,"pushed_at":"2024-07-22T23:18:03.000Z","size":1568042,"stargazers_count":606,"open_issues_count":5,"forks_count":20,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-08-03T19:33:38.224Z","etag":null,"topics":["awesome","awesomewm","dotfiles","linux","nix","nixos-configuration","rice"],"latest_commit_sha":null,"homepage":"","language":"Nix","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/namishh.png","metadata":{"files":{"readme":".github/README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2022-07-30T04:45:57.000Z","updated_at":"2024-08-03T19:33:45.356Z","dependencies_parsed_at":"2023-02-18T10:15:41.634Z","dependency_job_id":"611d28ba-7721-4cfe-aa8a-c76fed7eb5c8","html_url":"https://github.com/namishh/crystal","commit_stats":null,"previous_names":["namishh/crystal"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/namishh%2Fcrystal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/namishh%2Fcrystal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/namishh%2Fcrystal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/namishh%2Fcrystal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/namishh","download_url":"https://codeload.github.com/namishh/crystal/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234677950,"owners_count":18870355,"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":["awesome","awesomewm","dotfiles","linux","nix","nixos-configuration","rice"],"created_at":"2024-08-12T03:01:31.049Z","updated_at":"2025-10-01T06:32:03.421Z","avatar_url":"https://github.com/namishh.png","language":"Nix","funding_links":[],"categories":["awesome"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"screenshots/crystal.png\" alt=\"showcase3\"\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n![GitHub top language](https://img.shields.io/github/languages/top/chadcat7/fuyu?color=6d92bf\u0026style=for-the-badge\u0026labelColor=1B1919)\n![Cool](https://img.shields.io/badge/WM-Awesome-da696f?style=for-the-badge\u0026labelColor=1B1919)\n![Bloat](https://img.shields.io/badge/Bloated-Yes-c585cf?style=for-the-badge\u0026labelColor=1B1919)\n![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/chadcat7/fuyu?color=e1b56a\u0026style=for-the-badge\u0026labelColor=1B1919)\n![GitHub Repo stars](https://img.shields.io/github/stars/chadcat7/fuyu?color=74be88\u0026style=for-the-badge\u0026labelColor=1B1919)\n\u003c/div\u003e\n\n\n\u003e [!Important]\n\u003e\n\u003e New Changes Soon.\n\n## Features of config\n+ **OS**     -  nixos // arch\n+ **WM**     -  awesome - [blizzard](https://github.com/chadcat7/crystal/tree/blizzard) // [aura](https://github.com/chadcat7/fuyu/tree/aura) // hyprland\n+ **Shell**  -  zsh\n+ **Term**   -  wezterm\n+ **Music**  -  ncmpcpp\n+ **Comp**   -  picom - [fdev31 fork](https://github.com/fdev31/picom/tree/animation-pr)\n+ **Editor** -  nvim v0.9 - [my config](https://github.com/chadcat7/lodo)\n\n## Nix \n\n\u003e [!note]\n\u003e\n\u003e I have written a [blog post](https://namishh.me/blog/nixos) on setting up Nixos. And for those who are interested in learning about ricing itself, I have a seperate blog post about is. Checkout the [Ricing Guide](https://namishh.me/blog/ricing/) (btw it also got featured in the official unixporn wiki).\n\n\nThe \"Textbook\" Definition - A Linux distribution based on the Nix package manager and guided by Nix's core principles.\n\nNixOS is a unique distro. Unlike other distros where you store your configurations in `~/.config/` and binaries in `~/.local/bin` , nix takes a different approach. Instead you can [declaratively](https://zero-to-nix.com/concepts/declarative) define your configuration in `.nix` files. These nix files can be used to install and configure programs, services, setting up things like xresources, etc. This approach provides a modular system that enables users to share, reuse, and modify their configurations easily. \u003cbr\u003e \u003cbr\u003e\n\n**Sounds Confusing right?** Dont worry here let me simplify some things for you.\n```\nderivs/\n    phocus.nix\n    ...\nhome/\n    namish/\n        home.nix\n        ...\n    shared/\n        ...\nhosts/\n    frostbyte/\n        hardware-configuration.nix\n        configuration.nix\n    shared/\n        default.nix\noverlays/\n      default.nix\npatches/\npkgs/\nflake.nix\nnixpkgs.nix\nshell.nix\n```\nThis is the general structure of my dotfiles. I am using a beta feature called `flakes` and thats the reason why you will sea a file called `flake.nix`. Let us start with that!\n\n1. flake.nix\n  + This main file, it consists of two main parts, `inputs` and `outputs`. Inputs are Nix dependencies that a flake needs to be built. Each input in the set can be pulled from various sources, such as github, generic git repositories, and even from your local filesystem. All of these inputs are saved in the `flake.lock` file. Flake outputs are what a flake produces as part of its build. In this case it produces a NixOS configuration.\n\n2. hosts/ folder\n  + This folder contains configurations for our machines\n  + The `frostbyte` folder is the main one where my configuration is stored, the `shared` one contains configurations that would be same for all machines that I am _gonna_ own.\n\n3. home/ folder\n  + this folder contains the home-manager configuration for different users. Like before `shared` contains configurations that would be same for all users.\n  + `shared` contains things like bin files, colors, gtkThemes\n\n4. derivations\n  + \"techincal\" definition - 'A derivation is an instruction that Nix uses to realise a Nix package'\n  + In simple words, deriavations are used to install stuff that aren't available in the nixpkg repositories. (atleast that is what i use them for). Make your own derivation in `derivs/program.nix` and call it in `overlays/default.nix`\n\n5. overlays\n  + they are just modifications you do on top of the original program, for example patching st, or using a fork of st from github.\n\n\u003e [!Warning]\n\u003e\n\u003e by no means are the above things I say 100% the truth. I maybe wrong somewhere, if you spot a mistake kindly prompt me to correct it\n\n### WOW! NixOS looks so god damn cool! I am just gonna jump right into it\n**NO**. NixOS is hard.Don't be impatient and jump with the hype train. Nix files are complicated to make and can cause high brain damage. I recommend you to start with the [nix package manager](https://nixos.org/download.html#nix-install-linux) or using NixOS in a virtual machine instead of ripping apart your hard disk.\n\n#### I really wanna try out NixOS!\nIf you that determined, here are some resources to start out\n  + [zero-to-nix](https://zero-to-nix.com)\n  + [pills](https://nixos.org/guides/nix-pills/)\n  + [nix-starter-config](https://github.com/Misterio77/nix-starter-config)\n\n\n## Rices\n\n| \u003cb\u003eAura\u003c/b\u003e                                                                                      |\n| ------------------------------------------------------------------------------------------------------------------ |\n| \u003ca href=\"https://github.com/chadcat7/crystal/tree/aura\"\u003e\u003cimg src=\"screenshots/aura.png\"  alt=\"aura\"\u003e\u003c/a\u003e                    |\n\n| \u003cb\u003eFreosan\u003c/b\u003e                                                                                     |\n| ------------------------------------------------------------------------------------------------------------------ |\n| \u003ca href=\"https://github.com/chadcat7/crystal/tree/freosan\"\u003e\u003cimg src=\"screenshots/freosan.png\"  alt=\"freosan\"\u003e\u003c/a\u003e                    |\n\n| \u003cb\u003eBlizzard (Do not use)\u003c/b\u003e                                                                                     |\n| ------------------------------------------------------------------------------------------------------------------ |\n| \u003ca href=\"https://github.com/chadcat7/crystal/tree/blizzard\"\u003e\u003cimg src=\"screenshots/blizzard.png\"  alt=\"blizz\"\u003e\u003c/a\u003e                    |\n\n| \u003cb\u003eGlacier\u003c/b\u003e                                                                                      |\n| ------------------------------------------------------------------------------------------------------------------ |\n| \u003ca href=\"https://github.com/chadcat7/crystal/tree/glacier\"\u003e\u003cimg src=\"screenshots/glacier.png\"  alt=\"glacier\"\u003e\u003c/a\u003e                    |\n\n| \u003cb\u003eKawai\u003c/b\u003e                                                                                      |\n| ------------------------------------------------------------------------------------------------------------------ |\n| \u003ca href=\"https://github.com/chadcat7/crystal/tree/kawai\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/chadcat7/crystal/kawai/.github/1.png\"  alt=\"kawai\"\u003e\u003c/a\u003e                    |\n\n| \u003cb\u003eVercel\u003c/b\u003e                                                                                      |\n| ------------------------------------------------------------------------------------------------------------------ |\n| \u003ca href=\"https://github.com/chadcat7/crystal/tree/vercel\"\u003e\u003cimg src=\"https://github.com/user-attachments/assets/f709ef1c-30ff-4973-942c-ad71cdc2acd0\"  alt=\"vercel\"\u003e\u003c/a\u003e                    |\n\n\u003e [!NOTE]\n\u003e\n\u003e For screenshots, go to each rice's respective branch. Also I am aware of the fact that none of the rices are themed like they are named. They are all named like that because the words are related to winter / snow which means nix.\n\u003e To get Basic dotfiles, go to the [simplefiles branch](https://github.com/chadcat7/crystal/tree/simplefiles).\n\n### Focus Flake. \nThis is a very minimal dwm rice I made to quit ricing. This build mainly contains useful patches like xrdb, swallow, awesomebar,scratchpads, etc. The way of patching is so shit with nixos because I had to manually modify each patch to not conflict with the other. \n\n| \u003cb\u003efocusflake\u003c/b\u003e                                                                                      |\n| ------------------------------------------------------------------------------------------------------------------ |\n| \u003ca href=\"#\"\u003e\u003cimg src=\"screenshots/dwm1.png\"  alt=\"ff1\"\u003e\u003c/a\u003e                    |\n| \u003ca href=\"#\"\u003e\u003cimg src=\"screenshots/dwm2.png\"  alt=\"ff2\"\u003e\u003c/a\u003e                    |\n\n\n## Theming\n\n| \u003cb\u003eFirefox\u003c/b\u003e                                                                                      |\n| ------------------------------------------------------------------------------------------------------------------ |\n| \u003cimg src=\"screenshots/firefox.jpg\"  alt=\"fox\"\u003e         |\n\n| \u003cb\u003eSpicetify\u003c/b\u003e                                                                                     |\n| ------------------------------------------------------------------------------------------------------------------ |\n| \u003cimg src=\"screenshots/spicetify.jpg\"  alt=\"spotify\"\u003e                  |\n\n| \u003cb\u003eVencord\u003c/b\u003e                                                                                      |\n| ------------------------------------------------------------------------------------------------------------------ |\n| \u003cimg src=\"screenshots/vencord.jpg\"  alt=\"discord\"\u003e                  |\n\n| \u003cb\u003ePhocus\u003c/b\u003e                                                                                      |\n| ------------------------------------------------------------------------------------------------------------------ |\n| \u003cimg src=\"screenshots/phocus.jpg\"  alt=\"phocus\"\u003e                  |\n\n| \u003cb\u003eNeofetch\u003c/b\u003e                                                                                      |\n| ------------------------------------------------------------------------------------------------------------------ |\n| \u003cimg src=\"screenshots/neofetch.jpg\"  alt=\"neofetch\"\u003e                  |\n\n## Credits\nThese are the chads which helped me throughout my short but crazy nix journey!\n- [gw](https://github.com/Gwynsav)\n- [javacafe](https://github.com/JavaCafe01/)\n- [f2k](https://github.com/fortuneteller2k/)\n- [apro](https://github.com/Aproxia-dev)\n- [viper](https://github.com/viperML/)\n\nAnd of course credits for the guys for their help with my awesome config!\n- [stardust](https://github.com/stardust-kyun/)\n- [gw](https://github.com/Gwynsav)\n- [kasper](https://github.com/Kasper24)\n- [manas](https://github.com/Manas140)\n- [ilovecookie](https://github.com/manilarome)\n- [crylia](https://github.com/crylia/)\n- [rxyhn](https://github.com/rxyhn)\n\nPeople from who I have ~~stolen~~ taken inspiration for my design.\n\n- [tsukki](https://github.com/tsukki9696)\n- [sammy](https://github.com/TorchedSammy)\n- [kizu](https://github.com/janleigh)\n- [gw](https://github.com/Gwynsav)\n\n**Feel free to use any code from any branch as long as you will credit me**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnamishh%2Fcrystal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnamishh%2Fcrystal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnamishh%2Fcrystal/lists"}