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.
Latest stable release · published 2026-09-25
properpcloud v0.2.0-rc.7
Verified Android and Linux builds are published together with SHA-256 checksums and commit-bound release evidence.
Download and install
Section titled “Download and install”mpv on the host.
Download AppImage →
Linux x86_64
Flatpak bundle
Single-file Freedesktop 25.08 bundle, smoke-tested with MPRIS and narrowly bridged host mpv IPC.
Download Flatpak →
The release also includes machine-readable evidence, a source archive, and one checksum manifest covering every distributable.
Package-channel availability
Section titled “Package-channel availability”| Channel | Availability |
|---|---|
| Android APK | Published on the latest GitHub release; Google Play is not used yet. |
| AppImage | Published and smoke-tested on the release page. |
| Flatpak | A directly installable .flatpak bundle is published; it is not yet listed on Flathub. |
| Arch Linux / AUR | An immutable-source PKGBUILD renderer is prepared, but no AUR package is published yet. |
Debian / Ubuntu .deb |
Not currently published. Use AppImage or the Flatpak bundle. |
| Source | Clone the repository or download the tagged source archive. |
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 |
| Build/import the extensive pCloud media library | Media-library runbook |
| Understand trust boundaries | Architecture and privacy |
| Review changes and known limitations | Changelog |
Current clients
Section titled “Current clients”- Android: Jetpack Compose UI with Media3 playback, encrypted local session storage, and an explicit disconnected state until pCloud or the optional server catalog is selected.
- Linux desktop: Compose Desktop UI, mpv JSON IPC playback, SQLite state, Secret Service credentials, XDG paths, MPRIS media controls, and a deterministic generated-WAV verification source.
- Android test fixtures: deterministic generated WAV files remain test-only for credential-free playback and metadata verification.
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.
Recent releases
Section titled “Recent releases”| Version | Published | Status |
|---|---|---|
| v0.2.0-rc.7 | 2026-09-25 | Latest stable release |
| v0.2.0-rc.6 | 2026-09-16 | Previous release |
| v0.2.0-rc.5 | 2026-09-08 | Previous release |
| v0.2.0-rc.4 | 2026-08-28 | Previous release |
For complete user-visible changes, security notes, tests, and known limitations, read the full changelog.
Documentation as code
Section titled “Documentation as code”All published pages originate as Markdown under docs/, with the root changelog and canonical version data incorporated during the Astro Starlight build. GitHub Pages serves the generated static HTML.