Junk Collector v0.1.0-beta.23

Junk Collector v0.1.0-beta.23

• Start a Library audio preparation batch immediately from the current album
  selection. Album planning runs in the background, with progress, per-album
  results and cancellation in Activity. Cancelled album work settles before
  Retry becomes available.
• Find selectable Proton Bridge mail folders during setup or while editing
  a saved mail connection. Add folders from the picker or enter their exact
  names. Saving preserves the paused or enabled state and existing scan
  positions.

See audio preparation and
mail setup and folder editing.

This prerelease uses the preview channel. Before updating a split Fi/NAS
installation, stop writers and retain a matched private-state and archive
recovery pair. See the remote archive runbook.

Junk Collector v0.1.0-beta.22

Junk Collector v0.1.0-beta.22

• Prepare albums or batches in FLAC or one of three Opus VBR presets. The
  Library updates readiness for the selected preset as source records and Jobs
  change. Music collections can set an Opus default for CD imports or for both
  CD and digital imports, with an override during review.
• Saved import groups show the newest groups first. Select published albums
  within a group to edit title, artist or digital source in bulk. Results are
  reported per album, and digital source edits apply to digital-only albums.
• Sign-in asks for a username by default. Set multi_user = false for a
  single-user installation that uses the saved default account and disables
  account creation. Existing accounts and grants are retained.

See audio preparation,
saved import review and
account setup.

This prerelease uses the preview channel. Before updating a split Fi/NAS
installation, stop writers and retain a matched private-state and archive
recovery pair. See the remote archive runbook.

Junk Collector v0.1.0-beta.21

Junk Collector v0.1.0-beta.21

Audio uses the normal signed-in website connection by default, including through
proxies and tunnels. Login and collection permissions always apply. Collector
does not detect providers or enforce their restrictions.

Use Administration → Server settings → Audio connection → Require a separate
audio connection to opt into private or separate HTTPS playback. The saved
choice persists across restart and overrides the remote_media_allowed config
default. Existing explicit false configurations retain their separate-route
choice. Alternate endpoints may remain configured while normal audio is selected.
Reconnect other clients to clear cached routes after changing the setting.

Cancelled or withdrawn processing publications now remove their own unpublished
journal/staging before releasing the archive writer. This prevents that abandoned
work from blocking a later publication or restart. Existing conflicting or unknown
journals are retained for inspection; no blanket historical cleanup is performed.
Raw masters, manual metadata, accepted sources and unknown module data are preserved.

This prerelease advances preview and leaves stable latest unchanged. Stop
writers and retain a matching complete Fi private-state/NAS archive recovery pair
before updating. Install the exact qualified image. The remote-archive Compose
profile retains its provisioned media authority even when normal audio is selected,
so a later toggle can enable the alternate route and a fresh media volume can start.

See audio behavior and review
and the release operation record.

Junk Collector v0.1.0-beta.20

Junk Collector v0.1.0-beta.20

Digital album matching finds promising releases earlier, compares complete track
lists before optional artwork finishes, and bounds searches for alternate editions.
Metadata review offers independent digital-source and artwork choices, clearer
track mapping, and consistent MusicBrainz/AcoustID search panels. Retained results
are labelled as earlier results; only the release actually in use is marked selected.

Background matching recovers brief catalog contention through the server queue,
without turning it into a failed Job that needs manual retry. Progress, cancellation,
ownership and committed publication survive that handoff. Error feedback now keeps
safe failure causes and distinguishes a completed save from a failed refresh.
Unconfirmed or unreadable queue receipts remain visible across app pages.

Raw masters, accepted metadata/artwork sources, manual authority and unknown module
data remain protected. Already failed Jobs are not resubmitted automatically;
after upgrading, explicitly retry matching requests that previously stopped on
catalog contention. Provider refusals are not treated as contention.

This prerelease advances preview and leaves stable latest unchanged. Stop
writers and retain a matching Fi private-state/NAS archive recovery pair before
updating. Publication and installation use the exact qualified images.

Qualification, Fi installation and lossless legacy-journal recovery record.

v0.1.0-beta.19

v0.1.0-beta.19

Metadata opens with compact cached rows, loads more entries incrementally and
fetches album detail on demand. Open reviews check a small revision header before
reloading. Artwork remains beside rows, with current access and language checks. Brief catalog
contention recovers automatically for read requests.

Digital album identification calculates tracks concurrently using the configured
processing budget. AcoustID lookups begin as fingerprints finish, and independent
provider services can overlap. Fresh calculations validate each selected original
once and decode at most the first two minutes. Valid fingerprints and fresh
provider responses are reused; Refresh lookups explicitly requests new recognition
responses without recalculating unchanged audio. Progress shows completed
fingerprints/lookups and release comparison; usable candidates appear before
optional covers finish. Broader release searching remains an explicit action.

