Contextual Actions

In Kavita, there are many different actions you can take on different entities. This page covers the different actions you can take.

Downloading

If a user has the Download role, they can download files from Kavita. Because Kavita uses a grouping mechanic, the downloads will mimic this structure. From any Series, Volume, or Chapter, a user can kick off a download via the context menu. If the underlying file is just one individual file, it will be sent as is, otherwise, the files will be grouped in a zip and downloaded.

Downloads may take longer than expected to process. Kavita will show a spinner on the item you are attempting to download from.

downloads

Bookmarks

Bookmarks are pages that you want to download after reading for a given series. While using the web reader, you can bookmark certain pages using the bookmark button on the top right. This will save a reference to that page for the given series. At any point in the future, you can use the Series detail context action to open the bookmarks modal for that series. This will give you the option to download all bookmarks in a zip file or delete all references to the bookmarks. You can also view all bookmarks for your account in your User Settings.

bookmark%20modal%20series

Info Modal

Kavita has grouping which sometimes can be confusing, did a file get grouped properly? How can I check? This is where the Info modal comes from. From a Volume/Chapter, use the context actions menu to select Info. From Series detail, you must be an admin and can use the Edit button.

Volume Info

volume%20modal

The volume info has some extra functionality. First, as you can see, we have individual chapters that are grouped into one virtual volume. When reading, you can jump chapter to chapter, but what if you want to re-read chapter 2? This screen will let you by clicking the cover image, which will open the reader directly on that chapter. Likewise, what if you've already read chapters 1-4 and want to quickly mark them as read? Using the context action button next to the Chapter title, you can now:

  • Mark as Read
  • Mark as Unread
  • Download

From this screen, you can also update the cover image for the volume if you are an admin. See the section below for more information.

Series Info

series%20modal

Overriding Cover Images

As mentioned in Scanning and Refreshing Metadata, Kavita handles generating cover images based on a set of rules. However, if you want total control or want a different image without having to update the actual file, you can now do that with the new cover image chooser screen. This screen can be found in the Volume Info, Series Info and Edit Collection modals.

cover%20image%20original

The cover image chooser allows you to upload a custom image via a URL or a png/jpg on your computer. Once you upload the file and click Save, the image will be applied and instantly reflected on the UI. On the next visit to this screen, there will be a "Reset" button that can be clicked to undo the overridden image and on the next scan Series Refresh, the image will be updated from the file, like it once was originally.

cover%20image%20after

Note: Using the URL image loader is not a sure thing. To avoid any security issues, image loading is done in browser. Some sites may reject the image load, some urls may not return.

If a custom cover image has been set, it will not be overridden by file scans. The only way to change is to manually change the image or use the reset button.

Incognito Reading

Volume and chapters offer the ability to read without saving your progress. This is great for if you want to read a few pages before committing to a new series. By using "Read in Incognito", the reader will not report any progress.

Reading List

From any Series, Volume, or Chapter, you can add said item to a reading list. All the chapters of that entity will be added to the reading list. A reading list is an ordered list of chapters that can be of mixed media types. Admin's can promote reading lists so all users can see them, but not edit them. Otherwise, reading lists are per-user.

Users can read through in one go a reading list and the readers will transition between the different readers. For example you can have Manga -> Manga -> Book -> Manga and you can read that without closing the reader. The order can be manipulated via drag and drop or by using input boxes on right hand side to manually adjust the position. Position changes save automatically. Lastly, if you are using a reading list to track new chapters added to your server and want to quickly clear it out when you've gone through them, there is a "Remove Read" button which will remove any fully read chapters from the list.

list%20view

Multi-Selection

Some context actions can be triggered in bulk, like adding to a reading list or marking something read/unread. To trigger multiple items as read, you can click the checkbox on the top left of the card item. When that happens the bulk selection bar will show at the top of the screen. You can use this bar to perform said operations. On PC, you can hold shift to select multiple cards in one go.

multi-select