~/.dotfiles

My dotfiles collection for configuring frequently used programs. Managed via Nix and Home Manager

Usage

1. Install Nix

2. Activate a configuration interactively by running the following:

   nix run github:jtrrll/dotfiles home

Outputs

apps

Show 4

• default - Activates a home or NixOS configuration

• github-tf - Manages GitHub repository with OpenTofu

• update-demo - Updates the demo gif

• write-files - Write all configured files to their paths

checks

Show 63

• files:.github/CODEOWNERS

• files:.github/CODE_OF_CONDUCT.md

• files:.github/CONTRIBUTING.md

• files:.github/ISSUE_TEMPLATE/bug_report.yaml

• files:.github/ISSUE_TEMPLATE/config.yaml

• files:.github/ISSUE_TEMPLATE/documentation_issue.yaml

• files:.github/ISSUE_TEMPLATE/feature_request.yaml

• files:.github/PULL_REQUEST_TEMPLATE.md

• files:.github/dependabot.yaml

• files:.github/workflows/ci.yaml

• files:LICENSE

• files:README.md

• homeConfigurations:jtrrll/build

• nixosConfigurations:ares/build

• nixosConfigurations:ares/tests/romm/http

• nixosConfigurations:ares/tests/romm/postgresql

• nixosConfigurations:athena/build

• packages:activate/build

• packages:activate/metadata

• packages:bonsai/build

• packages:bonsai/metadata

• packages:crt-shader/build

• packages:crt-shader/metadata

• packages:ds-shader/build

• packages:ds-shader/metadata

• packages:edit/build

• packages:edit/metadata

• packages:gba-shader/build

• packages:gba-shader/metadata

• packages:gbc-shader/build

• packages:gbc-shader/metadata

• packages:git-clone-with-worktrees/build

• packages:git-clone-with-worktrees/metadata

• packages:git-ezswitch/build

• packages:git-ezswitch/metadata

• packages:git-open/build

• packages:git-open/metadata

• packages:git-trim/build

• packages:git-trim/metadata

• packages:keep-awake/build

• packages:keep-awake/metadata

• packages:matrix/build

• packages:matrix/metadata

• packages:neovim/build

• packages:neovim/metadata

• packages:neovim/tests/nixvim-check

• packages:neovim/tests/version

• packages:psp-shader/build

• packages:psp-shader/metadata

• packages:romm-image/build

• packages:romm-image/metadata

• packages:service-status/build

• packages:service-status/metadata

• packages:service-status/tests/journal-endpoint

• packages:service-status/tests/ports-endpoint

• packages:service-status/tests/status-endpoint

• packages:service-status/tests/version

• packages:splash/build

• packages:splash/metadata

• packages:zellij-agent-handler/build

• packages:zellij-agent-handler/metadata

• packages:zellij-agent-handler/tests/is-valid-wasm

• treefmt

devShells

Show 1

• default

flakeModules

Show 7

• default

• flakeMetadata

• homeConfigurationBuildChecks

• nixosConfigurationBuildChecks

• packageBuildChecks

• packageMetadataChecks

• packagePassthruTestsChecks

formatter

homeConfigurations

Show 1

• jtrrll - Jackson Terrill's home configuration

homeModules

Show 8

• bonsai

  • programs.bonsai.enable - Whether to enable a bonsai tree screensaver. (default: false)

• code-storage

  • services.codeStorage.enable - Whether to enable self-maintaining directories for source code and worktrees. (default: false)
  • services.codeStorage.frequency - The interval at which code storage maintenance runs. (default: "daily")

• edit

  • programs.edit.enable - Whether to enable edit. (default: false)
  • programs.edit.package - The edit package to use (default: <derivation edit>)

• matrix

  • programs.matrix.enable - Whether to enable a matrix rain screensaver. (default: false)

• meta

  • meta.description - A short description of this configuration. (default: "")

• music-library

  • services.musicLibrary.enable - Whether to enable a curated music library. (default: false)

• service-status

  • services.serviceStatus.enable - Whether to enable HTTP server that reports managed background service status. (default: false)
  • services.serviceStatus.port - Port to listen on. (default: 5679)

• snekcheck

  • programs.snekcheck.enable - Whether to enable snekcheck. (default: false)
  • programs.snekcheck.package - The snekcheck package to use (default: <derivation snekcheck-0.1.0>)

