Rabbithole: Difference between revisions

From PickiPedia: A knowledge base of bluegrass, old time psychedelic jams, and other public domain music
Jump to navigationJump to search
m Verified bot edits (removed proposal markers)
No edit summary
Line 1: Line 1:
'''Rabbithole''' is a music player that follows the people who played on a record. As a song plays, it shows who is playing what, stars whoever has the solo, and opens each player's PickiPedia page as they take it. Click a player to follow them to the next song they're on, down the rabbithole of pickers ([[Rabbithole Player|Justin's words, 2025]]).
===First, the "why"===
* Nearly all music players and so-called "streaming platforms" have a music discovery feature based on an algorithm. And just as often, these algorithms slowly lead the listener from the interesting, compelling music they desire, one-short-hop-at-a-time toward a sludgy gravitational center of poppy slop.


It runs at https://pickipedia.xyz/rabbithole/, beside the wiki it reads. The "▶ Listen in Rabbithole" button on a Song or Release page opens it on that song. It installs as an app.
* You might start with Tony Rice, but pretty soon you're on to Tennessee Whiskey, and from there, you're already on a collision course with Garth Brooks. (sorry not sorry)


''This page describes the beta. At block 26,371,563, rabbithole #23 to #28 are merged and #29, #31, #32 and #33 are open. PickiPedia hasn't been redeployed since, so the live site still shows the old song list.''
===Discovery through connections instead of algorithms===
'''Rabbithole''' is a music player that emphasizes the full ensemble of a track, and allows the listener to easily examine and delve into other works by members of that ensemble.
 
As a song plays, it shows who is playing what and opens each player's PickiPedia page as they take their solo. Click a player to follow them to the next song they're on, down the rabbithole of pickers.
 
===Public Beta beginning 11 Nov 2026===
At 11:11 on 11/11, we launched a public beta.  It's buggy for sure.  Bugs can be reported on the talk page for this page, or via [https://magenta.cryptograss.live/moods/rabbithole/ magenta].
 
* '''[https://pickipedia.xyz/rabbithole/?track=QmcBuh5HCvVCCdCz6KqWf891QkXeKc3T7QBaToYE8mSLtS Listen to "Paint Exchange" in Rabbithole here]'''


== Play ==
* '''The carrot''' is the play button: press it to play, and again to pause. As the song plays, the rabbit eats it, one bite for each part of the song behind you, so the carrot shows where you are. Jump back and the carrot grows back.
* '''Song parts''' lists the song's sections (intro, A, B, and so on). Click one to jump there.
* '''[https://webamp.org Webamp]''' is the player itself. Its seek bar, volume, equalizer and playlist all work.


== The cards ==
== The cards ==
Line 25: Line 30:
== Pick a song ==
== Pick a song ==
The dropdown under the title lists every song with a chart on PickiPedia, grouped by album. Chart a song and it appears there.
The dropdown under the title lists every song with a chart on PickiPedia, grouped by album. Chart a song and it appears there.
== Edit the timeline ==
The '''✎ edit timeline''' button beside the song's title opens the timeline editor. It lays the song's chart against its waveform: its parts, its solos, players coming in and dropping out, and flourishes.
* '''Save''' writes the chart to that song's own chart page, <code>Release:&lt;cid&gt;/Metadata</code>, as your edit, so you need to be signed in to PickiPedia. Save stays grey until you change something.
* '''Copy YAML''' shows the chart and the page Save would write to, without saving.
The chart's format is in the [https://github.com/cryptograss/rabbithole#track-data README].
== On a phone ==
A phone always gets the bottom bar, upright or sideways, with no layout switch. The cards show names only. Turned sideways, the wiki gets the top half of the screen.
On a computer, the link under the song parts switches between the sidebar and the bottom bar. To pick one for a single visit, add <code>?layout=bar</code> or <code>?layout=sidebar</code> to the address.
== The wiki pane ==
The pane shows PickiPedia beside the music. Links in it open in the pane, so the music keeps playing. Edit and history links open in a new tab. The menu at the top of the pane sets how much of the wiki it shows: <code>content</code> (the article alone), <code>header</code> (adds a search box and an "open ↗" link) or <code>skin</code> (the wiki's own look). That menu may go: [https://github.com/cryptograss/rabbithole/issues/34 rabbithole#34] proposes running Rabbithole on the real wiki page instead.
== Something wrong? ==
Say so in [https://magenta.cryptograss.live/moods/rabbithole/ #rabbithole] on magenta.
== For developers ==
* '''The code''' is at [https://github.com/cryptograss/rabbithole cryptograss/rabbithole]. Its README covers how it's built, how to run it locally, and how it's tested.
* '''Tests:''' <code>npm test</code> runs the vitest unit tests. <code>npm run test:e2e</code> plays a song in headless Chromium, with sound, and checks this page's features against the song's chart. The second comes with the branch <code>re/e2e-playthrough</code>, to merge after the beta.
* '''What's being worked on:''' [[Cryptograss:Moods/rabbithole/todo]], and [[26365350 Rabbithole beta work|magent's write-up of the beta]].
''Written by re at block 26,371,563. Checked against rabbithole <code>main</code> @ <code>68819bb</code> with #31, #29, #32 and #33 merged in that order and served locally. There the playthrough test passed all 29 of its checks, covering everything above except Save itself, the pane's menu and links, the desktop layout link, Webamp's own controls, and a picker's queue beyond its first song. The live site will match once those four PRs are merged and PickiPedia is redeployed.''

Revision as of 22:11, 11 November 2026

First, the "why"

  • Nearly all music players and so-called "streaming platforms" have a music discovery feature based on an algorithm. And just as often, these algorithms slowly lead the listener from the interesting, compelling music they desire, one-short-hop-at-a-time toward a sludgy gravitational center of poppy slop.
  • You might start with Tony Rice, but pretty soon you're on to Tennessee Whiskey, and from there, you're already on a collision course with Garth Brooks. (sorry not sorry)

Discovery through connections instead of algorithms

Rabbithole is a music player that emphasizes the full ensemble of a track, and allows the listener to easily examine and delve into other works by members of that ensemble.

As a song plays, it shows who is playing what and opens each player's PickiPedia page as they take their solo. Click a player to follow them to the next song they're on, down the rabbithole of pickers.

Public Beta beginning 11 Nov 2026

At 11:11 on 11/11, we launched a public beta. It's buggy for sure. Bugs can be reported on the talk page for this page, or via magenta.


The cards

  • Each person on the track has a card, with their instrument. Whoever has the solo leads, with a ⭐. A card dims while its player sits out.
  • A flourish is a moment the chart marks for one player, and their card glows. In August, Gaven Largent's dobro glows at 2:03.
  • Click a card to open that person's page.

Follow the solo

With Follow the solo on (the switch by the carrot), a song opens on its own Song: page. While the song plays, the wiki pane opens each player's page as they take the solo. It only moves while the music plays.

Steering the pane yourself turns it off, so what you're reading stays put. That means clicking a card or a link, or searching. While it's off, picking a new song leaves the pane alone too. Flip the switch to turn it back on.

Follow a picker

Open a player's page by clicking their card. The top of the page offers to follow them and names the song that plays first, for example: "Follow Kyle Tuttle: after this song, play the songs Kyle is on, one after another. First up: Silver 44." Press Follow, and each time a song starts, their next song lines up behind it. Songs you've already heard are skipped.

Pick a song

The dropdown under the title lists every song with a chart on PickiPedia, grouped by album. Chart a song and it appears there.