ticky / psp-radio

📻 SDK shim & emulation layer for the PlayStation Portable’s Radio player API

PSP Radio Emulator

A from-scratch implementation of the PSP Internet Radio player API, allowing the players to be used in a modern web browser.

What?!

The PSP, in firmware update 3.80, added support for Internet Radio players.

Sony provided a handful of players of their on, some of them mundane, and some of them quite novel. They generally tune to internet radio streams from Shoutcast or Icecast's registries.

The players actually run within the PSP's NetFront internet browser, but in a special mode where they're allowed to embed an application/x-psp-extplugin object, which then provides DOM methods for interacting with a non-JavaScript radio player implementation.

This project constitutes a reimplementation of the application/x-psp-extplugin's API in JavaScript, along with a wrapper for running and interacting with the radio players themselves. the ultimate shape of the wrapper is still to be determined, but whilst it is possible to run within a web browser, it imposes several limitations the original did not have.

How?

The radio players, at this stage, must be patched to embed the project's shim code. This is less of a problem now that Sony's original catalogue is down (Internet Archive link for your convenience)!

From there, we attach ourselves to the document in a few ways;

1. Pretending the browser has the application/x-psp-extplugin plugin available
2. Searching the document for any elements with an id, but no name, and copying the id value to the name so they become named properties of the document object
3. Setting a global psp variable, which tricks some of the PSP's players into not actually embedding their application/x-psp-extplugin plugins, but just using that reference

Then, within the psp object, we keep a bunch of state and audio objects, so that we can respond to the players' requests to open streams and fetch data over HTTP. We also proxt HTTP requests via a cors proxy, as the Shoutcast and Icecast lookup APIs would otherwise be inaccesible to the web browser.

Finally, because web browsers' audio players do not expose any script-side access to the icy or other metadata from a Shoutcast stream, there is a method for polling a poorly-documented, and unfortunately poorly-supported metadata endpoint supported by some Shoutcast and Icecast servers.

What works? What's missing?

• Loading Sony's players
  • SCE HTTP request API, rebuilt atop fetch
  • SCE String manipulation API, made no-op as UTF-8 conversion is not necessary
  • Streaming a radio station
  • Reading radio station metadata (Flaky)
  • Starting audio playback in Safari (with "allow all auto-play" set for the domain)
  • Starting audio playback in Firefox/Edge/Chrome (don't support the pls format, do seem to support MPEG streams, maybe conversion is possible?)
• Full audio pipeline
  • Audio effects
  • Noise, sound effect and wave generator functions
    • Morse code generator in sine wave oscillator (I am not joking!)
  • Gain controls
  • Audio peak meter functions
• Finalised UI
  • Determining if the audio pipeline is feasible on the web

psp-radio's Issues

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Warning

These dependencies are deprecated:

Datasource	Name	Replacement PR?
npm	parcel-bundler

Edited/Blocked

These updates have been manually edited so Renovate will no longer make changes. To discard all commits and start over, click on a checkbox.

• Update dependency parcel-bundler to v1.12.5
• Update dependency parcel-plugin-static-files-copy to v2.6.0

Open

These updates have all been created already. Click a checkbox below to force a retry/rebase of any.

• Update dependency gh-pages to v5 [SECURITY]
• Update babel monorepo (@babel/cli, @babel/core, @babel/preset-flow)
• Update dependency entities to v2.2.0
• Update dependency flow-bin to v0.244.0
• Update dependency documentation to v14
• Update dependency entities to v5
• Click on this checkbox to rebase all open PRs at once

Detected dependencies

npm

package.json

psp-radio-api/package.json

• entities ^2.0.0
• pls ^0.1.3
• @babel/cli 7.8.4
• @babel/core 7.9.0
• @babel/preset-flow 7.9.0
• documentation 12.3.0
• flow-bin 0.122.0

psp-radio-web/package.json

• @babel/core 7.9.0
• gh-pages 2.2.0
• parcel-bundler 1.12.4
• parcel-plugin-static-files-copy 2.3.1

---

• Check this box to trigger a request for Renovate to run again on this repository

Investigate WebAudio for effects/gain pipeline

Look into preserving pspradio.co.uk

http://pspradio.co.uk

This one doesn’t load in a desktop browser, even with a spoofed user agent string. Need to check what it does on a real PSP.

Consider swapping `entities` for `he`

https://github.com/mathiasbynens/he

Implement audio playback in Firefox/Edge/Chrome

These browsers don’t support the pls playlist format, where Safari does. They’ll need an explicit pls parser, after which they should handle the references MPEG/AAC streams just fine.

May also require changes to how the metadata URL is stored and retrieved!

Investigate desktop web app wrapping using tauri

https://github.com/tauri-apps/tauri

Look into preserving PSP Ladio

http://pspladio.s335.xrea.com, https://web.archive.org/web/20080101093527/http://pspladio.so.land.to/, https://web.archive.org/web/20130116061617/http://owata.rejec.net/ladio

This one might be tricky, as these players don’t all seem to work in browsers, and at least one seems to have an invalid prs file?

Look into preserving SINPO55555’s pspRX-100

http://SINPO55555.com/psp/pspRX-100/index.cgi

Also fails to load in a desktop browser. Needs further investigation on a real PSP.

Investigate implementing actual icy metadata parsing

• https://github.com/TooTallNate/node-icy
• https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API ?
• https://serviceworke.rs/render-store_service-worker_doc.html