Archive collection
Netlabels
Independent releases and artist-run labels.
Discovery Options
Artist exclusions apply on this device, using Archive credits.
Discover
Explore Genres
Collections & Playlists
Archive collection
Live Music Archive
Concert recordings and live sets.
Internet Archive
Recently Added
Looking through the Archive…
Archive Music
LIVE ARCHIVE INDEXLiked Tracks
Loading library…
Playlists
Saved in this browser. Back up your library to keep a copy.
Up Next
Options
Saved on this device. Restores paused.
Updates
Log
Updates to the player, discovery tools and saved library.
- Last updated
- 11 Oct 2026
In progressAwaiting release.
ShippedPublished and verified.
Known IssuesUnresolved issues.
- Shipped
Discovery
Music Releases in Discovery
Search, genres and related releases exclude labelled sample packs and libraries. Mutation uses its newer upload, with the superseded listing removed from discovery.
Verified on 14 Oct 2026: 17 focused tests passed. Live Archive query and public browser search return seven artist releases, including only mutation-akol-v2 and excluding Transmutation. Normal and fresh public assets serve the filter.
- Shipped
Interface
Room Across the Page
Every view uses the available content width, with consistent edge padding. Search, collections, release grids, library, queue, Docs and Log expand with the window.
Verified on 12 Oct 2026: local and public browser checks confirm full-width views at 1440px, 1920px and 2880px, with no horizontal overflow on mobile down to 320px.
- Shipped
Interface
More Room for Music
Smaller headings, controls and cards, with tighter spacing across the app. Search filters sit together and empty status messages take no space.
Verified on 11 Oct 2026: desktop search results start at 183px. Responsive checks cover every view down to 320px wide. Local library and dialog checks, public layout and artwork checks, and the automated suite passed.
- Shipped
Interface
A Consistent Sidebar
The desktop sidebar stays 220px wide across every view. Mobile navigation keeps its existing layout.
Verified on 11 Oct 2026: local layout, artwork and library checks passed. Public layout and artwork checks passed, and both deployed stylesheets match the source.
- Shipped
Interface
Shared UI Components
Base UI now handles dialogs, artwork, and queue options. Titles are consistent and everyday copy is shorter.
Verified on 11 Oct 2026: 16 unit tests and six browser suites passed locally. The public site passed dialog focus and dismissal, library recovery, artwork layout, and Archive failure checks using controlled responses. Deployed scripts and styles match the reviewed source.
- Shipped
Interface
A Quieter Queue.
One heading, one empty state, and queue preferences under Options. Empty groups and unused search controls stay out of the way. Repeated introductory copy has been removed from Discover.
Verified on 11 Oct 2026: empty queue layout, filtering, library recovery and paused queue restoration passed locally and on the public site. Artwork drawer regression passed locally.
- Shipped
Reliability / Archive requests
Less Work for a Cover.
Browsing and library lists use Archive thumbnails without fetching extra metadata or probing original images. Opened releases and the player still resolve larger artwork, sharing the result across repeated cover elements. Failed requests show their error on Discover and no longer claim that the app is working normally. Retry stays manual.
Verified on 11 Oct 2026: 16 local unit tests, local library and drawer regressions, and public drawer and failure-display checks using controlled Archive responses. Live checks also reproduced a search timeout and direct Archive HTTP 502 responses. Reduced request volume is verified; the cause of the upstream interruption is not established.
- Shipped
Player / artwork
Artwork in Its Own Drawer.
The player thumbnail opens a separate artwork panel over the sidebar. It fits the whole cover above the player without moving the page or interrupting audio. Close it with the thumbnail, Close button or Escape. Covered navigation is kept out of keyboard focus.
Verified publicly on 11 Oct 2026: deployed assets and drawer checks at four desktop and mobile sizes, including short screens, unchanged page geometry, Close and Escape focus recovery, and unchanged prepared audio state using a controlled Archive fixture. Local library recovery and genre-layout browser checks also passed.
- Shipped
Name / language
A New Name: Sully.
The player has a new name and revised wording that puts the music and its makers first. Existing listening links, likes, playlists and backups remain compatible.
Verified publicly on 11 Oct 2026: Sully app and information page, old-route redirects with query strings and listening fragments, and a shared Archive release opening without autoplay. Locally: 12 unit checks plus library recovery, genre browsing and responsive-layout browser suites passed.
- Shipped
Released / genre discovery
More Than One Way Into a Genre.
The directory has 165 genre names across 14 overlapping families. Explore narrower and neighbouring styles separately from adding listening filters. Alternative names, a complete alphabetical view, and custom or unclassified tags stay accessible.
Balanced starting selections give each family space, stay stable while browsing, and change on Reshuffle. Recent selections stay on this device. This rotates genre suggestions, not recordings; catalogue coverage and playable availability are not implied.
Checked: automated checks and all three browser suites passed on preview and the public site, including overlapping selection, reload stability, unavailable storage, failed-directory recovery and narrow screens. The Figma revision is implemented: a dense directory, dedicated relationship views, 44px filter targets and a selection bar above playback. Keyboard focus and browsing position are retained when returning. Verified publicly on 11 October 2026, including keyboard access, scroll restoration and narrow or short screens.
- Shipped
Library / interface
A Library That Can Leave with You.
Playlists, complete-library backups, editable metadata modes, local artist exclusions and optional paused queue recovery, with the shared Figma interface and sorting for liked releases. Tested migration from existing likes and restore into a fresh browser. Sound analysis is not connected. See DEVELOPMENT.md for remaining work.
- Shipped
Fixed / navigation
One Column, Including Short Screens.
The desktop sidebar keeps its vertical navigation at every height, with tighter spacing and flexible artwork. On phones, a Menu button opens the same single list instead of occupying the screen with a two-column grid.
Checked locally and publicly on 10 Oct 2026 at six screen sizes: single-column alignment, artwork fitting without sidebar scrolling, mobile Menu opening and closing, navigation and keyboard focus.
-
Shipped
Fixed / discovery and playback
Names Stay Together. Artwork Gets Room.
Search now offers Artist, Release Title, Tags and Artists & Releases. Names stay together, with credited artists weighted above release titles and relevance before recency. Nothing gives a particular artist special treatment.
The shared sidebar fits the screen without its own scroll, with larger artwork and no repeated track details. Short screens compact the navigation. Main content remains scrollable.
FLAC, WAV and Opus join the supported audio files. Each recording gets one playable rendition, so an MP3 elsewhere on an album no longer hides its other tracks. Items with no public playable audio explain the limitation and link to the source.
Checked publicly on 10 Oct 2026: the normal and fresh Sully URLs, artist search returning nine A Kind of Likeness releases, MP3 playback, silent FLAC Slips and responsive sidebar. Also checked locally: artist, title and tag search; MP3 and FLAC playback; exact shared links without autoplay; unavailable-item explanation; navigation; six desktop and mobile sizes; format and reference regression checks.
-
Shipped
Changed / interface
The Buttons Have Stopped Pretending.
Sully now uses its shared Figma spine: a proper listening rail, a dedicated Discover route, and one icon language. Share has left transport where it was causing trouble and now sits where a normal human expects it.
Checked publicly: the normal Sully URL now serves the Figma interface; desktop and narrow layouts, navigation, release detail, track selection, and the exact-share sheet were also checked locally.
-
Shipped
Added / sharing
Share.
Sully Slip gives a specific Archive release, file, and optional listening moment its own compact link. A recommendation should arrive as the thing, not as a scavenger hunt.
Checked: protocol, real inbound Slip, share controls, and public route on 07 Oct 2026.
-
Shipped
Added / embed
Quiet by Construction.
A small embed points at the same public Archive item. It presents a plain Play button; it does not make a room suddenly make sound merely because a page loaded.
Checked: the public embed resolved its real Archive track and remained quiet until explicit Play on 07 Oct 2026.
-
Shipped
Added / keeper tools
A Log and a Manual, Because Future-you Is Also a Person.
This Log records behaviour and deployment facts. Docs is the non-user manual: where data comes from, where state lives, how sharing works, and how to change things without turning a small player into a haunted house.
Checked: Log and Docs opened on public Sully while the selected track remained ready on 07 Oct 2026.
-
Known Issues
Boundary / previews
Fragments Are Invisible to the Server.
Sully Slips use the URL fragment so sharing stays static and private to the browser. That means a server cannot make per-track social preview cards from a Slip alone. Proper Open Graph or oEmbed previews need a separate server-backed project.
Updating the Log
Append one entry after a meaningful behaviour, reliability, or deployment change. Give it a date, a status, a short title, what changed, and what was actually checked. Mark a local change In progress. After the feature is checked publicly, change the entry to Shipped, publish that status update, and check the public Log itself.
YYYY-MM-DD · [IN PROGRESS | SHIPPED | KNOWN ISSUES] · [ADDED | CHANGED | FIXED] Small memorable title. What changed and why it matters. Checked: command, browser path, or public URL. Caveat: the honest edge, if there is one.
Maintenance
Keepers’ Manual
How Sully works, where its data comes from, and how to maintain it.
- Shape
- Static client-side app
- Source of music
- Internet Archive metadata + files
- First rule
- Keep it small, legible, and honest
Getting Started
- Read the source and this manual before editing. Shared controls use Base UI.
- Serve the repository with a static server. After editing src/ui.jsx, run npm ci and npm run build from tools/sully.
- Make the smallest layer-specific change: markup and CSS for a static view, app code for behaviour, protocol code for sharing.
- Run focused checks, then use a real Archive item in a browser. A green syntax check cannot tell you whether live metadata is strange today.
- Update Docs when a contract changes, append the Log for meaningful behaviour or deployment facts, then deploy coupled assets together.
Do not put credentials here. The handover ledger records where deployment knowledge lives, not secrets themselves.
System Map
browser
├─ index.html structure, styles, dialogs, navigation
├─ app.js search, release UI, player, queue, liked state
├─ artwork.js artwork helpers
├─ Internet Archive advancedsearch
│ └─ discovery result identifiers
├─ Internet Archive metadata/{identifier}
│ └─ authoritative labels + playable files
└─ IndexedDB: slop-library / saved
└─ this browser's liked tracks only
There is no account, server-side library, queue sync, or hidden recommendation profile. The app asks Archive for public information and keeps only local convenience state in the browser.
Data and Playback: Let Archive Metadata Win
Discovery can begin with an Archive advanced-search result, but a release and playback resolve Archive metadata. That response is the authority for the title, creator, date, rights, and actual file list.
Construct playable URLs from the Archive identifier and the exact metadata file name. A human-facing release title is a label, never a stable audio path. Show a plain failure rather than guessing a nearby URL.
Playback state is one thing at a time: selected track, source URL, audio element, and visible player. Reading Log or Docs must not reset playback or queue state.
Local State: Liked, Queue, History
Individual liked tracks live in IndexedDB under slop-library, store saved. This is per-browser convenience state. Never imply that a link, export, or feature shares it with another person.
Queue and listening history are session behaviour. The easy regression is making a detail dialog or received link unexpectedly write history, clear a queue, or start audio.
When changing local data shape, keep backwards reads tolerant where possible and test an existing browser profile as well as a blank one.
Sully Slip: Exact Sharing Without a New Service
A Slip is a versioned location fragment:
Discovery excludes uploads labelled as sample packs, sample libraries or loop packs in their titles or tags, and known superseded uploads. Search matches phrases in credited artists and release titles. The Tags option searches Archive subject tags. Use the search type to narrow the field. Search results use relevance; browsing without a query uses newest uploads. Archive credits can be incomplete. Audio renditions are selected per original recording according to browser support; private files are excluded. Some Archive records contain only bundles or restricted audio.
#v=1&r=archive-identifier&f=relative%2Ftrack.ogg&at=83
v=1is a promise that the format remains readable; do not reinterpret it silently.ris the validated Archive identifier.fis optional for a release-only Slip. When present it must be a relative playable mp3, ogg, m4a, flac, wav, or opus file: no scheme, backslash, control character, absolute path, or dot segment.atis an optional whole-second timestamp, capped at seven days, and only makes sense withf.- Labels displayed to the listener come from Archive metadata, never text in a URL.
A release-only Slip opens the release. A track Slip prepares the exact track and seeks once its source is ready, but never autoplays. Keep timestamp listeners bound to the expected source so a later track choice cannot receive an old seek.
Location fragments are not sent to a static server. That is good for this no-account protocol, but per-track social cards and oEmbed discovery are a separate server-backed project if they are ever wanted.
Release Procedure: Change, Check, Say What Happened
- Name the user-visible outcome and the invariant that must survive it.
- Trace the live path before editing: source, state, player, and public URL contract.
- Change the smallest appropriate layer. Avoid unrelated clean-up on a live fix.
- Run focused syntax checks, then test a real Archive result and fresh sharing link in a browser.
- Update Docs when the stable handover knowledge changed. Append a Log entry for behaviour, reliability, or deployment facts.
- Deploy coupled static files together and bump cache suffixes when browsers could otherwise keep mismatched code.
- Verify the public functional release in a fresh tab.
- Then publish the Log status change from In progress to Shipped in a separate small update and verify the public Log itself.
Handover Ledger: Leave a Trail, Not a Treasure Map
Handover status: source and deployment facts are recorded here; add a human contact route before a formal handover. This manual gives the shape of the work; it must not bluff access it does not have.
| Thing | Record here |
|---|---|
| Live URL | akindoflikeness.net/tools/sully/. Record the date it was last verified. |
| Source location | GitHub repository akindoflikeness/akindoflikeness-site, path tools/sully/, branch main. |
| Deploy path | Push the reviewed commit to main. Cloudflare Pages publishes the static site. Roll back with a reviewed revert on main; never paste access tokens here. |
| Known edges | Archive availability and metadata quality are external dependencies. Sully Slip fragments cannot produce server-side social previews alone. |
| Last keeper | Required before formal handover: add a human contact route, not an assumption that the previous laptop remains immortal. |
Troubleshooting: Boring Answers First
- A Slip opens the wrong track.
- Confirm metadata file name matches
fexactly, including nested directories and Unicode. Confirm audio URLs use the Archive identifier, not a displayed release title. - A received Slip suddenly plays.
- Check the prepare path passes an explicit no-autoplay flag and a browser user gesture is still required for playback.
- The app has old behaviour after deploy.
- Look for mismatched cached static assets. Update cache suffixes on files that must ship together and check a fresh tab.
- Docs broke a shared track.
- Remove hash routing or anchor links. Tabs use the in-app view system, leaving
location.hashentirely to Sully Slip.
About Sully
Explore and listen to music from the Internet Archive. Each release links to its original artwork, credits, and rights.
Listening
Select a cover to play an album, or its title to see the tracks. Added tracks play before the rest of the album.
Your Library
Likes and playlists stay in this browser. Back up your library to keep a copy. Backups contain track references, not audio.
Privacy
No account required. Audio streams from the Archive. Shared links include only the selected recording.
Source & Licences
Sully is open source. Recordings retain their original rights.