nixosConfigurations

Show 2

• ares - jtrrll's gaming/workstation desktop

• athena - jtrrll's personal laptop

nixosModules

Show 4

• meta

  • meta.description - A short description of this configuration. (default: "")

• romm

  • services.romm.baseUrl - Public URL of this RomM instance (ROMM_BASE_URL). (default: "http://0.0.0.0")
  • services.romm.dataDir - Base directory for RomM persistent data (resources, assets, config, redis). (default: "/var/lib/romm")
  • services.romm.database.driver - Database driver RomM connects with (ROMM_DB_DRIVER). (default: "mariadb")
  • services.romm.database.host - Host name of the database RomM connects to (DB_HOST).
  • services.romm.database.name - Database name RomM connects to (DB_NAME). (default: "romm")
  • services.romm.database.port - Port of the database RomM connects to (DB_PORT). (default: if driver == "postgresql" then 5432 else 3306)
  • services.romm.database.user - Database user RomM connects as (DB_USER). (default: "romm")
  • services.romm.enable - Whether to enable RomM, a self-hosted ROM manager and player. (default: false)
  • services.romm.environmentFiles - Environment files for the RomM application container. Must define (default: [ ])
  • services.romm.extraOptions - Extra command-line options passed to the RomM container runtime. (default: [ ])
  • services.romm.image - RomM container image derivation. (default: pkgs.romm-image)
  • services.romm.libraryDir - Directory containing ROMs and BIOS files. (default: "/var/lib/romm/library")
  • services.romm.logLevel - Application log level (LOGLEVEL). (default: "INFO")
  • services.romm.metadataProviders.flashpoint.enable - Whether to enable the Flashpoint metadata provider (FLASHPOINT_API_ENABLED). (default: false)
  • services.romm.metadataProviders.hasheous.enable - Whether to enable the Hasheous metadata provider (HASHEOUS_API_ENABLED). (default: false)
  • services.romm.metadataProviders.hltb.enable - Whether to enable the HowLongToBeat metadata provider (HLTB_API_ENABLED). (default: false)
  • services.romm.metadataProviders.launchbox.enable - Whether to enable the LaunchBox metadata provider (LAUNCHBOX_API_ENABLED). (default: false)
  • services.romm.metadataProviders.playmatch.enable - Whether to enable the PlayMatch metadata provider (PLAYMATCH_API_ENABLED). (default: false)
  • services.romm.metadataProviders.retroachievements.cacheRefreshDays - RetroAchievements metadata cache refresh interval in days (default: 30)
  • services.romm.metadataProviders.tgdb.enable - Whether to enable the TheGamesDB metadata provider (TGDB_API_ENABLED). (default: false)
  • services.romm.openFirewall - Whether to open the firewall for RomM's port. (default: false)
  • services.romm.port - Host port to expose the RomM web UI on. (default: 8080)
  • services.romm.settings - Environment variables for the RomM application container, merged (default: { })

• tests

  • tests - Tests associated with this host. Each value is a derivation that succeeds if the test passes. (default: { })

• users

  • dotfiles.users.enable - Whether to enable user configurations. (default: false)

packages

Show 19

• activate - Activates a home or NixOS configuration

• bonsai - A botanical terminal screensaver

• crt-shader - A CRT shader that blends pixels

• ds-shader - A DS shader that replicates original hardware

• edit - Launches a text editor

• gba-shader - A GBA shader that replicates original hardware

• gbc-shader - A GB and GBC shader that replicates original hardware

• git-clone-with-worktrees - Clones a bare git repo and creates worktrees for each given suffix

• git-ezswitch - Interactively switches git branches

• git-open - Opens the upstream git repository in a browser

• git-trim - Deletes all working git branches and updates main branch

• keep-awake - Prevents system sleep while a command runs

• matrix - A cyberpunk terminal screensaver

• neovim - Personalized Neovim distribution built with Nixvim

• psp-shader - A PSP shader that replicates original hardware

• romm-image - Container image for RomM, a self-hosted ROM manager and player

• service-status - Serves managed background service status over HTTP

• splash - Prints a splash screen

• zellij-agent-handler - Zellij plugin: agent status bar with click-to-navigate