Skip to content

Sources ​

Sources let the desktop app import from places other than your own disks: sites and services where your recordings live.

Local Files ​

Local Files is always first in the Sources panel. It shows your home folder and every disk, like a file manager. You cannot remove it.

Sources and source types ​

A source type is a small program that knows one kind of place — a video site, a podcast service, a media server. A source is one you set up from it, with your own settings: "Lecture channel", "Podcast feed". You can make several sources from one source type.

To add one, choose Add a source… in the Sources panel, pick the source type, and fill in its settings. Each source has two settings of Orbuzo's own:

SettingWhat it does
Save files tothe folder where this source's downloads go. By default a folder in your user data folder.
Delete files after they are importedoff by default. Turn it on to keep the folder small.

Browsing and downloading ​

Open a source to browse it like a folder. Files carry the same CC, STT and TXT marks as in Local Files. A small check mark means the file is already downloaded; a book means it is already in your library.

When you import a file from a source, the app downloads it into the source's folder first. Those files are yours, like anything in your Downloads folder: Orbuzo does not upload the folder, and removing a source leaves the files where they are.

Installing a source type ​

A source type is a folder inside source-types/, next to Orbuzo.exe. Copy the folder in, then choose Add a source…: the app finds it. A source type that cannot start is still listed, greyed, with the reason.

Only install source types you trust

Today a source type runs as you do, like any program you start. Orbuzo's rules forbid it from touching your files, and the protocol gives it no way to need them — but nothing on the computer enforces that yet.

Want to build one? Read the developer guide.