25:["$","title",null,{"children":"LC IIIF A/V Sandbox | marii | Observable"}] 4b:T55f,# LC IIIF A/V Sandbox ## Objective: Grab any direct MP3 or MP4 link from LC items with online availability, get the item ID, IIIF info.json URL, and IIIF MP3/MP4 URL See: https://www.loc.gov/apis/micro-services/streaming-services/
Status October 2026: - Works for MP3s! (info.json + IIIF MP3 direct route, but missing temporal region + other IIIF params support) - Works for *some* MP4s (info.json + some IIIF MP4 routes with hardcoded size + other params; See "Gay and proud" and "Launch of surf boat" below) - Need to understand/troubleshoot temporal region params (MP3 and MP4) - Need to understand/troubleshoot MP4 patterns - Want to try getting IIIF MP3 derivatives from MP4 resources

## Step 1: Find an A/V resource - Head to https://www.loc.gov/search/?fa=online-format:audio to look for audio and/or https://www.loc.gov/search/?fa=online-format:video to look for video. - When you find an item you like, look for the "Download - MP3" or "Download - MP4" button. This will take you to the resource directly. - Copy the URL for the resource, e.g., `https://tile.loc.gov/storage-services/service/afc/afc2020008/afc2020008_021/afc2020008_021_sr01.mp3` *NOTE: Not finding anything? You can also copy a "Storage" or "IIIF service URL" from the table below.*
4c:Te45,const examples = [ { title: "Day in the Life of the Plaza - Soundscape 10AM-12PM", record: "https://www.loc.gov/item/afc2023002_002/", type: "MP3", storage: "https://tile.loc.gov/storage-services/service/afc/afc2023002/afc2023002_002/afc2023002_002_sr001/afc2023002_002_sr001.mp3", notes: "Works except if region info is added." }, { title: "Day in the Life of the Plaza - Soundscape 4-6PM", record: "https://www.loc.gov/item/afc2023002_003/", type: "MP3", storage: "https://tile.loc.gov/storage-services/service/afc/afc2023002/afc2023002_003/afc2023002_003_sr001/afc2023002_003_sr001.mp3", notes: "Works except if region info is added." }, { title: "Ramadan - Eid al-Fitr", record: "https://www.loc.gov/item/afc2023002_056/", type: "MP3", storage: "https://tile.loc.gov/storage-services/service/afc/afc2023002/afc2023002_056/afc2023002_056_sr001/afc2023002_056_sr001.mp3", notes: "Works except if region info is added." }, { title: "Field recording of Lehigh Cement Company, 2021-05-26", record: "https://www.loc.gov/item/2021655357/", type: "MP3", storage: "https://tile.loc.gov/storage-services/service/afc/afc2020008/afc2020008_021/afc2020008_021_sr01.mp3", iiif: null, notes: "Works except if region info is added." }, { title: "Songs and calls of our native birds, no. 4", record: "https://www.loc.gov/item/jukebox-12231/", type: "MP3", storage: null, iiif: "https://tile.loc.gov/streaming-services/iiif/service:mbrsrs:mbrsjukebox:dlc_victor_17735_01_b15648_01:dlc_victor_17735_01_b15648_01/full/full/0/full/default.mp3", notes: "Record has the IIIF MP3 link by default. Works except if region info is added." }, { title: "Lunar New Years Pageant, Wat Temple Grounds, Friday Night", record: "https://www.loc.gov/item/afc2022010_027_mv001/", type: "MP4", storage: "https://tile.loc.gov/storage-services/service/afc/afc2022010/afc2022010_027/afc2022010_027_mv001.mp4", iiif: null, notes: "info.json works, IIIF A/V MP4 does not." }, { title: "Gay and proud", record: "https://www.loc.gov/item/2024603228", type: "MP4", storage: "https://tile.loc.gov/storage-services/service/mbrs/ntscrm/01991430/01991430.mp4", iiif: "https://tile.loc.gov/streaming-services/iiif/service:mbrs:ntscrm:01991430:01991430/full/full/0/35,15/default.mp4", notes: "Starts as IIIF A/V MP4 (from docs). Neither link works if the region/size is changed; only works from the docs verbatim." }, { title: "Launch of surf boat", record: "https://www.loc.gov/item/2014600162", type: "MP4", storage: "https://tile.loc.gov/storage-services/service/mbrs/ntscrm/01203776/01203776.mp4", iiif: "https://tile.loc.gov/streaming-services/iiif/service:mbrs:ntscrm:01203776:01203776/full/,240/0/full/default.mp4", notes: "From docs. Storage and IIIF links work if copied verbatim; breaks if region/size is changed." } ] function link(url, label) { return url ? html`${label}` : html`n/a`; } display(Inputs.table(examples, { columns: ["title", "record", "type", "storage", "iiif", "notes"], header: { title: "Title", record: "Item URL", type: "Type", storage: "Storage service URL", iiif: "IIIF service URL", notes: "Notes" }, format: { record: (url) => link(url, url), storage: (url) => link(url, url), iiif: (url) => link(url, url) }, width: {title: 250, record: 70, type: 50, storage: 80, iiif: 70, notes: 420}, required: false }));4d:T4e3,function getIdFromMpUrl(mpUrl) { return mpUrl .replace("https://tile.loc.gov/streaming-services/iiif/", "") .replace("https://tile.loc.gov/storage-services/", "") .replace(/\/full.*?\/default/, "") .replace(/\.mp[34]$/i, "") .replace(/\//g, ":"); } function getIiifJsonFromId(iiifId) { const server = "https://tile.loc.gov"; const servicePrefix = "streaming-services/iiif"; const endpoint = 'info.json' return [server, servicePrefix, iiifId, endpoint].join("/"); } function getIiifAvResourceFromJson(iiifJson, temporalRegion="full", ext="mp3") { if (ext == "mp3") { return iiifJson.replace('info.json', `full/full/0/${temporalRegion}/default.mp3`); } else { return iiifJson.replace('info.json', 'full/,240/0/full/default.mp4') } } function getIiifAvResourceFromMpUrl(mpURL, temporalRegion="full", ext="mp3") { return getIiifAvResourceFromJson(getIiifJsonFromId(getIdFromMpUrl(mpURL)), temporalRegion, ext); } const iiifId = getIdFromMpUrl(mpUrl); const ext = mpUrl.toLowerCase().endsWith("mp4") ? "mp4" : "mp3"; const iiifJson = getIiifJsonFromId(iiifId); const iiifAvResource = getIiifAvResourceFromMpUrl(mpUrl, temporalRegion, ext); display([iiifId, ext, iiifJson, temporalRegion, iiifAvResource]);4e:[] 47:{"id":"8c2b8000e0eda35d","slug":"lc-iiif-a-v-sandbox","title":"LC IIIF A/V Sandbox","thumbnail":"5166f08e2cc134f31ce381487c2a765c0584528ed834b4a7eaa293b764024078","access_level":"public","create_time":"$D2026-10-07T14:02:14.413Z","update_time":"$D2026-10-09T16:34:41.683Z","view_time":null,"first_public_time":"$D2026-10-07T15:02:29.756Z","has_unpublished_edits":null,"fork":false,"stars":0,"starred":false,"owner":{"type":"team","id":"03c6cf5622638216","login":"marii","name":"marii","avatar_url":"https://avatars-next.observableusercontent.com/d1ccc6bfa34716481dd92b2ca50c29d028e37616c4bfbe4631d3f6ee1f611a12","tier":"free_2026","bio":"","followed_by_you":false,"follows_you":false},"version":374,"publish_version":374,"role":null,"authored":false,"authors":[{"type":"individual","id":"de05d5a26ac95307","login":"marii","name":"marii","avatar_url":"https://avatars-next.observableusercontent.com/d1ccc6bfa34716481dd92b2ca50c29d028e37616c4bfbe4631d3f6ee1f611a12","tier":null,"bio":"","followed_by_you":false,"follows_you":false}],"members":[{"type":"team","id":"03c6cf5622638216","login":"marii","name":"marii","avatar_url":"https://avatars-next.observableusercontent.com/d1ccc6bfa34716481dd92b2ca50c29d028e37616c4bfbe4631d3f6ee1f611a12","tier":"free_2026","role":"editor"}],"comments":[],"custom_thumbnail":false,"trashed":false,"lapsed":null,"subscribed":null,"forks":0,"collection":null,"type":"notebook","body":{"titling":"auto","title":"LC IIIF A/V Sandbox","cells":[{"id":1,"value":"$4b","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":24,"value":"$4c","pinned":false,"hidden":false,"mode":"ts","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":25,"value":"

\n## Step 2: Test it Out\n\n- Paste the MP3 or MP4 URL into the \"LC MP3 or MP4 URL\" field below and update the parameters below.\n\n*NOTE: params do not currently work reliably! Video sometimes works + audio will not work with updated Temporal Region or other parameters*","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":8,"value":"const mpUrl = view(Inputs.text({\n label: \"LC MP3 or MP4 URL\",\n value: \"https://tile.loc.gov/storage-services/service/afc/afc2023002/afc2023002_003/afc2023002_003_sr001/afc2023002_003_sr001.mp3\",\n width: 600\n}));\n\nconst temporalRegion = view(Inputs.text({\n label: \"WiP! Temporal Region (`,` or `full`)\",\n value: \"full\",\n width: 100\n}));\n\nconst pixelRegion = view(Inputs.text({\n label: \"WiP! Pixel Region\",\n value: \"full\",\n width: 100\n}));\n\nconst size = view(Inputs.text({\n label: \"WiP! Size\",\n value: \"full\",\n width: 100\n}));\n\nconst rotation = view(Inputs.text({\n label: \"WiP! Rotation\",\n value: \"full\",\n width: 100\n}));\n\nconst quality = view(Inputs.text({\n label: \"WiP! Quality\",\n value: \"default\",\n width: 100\n}));","pinned":false,"hidden":false,"mode":"ts","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":21,"value":"

\n## Step 3: View Results!\n\nThe values below will automatically update when you adjust the inputs above. The player at the very bottom will play the `IIIF A/V RESOURCE`.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":16,"value":"$4d","pinned":false,"hidden":false,"mode":"ts","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":27,"value":"

IIIF ID: ${iiifId}
EXT / TYPE: ${ext}
IIIF INFO JSON: ${iiifJson}
IIIF REGION INPUT: ${temporalRegion}
IIIF A/V RESOURCE: \n ${iiifAvResource}\n

","pinned":false,"hidden":false,"mode":"html","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":17,"value":"html`${mpUrl.toLowerCase().endsWith(\".mp4\")\n ? html`\n

`\n : html`\n

`\n}

`","pinned":false,"hidden":false,"mode":"ts","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"}],"files":"$W4e","stdlib":"2"}} 24:null