properpcloud documentation
properpcloud documentation
Section titled “properpcloud documentation”properpcloud is a folder-first audio player for pCloud libraries. It treats cloud folders as the primary catalog, builds deterministic playback queues without requiring complete tags, and keeps signed provider URLs out of persistent state.
Choose a starting point
Section titled “Choose a starting point”| Goal | Start here |
|---|---|
| Install and use the application | User manual |
| Run the Linux desktop client | Linux installation |
| Connect a pCloud account safely | Accounts and security |
| Build or contribute | Developer guide |
| Integrate a new source or persistence adapter | API reference |
| Understand trust boundaries | Architecture and privacy |
Current clients
Section titled “Current clients”- Android: Jetpack Compose UI with Media3 playback and encrypted local session storage.
- Linux desktop: Compose Desktop UI, mpv JSON IPC playback, SQLite state, Secret Service credentials, XDG paths, and MPRIS media controls.
- Deterministic demo source: local generated WAV files for verification without network access or credentials.
Core promises
Section titled “Core promises”- A folder can be browsed and queued even when embedded metadata is absent or inconsistent.
- Provider identity uses stable source and node identifiers, never temporary download URLs.
- Queue and progress survive application restarts.
- Credentials are delegated to platform credential stores.
- Metadata repair is explicit, previewable, and separate from ordinary playback.
Documentation as code
Section titled “Documentation as code”All published pages originate as Markdown under docs/. The static documentation site synchronizes those files into an Astro Starlight build and deploys the generated HTML through GitHub Pages.