Queueing another album preserves earlier requests. Navigation no longer owns the
admission request; unconfirmed requests stay visible with recovery controls.
Work and cancellation survive restart, and Activity groups internal steps under
the album. These are identity suggestions, not catalog verification. Manual
metadata/artwork authority and exact original files remain protected.

This beta also includes complete declared RIFF/WAVE audio with uninterpreted
trailing bytes: usable declared audio is accepted, the suffix warning remains
visible, and the exact original is preserved. Truncated or internally malformed
WAV data still fails closed. Existing failed Jobs are not retried automatically.

The upgrade adds rebuildable caches/indexes and private workflow checkpoints; it
does not compact originals, unknown module records or accepted evidence. Stop
writers and retain matching Fi private-state/NAS archive recovery points before
updating. Install the qualified release image. This prerelease advances preview
and leaves stable latest unchanged.

See qualification and limits
and WAV acceptance.

Junk Collector v0.1.0-beta.18

Progressive Library refresh, lazy album tracks and requested-byte media reads; explicit all-file mapping for partially recognized digital albums; resumed automatic cover publication; and consistent grouped-import physical-copy setup.

Manual metadata/artwork retain authority, originals remain unchanged, and unrelated inventory edits still conflict. Core and media update together. Installed Trash Amp is unchanged; its separate refresh work remains staged.

Upgrade from beta.17 without re-enrollment. Pull before downtime and retain a complete stopped-writer recovery point; Fi requires matching local-state and NAS archive snapshots. This prerelease advances preview and leaves stable latest unchanged.

Detailed changes and upgrade notes.

Junk Collector v0.1.0-beta.17

Purchased-audio compatibility now includes empty zero-padded PCM WAV format headers, the upstream MP3 empty-channel decoder correction, and bounded APEv2 suffix metadata/front artwork. Metadata bytes are excluded from MP3 decoding and seeks. Original files remain byte-identical.

Failed identification can retry after originals have already been preserved: open Review import → Retry this step. The same Job validates the archived files, preserves manual metadata and resumes originally requested automatic FLAC preparation without another preservation Capture. Retries are explicit. Twelve observed WAVs with contradictory lengths remain rejected; float/multichannel WAV and additional codecs are outside this change.

This beta also includes improved inbox folder controls, scoped bulk selection and package review in a popup. Update core and media together. No new enrollment or data conversion is required from beta.16. Retain a complete stopped-writer recovery point first; Fi requires matching local-state/NAS snapshots.

This prerelease advances preview; stable latest is unchanged. Publication consumes the qualified AMD64/ARM64 image bytes and attaches the pinned installation bundle and image/provenance record.

Full release notes and upgrade instructions

Junk Collector v0.1.0-beta.16

Digital soundtrack discovery now recognizes exact FLAC, MP3 and WAV format folders, uses the parent album name, and retains parent covers/booklets. Numbered discs work above or below the format folder. Separate albums, named OST/DLC sections and alternate encodings remain distinct.

Common parent companions are retained once with a deterministic version. Existing archived imports are unchanged; no data conversion or new enrollment is required from beta.15. Update core and media together after a complete stopped-writer recovery point. Fi requires a paired local-state/NAS snapshot.

This prerelease advances preview; stable latest is unchanged. The container release workflow publishes the exact qualified AMD64/ARM64 image bytes and attaches the pinned installation bundle plus image/provenance record.

Full release notes and upgrade instructions

Junk Collector v0.1.0-beta.15

Junk Collector v0.1.0-beta.15

This beta completes integer PCM WAV digital-release support and includes the
private email purchase inbox and Proton Bridge connection/recovery work delivered
since beta.14. Collector core and media update together; Trash Amp is unchanged.

WAV digital originals

Import WAV originals without creating physical copies. Exact source bytes remain
preserved. Explicit FLAC preparation retains sample rate, channels and bit depth,
with independent sample comparison before publication. Existing FLAC and MP3
originals play directly; MP3 is never reencoded.

WAV INFO/ID3 tags and embedded covers feed normal metadata/artwork. Explicit album
matching reads original PCM without an encoder and honors excluded alternates.
Existing retained digital packages can be analyzed in place from the Music editor;
manual edits, originals, Captures and physical inventory survive.

Prepared Music FLAC downloads carry accepted album/track metadata, available cover
preview and descriptive filenames without modifying archived listening files.
Saved download links retain authorized historical audio access when its owning
module becomes unavailable.

