[Feature Request]: Document and extend the freetube:// protocol

[pakoito]

Guidelines

• [X] I have searched the issue tracker for open and closed issues that are similar to the feature request I want to file, without success.
• [X] I have searched the documentation for information that matches the description of the feature request I want to file, without success.
• [X] This issue contains only one feature request.

Problem Description

I would like to build interactions with the Freetube app from the browser. For that I need to understand how the freetube:// protocol works, and have some capabilities available such as "open request in a new window".

Proposed Solution

Add a section in the documentation with the protocol and API parameters allowed, i.e. youtube searches become regular searches within the app, and youtube urls open the video directly. Extend those parameters.

Alternatives Considered

I have read the code and there is no documentation available.

Issue Labels

support for external software

Additional Information

This is my use case: https://github.com/pakoito/freetube-forwarder/

[absidue]

The freetube:// protocol takes full YouTube URLs, just append freetube:// to the start of a YouTube URL (freetube://https://youtube.com/@YouTube and it will open that URL. So for searches just format the URL the same as YouTube does when you do a search (make sure to url encode the query parameters so that it is actually a valid URL).

If you want to see how to use it, you could always look at the code of all of the existing browser extensions that redirect to FreeTube, like the ones mentioned in the README.

[absidue]

and have some capabilities available such as "open request in a new window".

Things like that should be in-app settings, not something that is handled via the URL scheme and is already requested here: #1501

[absidue]

As this feature request now only covers documenting the URL scheme, please open an issue on the docs repo for it.