-190

src/_data/elements.yaml

reviewed

··· 1 1 - artwork: 2 2 - - url: "components/artwork/audio-metadata/element.js" 3 3 - title: "Audio Metadata" 4 4 - desc: "Extracts embedded artwork from audio files using the music-metadata library." 5 5 - - url: "components/artwork/input/element.js" 6 6 - title: "Input" 7 7 - desc: "Fetches artwork by delegating to the configured input element's artwork method." 8 8 - - url: "components/artwork/last.fm/element.js" 9 9 - title: "Last.fm" 10 10 - desc: "Fetches cover art from the Last.fm API using track artist and album tags." 11 11 - - url: "components/artwork/musicbrainz/element.js" 12 12 - title: "MusicBrainz" 13 13 - desc: "Fetches cover art from MusicBrainz and the Cover Art Archive using track artist and album tags." 14 14 - 15 15 - configurators: 16 16 - - url: "components/configurator/artwork/element.js" 17 17 - title: "Artwork" 18 18 - desc: "Takes artwork components as children and tries each in sequence, returning the first non-null result." 19 19 - - url: "components/configurator/input/element.js" 20 20 - title: "Input" 21 21 - desc: "Allows for multiple inputs to be used at once." 22 22 - - url: "components/configurator/metadata/element.js" 23 23 - title: "Metadata" 24 24 - desc: "Takes metadata components as children and chains their patches in sequence." 25 25 - - url: "components/configurator/output/element.js" 26 26 - title: "Output" 27 27 - desc: "Enables the user to configure a specific output. If no default output is set, it creates a temporary session by storing everything in memory." 28 28 - - url: "components/configurator/scrobbles/element.js" 29 29 - title: "Scrobbles" 30 30 - desc: "Configure multiple scrobblers (music trackers)." 31 31 - 32 32 - engines: 33 33 - - url: "components/engine/audio/element.js" 34 34 - title: "Audio" 35 35 - desc: "Plays audio through audio elements." 36 36 - - url: "components/engine/queue/element.js" 37 37 - title: "Queue" 38 38 - desc: "A queue for tracks." 39 39 - - url: "components/engine/repeat-shuffle/element.js" 40 40 - title: "Repeat & Shuffle" 41 41 - desc: "Signals synced with local storage (classified by group) that decide if audio should be repeated and if the queue should be shuffled when filling it." 42 42 - - url: "components/engine/scope/element.js" 43 43 - title: "Scope" 44 44 - desc: "Signals that could influence the scope of a set of tracks." 45 45 - 46 46 - input: 47 47 - - url: "components/input/dropbox/element.js" 48 48 - title: "Dropbox" 49 49 - desc: "Audio files from Dropbox, using the Dropbox v2 HTTP API." 50 50 - - url: "components/input/ephemeral-cache/element.js" 51 51 - title: "Ephemeral Cache" 52 52 - desc: "Wraps another input and caches its track listing in memory for the duration of the session." 53 53 - - url: "components/input/https/element.js" 54 54 - title: "HTTPS" 55 55 - desc: "HTTPS URLs to audio files or streams." 56 56 - - url: "components/input/icecast/element.js" 57 57 - title: "Icecast" 58 58 - desc: "Icecast internet radio streams. Fetches ICY metadata to populate track information." 59 59 - - url: "components/input/local/element.js" 60 60 - title: "Local" 61 61 - desc: "Audio files or directories from your local device, using the browser's File System Access API." 62 62 - - url: "components/input/opensubsonic/element.js" 63 63 - title: "Opensubsonic" 64 64 - desc: "Add any (open)subsonic server." 65 65 - - url: "components/input/s3/element.js" 66 66 - title: "S3" 67 67 - desc: "AWS S3 and services that provide the same surface API such as Cloudflare R2." 68 68 - - url: "components/input/webdav/element.js" 69 69 - title: "WebDAV" 70 70 - desc: "Add any WebDAV server." 71 71 - 72 72 - metadata: 73 73 - - url: "components/metadata/audio-file/element.js" 74 74 - title: "Audio File" 75 75 - desc: "Extracts tags and audio stats from audio files using the music-metadata library." 76 76 - 77 77 - orchestrators: 78 78 - - url: "components/orchestrator/artwork/element.js" 79 79 - title: "Artwork" 80 80 - desc: "Fetches cover art for a given set of tracks, stored locally in indexedDB. Uses the artwork configurator to try each configured source in sequence." 81 81 - - url: "components/orchestrator/auto-queue/element.js" 82 82 - title: "Automatic Queue" 83 83 - desc: "Fill the queue automatically with non-manual items (shuffled or regular, based on repeat-shuffle engine)." 84 84 - - url: "components/orchestrator/controller/element.js" 85 85 - title: "Controller" 86 86 - desc: "Provides commonly used computed signals derived from the audio engine, queue engine, and output. Exposes currentTrack(), isPlaying(), and references to the underlying engines." 87 87 - - url: "components/orchestrator/cover-groups/element.js" 88 88 - title: "Cover Groups" 89 89 - desc: "Groups tracks by cover art to form collections." 90 90 - - url: "components/orchestrator/favourites/element.js" 91 91 - title: "Favourites" 92 92 - desc: "Mark tracks as favourites. Automatically creates an unordered 'Favourites' playlist." 93 93 - - url: "components/orchestrator/media-session/element.js" 94 94 - title: "Media Session" 95 95 - desc: "Keeps the browser/os media session in sync with queue and audio state. Adds handlers for previous, next, seek to, etc." 96 96 - - url: "components/orchestrator/offline/element.js" 97 97 - title: "Offline" 98 98 - desc: "Registers a service worker that makes the page available offline. Resources (except audio & video) are cached as they load and served from cache when offline." 99 99 - - url: "components/orchestrator/output/element.js" 100 100 - title: "Output" 101 101 - desc: "A default output configuration. Contains all the outputs provided here along with the relevant transformers." 102 102 - - url: "components/orchestrator/path-collections/element.js" 103 103 - title: "Path Collections" 104 104 - desc: "Wraps an output element to generate ephemeral playlists based on the first path segment of each track's URI. Ephemeral items are excluded from storage." 105 105 - - url: "components/orchestrator/process-tracks/element.js" 106 106 - title: "Process Inputs Into Tracks" 107 107 - desc: "Whenever the cached tracks are initially loaded through the passed output element it will list tracks by using the passed input element. Afterwards it loops over all tracks and checks if metadata needs to be fetched. If anything has changed, it'll pass the results to the output element." 108 108 - - url: "components/orchestrator/queue-audio/element.js" 109 109 - title: "Queue ⭤ Audio" 110 110 - desc: "Connects the given queue engine to the given audio engine." 111 111 - - url: "components/orchestrator/scoped-tracks/element.js" 112 112 - title: "Scoped Tracks" 113 113 - desc: "Watches the given output's tracks collection and runs them through a built-in search index. Can perform a search and other ways to reduce the scope of tracks based on the given scope engine. Provides a tracks signal similar to output.tracks.collection." 114 114 - - url: "components/orchestrator/scrobble-audio/element.js" 115 115 - title: "Scrobble ⭤ Audio" 116 116 - desc: "Connects the audio engine with a scrobbler element. Calls nowPlaying when a track starts playing and scrobble once the user has listened long enough." 117 117 - - url: "components/orchestrator/sources/element.js" 118 118 - title: "Sources" 119 119 - desc: "Monitor tracks from the given output to form a list of sources based on the input's sources return value." 120 120 - 121 121 - output: 122 122 - - url: "components/output/polymorphic/indexed-db/element.js" 123 123 - title: "Polymorphic / IndexedDB" 124 124 - desc: "Stores output into the local indexedDB. Supports any type of data that indexedDB supports." 125 125 - - url: "components/output/bytes/s3/element.js" 126 126 - title: "Bytes / S3" 127 127 - desc: "Store output data on AWS S3 or compatible services such as Cloudflare R2." 128 128 - - url: "components/output/raw/atproto/element.js" 129 129 - title: "Raw / AT Protocol" 130 130 - desc: "Store your user data on the storage associated with your ATProtocol identity. Data is lexicon shaped by default so this element takes in that data directly without any transformations." 131 131 - 132 132 - supplements: 133 133 - - url: "components/supplement/last.fm/element.js" 134 134 - title: "Last.fm Scrobbler" 135 135 - desc: "Scrobbles track plays to Last.fm." 136 136 - - url: "components/supplement/listenbrainz/element.js" 137 137 - title: "ListenBrainz Scrobbler" 138 138 - desc: "Scrobbles track plays to ListenBrainz." 139 139 - todo: true 140 140 - - url: "components/supplement/rocksky/element.js" 141 141 - title: "Rocksky Scrobbler" 142 142 - desc: "Scrobbles track plays to Rocksky." 143 143 - todo: true 144 144 - 145 145 - transformers: 146 146 - - url: "components/transformer/output/bytes/automerge/element.js" 147 147 - title: "Output / Bytes / Automerge" 148 148 - desc: "Translate data to and from an Automerge CRDT." 149 149 - todo: true 150 150 - - url: "components/transformer/output/bytes/dasl-sync/element.js" 151 151 - title: "Output / Bytes / DASL Sync" 152 152 - desc: "Syncs data between local and remote using CID-based diffing and performs union merges with tombstone tracking when both sides have diverged." 153 153 - - url: "components/transformer/output/bytes/json/element.js" 154 154 - title: "Output / Bytes / JSON" 155 155 - desc: "Raw data schema output to and from JSON Uint8Array." 156 156 - - url: "components/transformer/output/raw/atproto-sync/element.js" 157 157 - title: "Output / Raw / AT Protocol Sync" 158 158 - desc: "Wraps an AT Protocol output with a local IndexedDB cache. Uses the repo revision to skip unnecessary fetches and performs union merges with tombstone tracking when both local and remote have diverged." 159 159 - - url: "components/transformer/output/refiner/default/element.js" 160 160 - title: "Output / Refiner / Default" 161 161 - desc: "Removes output state that is not meant to be saved to storage, such as ephemeral tracks. Ideally part of every theme." 162 162 - - url: "components/transformer/output/refiner/initial-contents/element.js" 163 163 - title: "Output / Refiner / Initial Contents" 164 164 - desc: "Sets the initial contents for an output on first load." 165 165 - - url: "components/transformer/output/refiner/passkey-encryption/element.js" 166 166 - title: "Output / Refiner / Track URI Passkey" 167 167 - desc: "Encrypts track URIs using a passkey-derived PRF key. On read, decrypts encrypted:// URIs transparently; on write, re-encrypts all URIs before passing downstream." 168 168 - - url: "components/transformer/output/string/json/element.js" 169 169 - title: "Output / String / JSON" 170 170 - desc: "Raw data schema output to and from JSON UTF8 string." 171 171 - 172 172 - definitions: 173 173 - - title: "Output / Collaboration" 174 174 - desc: "Represents a collaboration between multiple collaborators on a subject, such as a playlist." 175 175 - url: "definitions/output/collaboration.json" 176 176 - - title: "Output / Facet" 177 177 - desc: "Facet pointer or HTML snippet." 178 178 - url: "definitions/output/facet.json" 179 179 - - title: "Output / Playlist Item" 180 180 - desc: "Represents a single item in a playlist. Tracks are matched based on the given criteria. A playlist is formed by grouping items by their playlist property." 181 181 - url: "definitions/output/playlistItem.json" 182 182 - - title: "Output / Progress" 183 183 - desc: "Used to track progress of (long) audio playback." 184 184 - todo: true 185 185 - - title: "Output / Track" 186 186 - desc: "Represents audio that can be played, or a placeholder for a source of tracks. Contains a URI that will resolve to the audio." 187 187 - url: "definitions/output/track.json" 188 188 - - title: "Output / Track Bundle" 189 189 - desc: "A bundle of tracks." 190 190 - url: "definitions/output/trackBundle.json"

-14

src/_data/elements/sources.js

reviewed

··· 1 1 - import { walk } from "@std/fs/walk"; 2 2 - 3 3 - const srcDir = new URL("../../", import.meta.url).pathname; 4 4 - const sources = {}; 5 5 - 6 6 - for await ( 7 7 - const entry of walk(srcDir + "components", { match: [/element\.js$/] }) 8 8 - ) { 9 9 - const content = await Deno.readTextFile(entry.path); 10 10 - const key = entry.path.slice(srcDir.length); 11 11 - sources[key] = content; 12 12 - } 13 13 - 14 14 - export default sources;