Linux: Create Nix flake

[tadg-paul]

Overview

Create a Nix flake for NixOS and Nix package manager users.

Parent issue: #2

Requirements

• Create flake.nix at project root
• Define package with all dependencies
• Support both CLI and GUI
• Include devShell for development
• Test on NixOS and nix-darwin

Flake Template

{
  description = "Convert documents to audiobooks using Piper TTS";

  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    flake-utils.url = "github:numtide/flake-utils";
  };

  outputs = { self, nixpkgs, flake-utils }:
    flake-utils.lib.eachDefaultSystem (system:
      let
        pkgs = nixpkgs.legacyPackages.${system};
        python = pkgs.python312;
      in {
        packages.default = python.pkgs.buildPythonApplication {
          pname = "make-audiobook";
          version = "2.0.0";
          src = ./.;
          
          format = "other";
          
          propagatedBuildInputs = with pkgs; [
            ffmpeg
            pandoc
            fzf
            fd
            piper-tts
          ] ++ (with python.pkgs; [
            pyside6
            requests
          ]);
          
          installPhase = ''
            mkdir -p $out/bin
            cp make-audiobook $out/bin/
            cp make-audiobook-gui $out/bin/
            cp -r gui $out/lib/python${python.version}/site-packages/
          '';
        };
        
        devShells.default = pkgs.mkShell {
          packages = with pkgs; [
            python
            python.pkgs.pyside6
            python.pkgs.pytest
            python.pkgs.pytest-qt
            ffmpeg
            pandoc
          ];
        };
      });
}

Usage

# Run without installing
nix run github:tigger04/make-audiobook

# Install to profile
nix profile install github:tigger04/make-audiobook

# Development shell
nix develop github:tigger04/make-audiobook

Acceptance Criteria

• nix run launches GUI
• nix build produces working package
• Works on NixOS 24.05+
• Works with nix-darwin on macOS
• All dependencies resolved by Nix

[tadg-paul]

Implementation Complete

What was done

Created flake.nix and flake.lock at project root providing:

• default package — GUI + CLI, all dependencies resolved by Nix
• cli package — CLI-only (no PySide6/Qt)
• devShells.default — Development environment with all deps, pytest, pytest-qt

Shell helpers submodule fetched as a separate flake input (shell-helpers) to avoid requiring ?submodules=1 from users.

Tested on NixOS (samizdat)

Test	Result
nix build (default)	Builds make-audiobook-2.0.2
nix build #cli	Builds make-audiobook-cli-2.0.2
make-audiobook --help	Works, all deps on PATH
GUI module imports (PySide6, models, views)	All import successfully
CLI-only has no GUI binary	Confirmed
nix develop	Shell has piper, ffmpeg, pandoc, python3, PySide6 6.10.0, pytest 8.4.2

GUI cannot be fully tested on headless server (Qt needs display), but all Python imports verified with QT_QPA_PLATFORM=offscreen.

Not yet tested

• nix-darwin on macOS (no nix installed on dev machine)

Commits

• 327bf6f — flake.nix
• 511d2b7 — flake.lock
• 4617f8b — docs update

Usage

# Run GUI
nix run github:tigger04/make-audiobook

# Run CLI only
nix run github:tigger04/make-audiobook#cli

# Install
nix profile install github:tigger04/make-audiobook

# Dev shell
nix develop github:tigger04/make-audiobook