228 lines
6.6 KiB
Markdown
228 lines
6.6 KiB
Markdown
# PinePods Nix Package
|
|
|
|
A Nix/NixOS package for [PinePods](https://github.com/madeofpendletonwool/PinePods), a self-hosted podcast manager. This packages the PinePods desktop client (Tauri v2) for NixOS.
|
|
|
|
> **Note:** PinePods is a client/server application. You will need a running PinePods server instance to use this package. See the [PinePods documentation](https://github.com/madeofpendletonwool/PinePods) for server setup instructions.
|
|
|
|
---
|
|
|
|
## Requirements
|
|
|
|
- NixOS
|
|
- A running PinePods server (self-hosted)
|
|
|
|
---
|
|
|
|
## Installation
|
|
|
|
### Option 1: NixOS Module via Flake (recommended)
|
|
|
|
Add PinePods as a flake input in your system `flake.nix`:
|
|
|
|
```nix
|
|
{
|
|
inputs = {
|
|
nixpkgs.url = "github:NixOS/nixpkgs/nixos-25.11";
|
|
|
|
pinepods.url = "git+https://git.briannelson.dev/brian/PinePods-nix";
|
|
pinepods.inputs.nixpkgs.follows = "nixpkgs";
|
|
};
|
|
|
|
outputs = { self, nixpkgs, pinepods, ... }: {
|
|
nixosConfigurations.mymachine = nixpkgs.lib.nixosSystem {
|
|
system = "x86_64-linux";
|
|
modules = [
|
|
pinepods.nixosModules.pinepods
|
|
{
|
|
services.pinepods = {
|
|
enable = true;
|
|
# Your server address
|
|
server = "https://pinepods.example.com";
|
|
};
|
|
}
|
|
];
|
|
};
|
|
};
|
|
}
|
|
```
|
|
|
|
Then rebuild your system:
|
|
```bash
|
|
sudo nixos-rebuild switch
|
|
```
|
|
|
|
---
|
|
|
|
### Option 2: NixOS Module without Flakes
|
|
|
|
Clone this repository:
|
|
```bash
|
|
git clone https://git.briannelson.dev/brian/PinePods-nix.git
|
|
```
|
|
|
|
Add the module to your `/etc/nixos/configuration.nix`:
|
|
```nix
|
|
{ config, pkgs, ... }:
|
|
{
|
|
imports = [
|
|
/path/to/pinepods-nix/pinepods-module.nix
|
|
];
|
|
|
|
services.pinepods = {
|
|
enable = true;
|
|
# Your server address
|
|
server = "https://pinepods.example.com";
|
|
};
|
|
}
|
|
```
|
|
|
|
Then rebuild your system:
|
|
```bash
|
|
sudo nixos-rebuild switch
|
|
```
|
|
|
|
---
|
|
|
|
### Option 3: Install to user profile with nix-env
|
|
|
|
Clone this repository:
|
|
```bash
|
|
git clone https://git.briannelson.dev/brian/PinePods-nix.git
|
|
cd pinepods-nix
|
|
```
|
|
|
|
Install to your user profile:
|
|
```bash
|
|
nix-env -f default.nix -iA pinepods
|
|
```
|
|
|
|
This is persistent across reboots. To uninstall:
|
|
```bash
|
|
nix-env -e pinepods
|
|
```
|
|
|
|
> **Note:** With this option the `server` URL cannot be pre-configured. You will need to enter it manually in the app on first launch.
|
|
|
|
---
|
|
|
|
## Configuration
|
|
|
|
### Module Options
|
|
|
|
| Option | Type | Default | Description |
|
|
|--------|------|---------|-------------|
|
|
| `services.pinepods.enable` | bool | `false` | Enable the PinePods desktop client |
|
|
| `services.pinepods.server` | string | `""` | URL of your PinePods server (e.g. `https://pinepods.example.com`) |
|
|
|
|
When `server` is set, the app will navigate directly to your server on launch. If left empty, the app will open to a blank page and you will need to navigate to your server manually in the address bar.
|
|
|
|
---
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
pinepods-nix/
|
|
├── flake.nix # Nix flake definition
|
|
├── default.nix # Package definition entry point (non-flake)
|
|
├── pinepods.nix # Main package derivation
|
|
├── pinepods-module.nix # NixOS module definition
|
|
├── patch-lib.py # Build-time patch for server URL support
|
|
├── example-usage-flake.nix # Example flake for users
|
|
├── Cargo.lock # Cargo lockfile for src-tauri (Tauri binary)
|
|
└── Cargo.frontend.lock # Cargo lockfile for web/ (Yew/WASM frontend)
|
|
```
|
|
|
|
---
|
|
|
|
## How It Works
|
|
|
|
PinePods is a multi-component application. This package builds two components from source:
|
|
|
|
**Frontend (pinepods-frontend):** The Yew/WASM web frontend is compiled using `trunk` targeting `wasm32-unknown-unknown`. The output is a static `dist/` directory containing HTML, WASM, and CSS assets.
|
|
|
|
**Desktop client (pinepods):** The Tauri v2 desktop binary is compiled with `cargo`, with the pre-built frontend assets embedded directly into the binary via the `custom-protocol` feature. At build time, `tauri.conf.json` is patched to remove the `devUrl` so Tauri serves the embedded assets instead of connecting to a development server. The Rust source is also patched to read the `PINEPODS_SERVER` environment variable and navigate the app window to that URL on launch.
|
|
|
|
**Runtime dependencies** are provided via `wrapProgram`:
|
|
- WebKit2GTK 4.1 (Tauri v2 requirement)
|
|
- GStreamer + plugins (audio playback)
|
|
- libayatana-appindicator (system tray icon)
|
|
- GLib/GTK3/Cairo stack
|
|
|
|
---
|
|
|
|
## Building from Source
|
|
|
|
To build manually without installing:
|
|
|
|
```bash
|
|
git clone https://git.briannelson.dev/brian/PinePods-nix.git
|
|
cd pinepods-nix
|
|
nix-build -A pinepods
|
|
./result/bin/pinepods
|
|
```
|
|
|
|
To use the dev shell with all build tools available:
|
|
```bash
|
|
nix develop
|
|
```
|
|
|
|
---
|
|
|
|
## Updating to a New Version of PinePods
|
|
*This project is still a WIP so I have not been able to test these step until a new version of PinePods gets released*
|
|
|
|
To update to a new PinePods release:
|
|
|
|
1. Update the `version` and `sha256` in `pinepods.nix`:
|
|
```nix
|
|
version = "0.8.3"; # new version
|
|
sha256 = "..."; # run nix-build and paste the correct hash from the error
|
|
```
|
|
|
|
2. Replace the Cargo lockfiles with the new versions:
|
|
```bash
|
|
curl -L https://github.com/madeofpendletonwool/PinePods/archive/refs/tags/0.8.3.tar.gz | tar xz
|
|
cp PinePods-0.8.3/web/Cargo.lock ./Cargo.frontend.lock
|
|
cp PinePods-0.8.3/web/src-tauri/Cargo.lock ./Cargo.lock
|
|
```
|
|
|
|
3. Check if the `wasm-bindgen` version changed:
|
|
```bash
|
|
grep "wasm-bindgen" PinePods-0.8.3/web/Cargo.toml
|
|
```
|
|
If it changed, update `wasm-bindgen-cli` in `default.nix` and `TRUNK_TOOLS_WASM_BINDGEN` in `pinepods.nix` accordingly.
|
|
|
|
4. Rebuild and test:
|
|
```bash
|
|
nix-build -A pinepods
|
|
./result/bin/pinepods
|
|
```
|
|
|
|
---
|
|
|
|
## Troubleshooting
|
|
|
|
**White screen on launch**
|
|
Make sure `WEBKIT_DISABLE_SANDBOX_THIS_IS_DANGEROUS=1` is set. This is handled automatically by the package wrapper.
|
|
|
|
**No audio playback**
|
|
GStreamer plugins are included but if audio still doesn't work, check that your system has the required codec support:
|
|
```bash
|
|
gst-inspect-1.0 autoaudiosink
|
|
gst-inspect-1.0 appsink
|
|
```
|
|
|
|
**Login doesn't persist between sessions**
|
|
This is a known limitation of the WebKit localStorage implementation. As a workaround, set `services.pinepods.server` in your NixOS configuration so the app always navigates to your server on launch.
|
|
|
|
**Tray icon shows generic icon**
|
|
The icon is installed under the app's reverse-DNS identifier `com.gooseberrydevelopment.pinepods`. Make sure your icon theme cache is up to date:
|
|
```bash
|
|
gtk-update-icon-cache
|
|
```
|
|
|
|
---
|
|
|
|
## License
|
|
|
|
This Nix packaging is provided as-is. PinePods itself is licensed under GPL-3.0. See the [PinePods repository](https://github.com/madeofpendletonwool/PinePods) for details. |