:tocdepth: 3 ********************** Mopidy-InternetArchive ********************** Mopidy-InternetArchive is a Mopidy_ extension for playing music from the `Internet Archive`_. This extension lets you search for and stream recordings ranging from `alternative news programming`_, to `Grateful Dead concerts`_, to `Old Time Radio shows`_, to `book and poetry readings`_, to `original music`_ uploaded by Internet Archive users. It also gives you access to a vast number of high-quality live recordings from the `Live Music Archive`_, and thousands of free audiobooks from the LibriVox_ collection. Browsing the Internet Archive ============================= If your Mopidy client supports browsing, there should be a top-level directory named *Internet Archive*. Beneath that, you will find the Internet Archive collections listed in :confval:`collections`, and you should be able to browse individual audio items (albums) and files (tracks) within these. For practical and performance reasons, the number of items that will be shown within a collection is limited, e.g. you will not see all 167,967 audio items of the Live Music Archive [#footnote1]_. The :ref:`default configuration ` sets this limit to 100, but this can be changed using :confval:`browse_limit`. To allow browsing collections using different sort criteria, every collection provides a number of *views*, virtual subdirectories which let you browse the collection's items by popularity, title, publish date, and so on. The default views are set up to resemble the archive.org_ Web interface, but can be changed at your own discretion with :confval:`browse_views`. Searching the Internet Archive ============================== The Internet Archive only supports searching for *items*, but not for individual files or tracks. Therefore, only *albums* will show up when searching in Mopidy. This also means that only album-related search fields are supported, so searching for track names or numbers will yield no results from the Internet Archive. The number and ordering of search results returned from the Internet Archive can be changed with :confval:`search_limit` and :confval:`search_order`. Unless you explicitly specify an Internet Archive collection to search within, search scope will also be limited to the collections listed in :confval:`collections`. Archive Favorites ================= If you have an Internet Archive account - also termed a `Virtual Library Card`_ - you can access your `Archive Favorites`_ from Mopidy. To do so, you just need to add the identifier of your favorites collection to :confval:`collections`. Typically, the identifier is *fav-{username}*, but you should be able to figure it out from the archive.org_ Web site. When added to :confval:`collections`, you will be able to browse and search your Archive Favorites just like the other collections listed there. ************* Configuration ************* This extension has a number of configuration values that can be tweaked. However, the :ref:`default configuration ` contains everything to get you up and running, and will usually require only a few modifications to match personal preferences. .. _confvals: Configuration Values ==================== .. confval:: enabled Whether this extension should be enabled or not. .. confval:: base_url Base URL to access the Internet Archive. .. confval:: collections A list of collection identifiers to show as top-level directories when browsing. These are also used to limit the search scope when no search base is given by Mopidy clients explicitly. .. confval:: audio_formats A list of audio file formats, in order of preference. This entry contains a list of `Internet Archive file formats`_. By default, only audio formats suitable for streaming are requested. Note that the Internet Archive also contains a large number of high-quality media files in FLAC_ and other lossless formats, but for sake of bandwidth (both your's and the Archive's), it is recommended that you stick to lossy audio formats for streaming through Mopidy. .. confval:: image_formats A list of image file formats, in order of preference. This entry contains a list of `Internet Archive file formats`_ to be considered when providing images for Internet Archive items. Note that some Mopidy clients, especially MPD clients, will ignore album art provided by Mopidy-InternetArchive or other Mopidy extensions. .. confval:: browse_limit The maximum number of browse results. This is used to limit the number of items returned when browsing the Internet Archive. .. confval:: browse_views When browsing Internet Archive collections (or *directories* in Mopidy), this provides a list of virtual subdirectories so results can be retrieved using a particular :ref:`sort order`. The format for each entry is `` (asc|desc) |