invidilink v0.4.0

youtube invidious url rewrite

Provide a youtube url and the app will query the invidious instance list for a currently working instance and provide a rewritten url

Works in Node.js.

Node will make a http request to the invidious instance list, parse the response, evaluate the server's stats and rewrite the url.

Install

$ git clone git@github.com:ktleary/youtube-invidious-url-rewrite.git

Example Usage

const { youtubeReplace } = require('./index');
async function main() {
	const ytUrl = 'https://www.youtube.com/watch?v=AdNJ3fydeao';
	const invidiousApiUrl = 'https://instances.invidio.us/instances.json';
	const invidiousUrl = await youtubeReplace(ytUrl, invidiousApiUrl);
	console.log(Invidious URL: ${invidiousUrl});
	return invidiousUrl;
}

API

youtubeReplace(ytUrl, instancesUrl?)

Returns a Promise<string> which is the rewritten url if any healthy instances are located.

ytUrl

Type: string | string[]

A valid YouTube URL.

instancesUrl

Type: string

It defaults to https://instances.invidio.us/instances.json if none is supplied.