Skip to content

bobrippling/podsync

Repository files navigation

podsync

A HTTP server for syncing podcast app state, mirroring the gpodder API. Designed for use with AntennaPod's sync service.

Endpoints

podsync doesn't cover the full gpodder API, just enough to get AntennaPod to work:

  • auth:
    • POST api/2/auth/{username}/login.json
    • POST api/2/auth/{username}/logout.json
  • devices:
    • GET api/2/devices/{username}.json
    • POST api/2/devices/{username}/{device}.json
  • subscriptions:
    • GET api/2/subscriptions/{username}/{device}.json
    • POST api/2/subscriptions/{username}/{device}.json
  • episodes:
    • GET api/2/episodes/{username}.json
    • POST api/2/episodes/{username}.json

Logging

podsync uses the RUST_LOG environment variable for logging. To generate logs similar to a webserver:

export RUST_LOG=podsync=info

# or for debugging:
export RUST_LOG=podsync=trace

# for warp/endpoint output:
export RUST_LOG=podsync=info,warp=info

See the log crate for more details

Building

podsync uses sqlx in offline mode for builds (see build.rs for more).

To update the schema:

export DATABASE_URL=sqlite://pod.sql
cargo install sqlx-cli
cargo sqlx prepare -- --tests --features backend-sql
git commit -m 'Update sqlx snapshot' sqlx-data.json