# Read lists

Read lists let you gather related books together. Think of it as playlists, but for books. For example, you might add all the books where Wolverine appears together in a "Wolverine" read list.

# Adding books to a read list

You can add a Book to a read list from the action menu icon and click on Add to read list.

You can also select multiple books, and click on Add to read list.

A dialog will show up, where you can either add books to an existing read list, or create a new read list.

# Finding the Read Lists

Read lists can be discovered or viewed in three ways:

  1. Book details screen
  2. Viewing the libraries "By Read List"
  3. Searching in the search bar

# Book details screen

When viewing the details screen for a specific book that belongs to a read list, the read list will be displayed in a collapsible panel.

Click on the panel to expand it and see the content of the read list.

# Viewing the libraries "By Read List"

Only show read lists that exist in the library. Opening a read list goes to the "read list details" screen (see below).

# Read List details

The read list details screen contains all the books that belong to the read list. It can include books from any library and any series. By adding items in different libraries or series to read lists, you can relate them to each other.

# Edit read list elements

From the read list details screen you can edit the elements composing a read list. To do so, click on the corresponding button in the toolbar.

The book cards will show two extra elements:

  • a delete button, to remove the book from the read list
  • a grip handle, which let you drag and drop books to reorder them

Once you are done with your changes, click the tick in the top bar. Click the cross to discard your changes.

# Deleting a read list

To delete a read list, look for the action menu icon and click on Delete.

This will not delete the items in the read list, nor your media files.

# Import read lists from ComicRack

You can import ComicRack reading lists in .cbl format from the Import > Read Lists screen.

Select multiple files to import them all at once.

.cbl files contain the following information:

  • read list name
  • books contained in the list, in order
  • for each book:
    • name of the series it is part of
    • volume of the series
    • year of the series
    • number of that book in the series

Komga will try to match each book in the list in the following way:

  • check if a read list with that name already exists
  • since Komga does not have a volume metadata field, it will apply the same transformation as when importing data from ComicInfo.xml
  • it will try to find a unique series by name
  • if a unique series is found, it will try to find a unique book in that series by book number
  • if a unique book is found, it will be added to the read list

The result will be shown after you click the Import button.

For each provided file you can see whether the import succeeded fully, partially, or failed. You can also expand the panel to get more details on why the import failed for each book.