verdana

verdana (stylized as "verdana") is a fork of Lucida, as it no longer seems to be maintained. It remains under the OQL as the original author hazycora intended. This fork was specifically made to be used with lucida.to, but can be used in most other environments.

Changes made

• Name change
• Format selection: verdana.getFormatsByUrl(), streamer.getFormats()
  • Dolby Atmos

Planned changes

• Focus less on the individual streaming service and give best priority to the highest quality rip available
• Client selection

Usage

import Verdana from 'verdana'
import Tidal from 'verdana/streamers/tidal/main.js'
import Qobuz from 'verdana/streamers/qobuz/main.js'
import Spotify from 'verdana/streamers/spotify/main.js'

const verdana = new Verdana({
	modules: {
		tidal: new Tidal({
			// tokens
		}),
		qobuz: new Qobuz({
			// tokens
		}),
		spotify: new Spotify({
			// options
		})
		// Any other modules
	},
	logins: {
		qobuz: {
			username: '',
			password: ''
		},
		spotify: {
			username: '',
			password: ''
		}
	}
})

// only needed if using modules which use the logins configuration rather than tokens
await verdana.login()

const track = await verdana.getByUrl('https://tidal.com/browse/track/255207223')

await fs.promises.writeFile('test.flac', (await track.getStream()).stream)

// only needed for modules which create persistent connections (of the built-in modules, this is just Spotify)
await verdana.disconnect()

For using a specific module, you can just use the functions built into the Streamer interface.

Project Structure

src/streamers/{app-name}

main.ts

Default export is a class which implements the Streamer interface:

interface Streamer {
	hostnames: string[]
	search(query: string, limit: number): Promise<SearchResults>
	getByUrl(url: string): Promise<GetByUrlResponse>
}

They can optionally include a login function in this class which takes a username and password (if supported):

async login(username: string, password: string): void

Options for the app, including tokens (if supported by the given app), are passed to the class's constructor:

new StreamerApp({ token: 'secret!' })

The classes can also include their own custom functions. Any function used by verdana's app-agnostic code should be defined in the Streamer interface for compatibility across multiple apps.

parse.ts

Functions for parsing the app's API into the types defined in src/types.ts.

constants.ts

Constants used by main.ts. Secrets should not be defined here (or anywhere else in the project).

src/index.ts

Wraps all the Streamers using a module system. See the usage section.

src/types.ts

Types used across the project. The purpose of many of these is to make sure all apps' functions return the same types so the rest of the logic can work across all apps the same.

Acknowledgements

As stated above, verdana is a fork of Lucida.

Both Lucida and verdana are partially inspired by OrpheusDL, a Python program for music archival which can be used similarly to verdana/Lucida. Some scripts inside verdana/Lucida are modeled after OrpheusDL modules.