From 6205da9bbcc87d9e30c1511bd08d22f984e9dffc Mon Sep 17 00:00:00 2001
From: Christoph Urlacher <christoph.urlacher@protonmail.com>
Date: Tue, 8 Jul 2025 23:08:33 +0200
Subject: [PATCH] Modules: Add beets module

---
 home/modules/beets/default.nix | 74 ++++++++++++++++++++++++++++++++++
 home/modules/beets/options.nix |  7 ++++
 2 files changed, 81 insertions(+)
 create mode 100644 home/modules/beets/default.nix
 create mode 100644 home/modules/beets/options.nix

diff --git a/home/modules/beets/default.nix b/home/modules/beets/default.nix
new file mode 100644
index 00000000..ce83b069
--- /dev/null
+++ b/home/modules/beets/default.nix
@@ -0,0 +1,74 @@
+{
+  config,
+  nixosConfig,
+  lib,
+  mylib,
+  pkgs,
+  ...
+}: let
+  inherit (config.modules) beets;
+in {
+  options.modules.beets = import ./options.nix {inherit lib mylib;};
+
+  config = lib.mkIf beets.enable {
+    programs.beets = {
+      enable = true;
+      mpdIntegration = {
+        host = "127.0.0.1";
+        port = config.services.mpd.network.port;
+        enableUpdate = true;
+        enableStats = true;
+      };
+
+      # https://beets.readthedocs.io/en/stable/reference/config.html
+      settings = {
+        directory = "${config.home.homeDirectory}/Music";
+        threaded = true;
+        art_filename = "cover";
+
+        ui = {
+          color = true;
+        };
+
+        import = {
+          write = true; # Write metadata to files
+          copy = false; # Copy files to the music directory when importing
+          move = true; # Move files to the music directory when importing
+          log = "${config.home.homeDirectory}/Music/.beetslog.txt";
+        };
+
+        paths = {
+          default = "$albumartist/$albumartist - $album/$track $title";
+          singleton = "0 Singles/$artist - $title"; # Single songs
+          comp = "1 Various/$album/$track $title";
+        };
+
+        plugins = [
+          "badfiles" # check audio file integrity
+          "duplicates"
+          "edit" # edit metadata in text editor
+          "fetchart" # pickup local cover art or search online
+          "fish" # beet fish generates ~/.config/fish/completions file
+          # "lyrics" # fetch song lyrics
+          "replaygain" # write replaygain tags for automatic loudness adjustments
+        ];
+
+        fetchart = {
+          auto = true;
+          sources = "filesystem coverart itunes amazon albumart"; # sources are queried in this order
+        };
+
+        # lyrics = {
+        #   auto = "no"; # we need the lyrics as .lrc files, not embedded into the metadata
+        #   synced = "yes"; # prefer synced lyrics if provided
+        # };
+
+        replaygain = {
+          auto = false; # analyze on import automatically
+          backend = "ffmpeg";
+          overwrite = true; # re-analyze files with existing replaygain tags on import
+        };
+      };
+    };
+  };
+}
diff --git a/home/modules/beets/options.nix b/home/modules/beets/options.nix
new file mode 100644
index 00000000..df0c1489
--- /dev/null
+++ b/home/modules/beets/options.nix
@@ -0,0 +1,7 @@
+{
+  lib,
+  mylib,
+  ...
+}: {
+  enable = lib.mkEnableOption "Enable the beet music library tagger";
+}