Supported WAV inputs are RIFF/checked extensible integer PCM, 16/24-bit mono/stereo,
8–192 kHz, at most 24 hours/file and 4,096 chunks. Float/compressed WAV, multichannel,
RF64 and continuous-image/CUE splitting remain unsupported. Audio matching requires
configured providers; identity candidates do not establish catalog verification.
See workflow and
validation.

Private purchase inbox and Bridge

Review private email purchase suggestions, accept/link them deliberately, dismiss,
restore and reopen them for correction. Proton Bridge setup, pinned connections,
sync status, scanned-folder editing and credential revalidation are available in
the web UI. Durable receipts, owner/cancellation fences and interrupted-work
recovery preserve accepted purchases and connection history. This does not enable
scanning or replace saved credentials automatically. The installation bundle includes
the optional mail override, Bridge build context and local provisioning helper. See
email purchase support.

Upgrade and rollback

Use ghcr.io/aberrantwolf/junk-collector:v0.1.0-beta.15 or the immutable digest in
release-image.json. Update core and media together, retaining existing Compose,
configuration, ServerId/TLS, accounts, grants, Jobs, imports, scratch, archive and
Bridge state. Do not rerun setup or initialize a replacement archive. Existing
beta.14 installations require no new enrollment or destructive audio conversion.
First adoption from beta.13 or earlier still requires the documented offline
archive enrollment.

Pull before downtime, stop all writers, and retain a complete consistent recovery
point before activation. Fi's local state/config and remote archive require a
matching stopped-writer recovery pair; preserve the old image and stack definition.
Rollback after new writes restores both members of that pair with all writers
stopped, rather than downgrading only the image or database. See
snapshot recovery and the
remote archive runbook.
This prerelease advances preview; stable latest remains unchanged.

Junk Collector v0.1.0-beta.14

Junk Collector v0.1.0-beta.14

This beta adds reviewed digital-album matching and safeguards for a later move to
local private state with a remote archive. It also works with the current
single-NAS storage layout; publishing this release does not approve migration.

Digital album matching

Explicit discovery fingerprints original-file FLAC/MP3 albums, looks up AcoustID
recordings and MusicBrainz releases, and presents coverage, durations, artwork and
one-to-one track assignments for review. Complete unambiguous mappings can be
applied through the existing metadata workflow. Durable jobs support cancellation
and retry; source and metadata changes invalidate stale reviews. Raw masters and
manual metadata retain authority. Browsing and polling do not read audio.

A configured AcoustID application key is required. Live recognition with that key
and representative user-approved audio remains unqualified. Support is limited
to mono/stereo FLAC and MP3, up to 256 files. Partial or ambiguous matches remain
suggestions for the manual metadata tools. This release updates Collector only.

Storage admission and interrupted work

Normal startup now requires a matching archive identity and private-state binding.
Missing mounts, a different archive and missing/empty established private SQLite
state fail closed. Runtime storage failures latch unavailable and preserve
recoverable work. Publication/recovery distinguish I/O errors from absent files;
archive publication staging remains on the archive filesystem. Fresh setup is an
explicit path with durable interruption recovery.

Independent state/config, archive and inbox host paths, read-only isolated media
access and guarded Linux mount/boot templates support later migration. See the
remote archive runbook for required NFS
semantics, reconnect, coordinated backup, paired rollback and approval criteria.
Actual Fi/NAS write/outage/boot and paired-restore qualification is still required.

Upgrade and rollback

Use ghcr.io/aberrantwolf/junk-collector:v0.1.0-beta.14 or the immutable digest in
release-image.json. Update core and media together. Preserve configuration,
identity/TLS, accounts, grants, jobs, uploads, imports, scratch, the complete archive
and existing mounts. Do not rerun setup or initialize a replacement archive.

First adoption from beta.13 or an older installation requires offline enrollment.
Pull the new image before downtime. Stop all writers and media, confirm their clean
exit, and make a complete consistent recovery point with the old image and retained
stack/config. Verify the actual existing archive and private-state roots. Run the
new image's enroll-archive command against those exact roots as the application's
user/groups, then start core and media with the same qualified image. Enrollment
records identity/binding; it does not qualify NFS or replace backup verification.
Use the retained configuration rather than a sample. See update instructions.

The current NAS's complete stopped-server Btrfs snapshot can still cover its
single-root installation. After the local-state/remote-archive split, recovery
requires a coordinated archive plus complete local state/config pair, including
all state/imports. Rollback after any new writes restores the complete matching
pair and old image with all writers stopped; merely downgrading the container or
restoring only one side is unsafe. Retain the newer pair separately for diagnosis.
See snapshot recovery and the split
runbook before restoring. This prerelease advances preview; stable latest
remains unchanged.