Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updated library creation guide for 2.4.5 #53

Merged
merged 7 commits into from
Oct 29, 2023
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 42 additions & 0 deletions content/guides/10.rss_feeds.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
---
title: RSS Feeds
slug: rss_feeds
fullpath: /guides/rss_feeds
---

---

# Introduction

This guide discusses the RSS Manager in the server settings.

These RSS feeds are *not* the same as the RSS feeds that are used to automatically download new podcast episodes.

# Creating RSS Feeds

Audiobookshelf allows admins to host audio content from the server through an RSS feed. The following types can be hosted using an RSS feed:
- Library items
- Collections
- Podcasts

Playlists cannot have an associated RSS feed because they are account specific.

To create an RSS feed, select "Open RSS Feed" in the 3-dot dropdown menu.
![Open the feed](/guides/rss_feeds/open_feed.jpg)

You can then change some settings for the RSS feed that you will be hosting. You can set the slug (defaults to the library item ID), whether to prevent the RSS feed from being indexed by web services, and a custom owner name and email.

The URL is created based on how you are accessing your ABS server at the time you create the RSS feed (outlined in red). If you are connected to your local IP, then the RSS feed will only be accessible on your local IP. If you connect using your public domain name, the URL will be set up to use the domain name.
![Feed settings](/guides/rss_feeds/feed_menu.jpg)

You can copy the link displayed in the confirmation modal. You can click anywhere off of the modal to continue using ABS.
![Confirmation modal](/guides/rss_feeds/confirmation.jpg)

# Managing Open RSS Feeds
From the settings, you can access the open RSS Feeds.
The table shows you what audiobooks, collections, and podcasts are currently available through RSS feeds.
Clicking on a row allows an admin to copy the RSS URL for sharing.
Open feeds can be closed from this table as well.

![RSS Feed Manager](/guides/rss_feeds/feed_manager.jpg)

29 changes: 14 additions & 15 deletions content/guides/2.library_creation.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,28 +9,27 @@ fullpath: /guides/library_creation
# Introduction
This guide will help you to create a library in ABS. This guide assumes you have correctly configured your installation.

Screenshots are from an install of v2.2.0 in Docker, but remain mostly unchanged in v2.3.3.
NOTE: If you are using docker, make sure your mounts are set up correctly. If they are not set up correctly, you will lose data at some point in the future. The easiest way to check if they are set up correctly is to add a book to the library any ensure that it shows up in your file system.
advplyr marked this conversation as resolved.
Show resolved Hide resolved

Still confused about Docker? Check out [this FAQ](/faq#im-still-confused-about-what-docker-and-containers-are-and-how-they-work)

# Setting up a library

ABS supports two kinds of libraries: book and podcast. Both kinds of library allow individual items to be added to the library. A podcast library can also download new episodes from an RSS feed automatically.
To create a library file in ABS:
To create a library in ABS:
* Create a library directory for either [audiobooks](https://www.audiobookshelf.org/docs#book-structure) or [podcasts](https://www.audiobookshelf.org/docs#podcast-structure)
advplyr marked this conversation as resolved.
Show resolved Hide resolved
* Go to (1) Settings -> (2) Library -> (3) Add Library. This installation already has two libraries set up (named "Audible" and "Podcasts")
![Add library](/guides/library_setup/add_library.png)
* Set library paths. You can either type the path manually or Browse for Folder. If you have multiple directories where books/podcasts are stored, you can add multiple paths to the library. NOTE: There are issues with the "Browse for Folder" button on some systems, so you may need to enter the path manually if the button is not working.
* Go to (1) Settings -> (2) Library -> (3) Add Library.
![Add library](/guides/library_setup/add_library.jpg)
* Set library paths. You can either type the path manually or Browse for Folder. If you have multiple directories where books/podcasts are stored, you can add multiple paths to the library. You can have multiple paths in the same library. If you are using docker, you should be using the path within the docker container, not the path in your normal file system. NOTE: There are issues with the "Browse for Folder" button on some systems, so you may need to enter the path manually if the button is not working.
advplyr marked this conversation as resolved.
Show resolved Hide resolved
![Add paths](/guides/library_setup/initial_library_creation.gif)
* Modify library settings (you can edit these later)
![Edit settings](/guides/library_setup/details_4.png)
* Modify library settings (you can set this up now or edit the settings later)
![Edit settings](/guides/library_setup/settings.jpg)
* You can also set a schedule to rescan the library for new books or changes. This periodic scan is disabled by default.
advplyr marked this conversation as resolved.
Show resolved Hide resolved
![Periodic scan](/guides/library_setup/schedule_scan.png)
* Once you have created the library, you should see something like this.
![Newly created view](/guides/library_setup/before_scanning.png)
* You can create more libraries to either divide books or add podcasts. If you have multiple libraries, you can switch between them using the button in red. I went ahead and created a podcast library to demonstrate this.
![Added podcasts to switch libraries](/guides/library_setup/switching_libraries.png)
* Now that the library is created, you can scan the library to have books added to the library. You can either do this from the home screen or the settings page. NOTE: this view has changed slightly, with the buttons being located in the dropdown menu of 3 vertical dots.
![Scan from settings](/guides/library_setup/before_scan_settings.png)
![Initial library scan from home](/guides/library_setup/scan_library.gif)
![Periodic scan](/guides/library_setup/schedule_scan.jpg)
* After creating the library, you can scan for items within the library using the "Scan" button or use the dropdown to scan. The library settings can be adjusted from here as well. Additional information on the scanner can be found [here](https://www.audiobookshelf.org/guides/book-scanner).
advplyr marked this conversation as resolved.
Show resolved Hide resolved
![Periodic scan](/guides/library_setup/scan_and_dropdown.jpg)
* You can create more libraries to either divide books or add podcasts. If you have multiple libraries, you can switch between them using the button circled in red.
![Added podcasts to switch libraries](/guides/library_setup/switching_libraries.jpg)

# Conclusion
You should now have a functioning library!
Expand Down
Binary file added static/guides/library_setup/add_library.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed static/guides/library_setup/add_library.png
Binary file not shown.
Binary file removed static/guides/library_setup/before_scan_settings.png
Binary file not shown.
Binary file removed static/guides/library_setup/before_scanning.png
Binary file not shown.
Binary file removed static/guides/library_setup/details_1.png
Binary file not shown.
Binary file removed static/guides/library_setup/details_2.png
Binary file not shown.
Binary file removed static/guides/library_setup/details_3.png
Binary file not shown.
Binary file removed static/guides/library_setup/details_4.png
Binary file not shown.
Binary file added static/guides/library_setup/remove_metadata.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/guides/library_setup/scan_and_dropdown.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/guides/library_setup/scanner_priority.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/guides/library_setup/schedule_scan.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed static/guides/library_setup/schedule_scan.png
Binary file not shown.
Binary file added static/guides/library_setup/settings.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed static/guides/library_setup/switching_libraries.png
Binary file not shown.
Binary file added static/guides/rss_feeds/confirmation.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/guides/rss_feeds/feed_manager.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/guides/rss_feeds/feed_menu.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/guides/rss_feeds/open_feed.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.