User Guide

Everything you need to manage your home library

Contents

Getting started — registration and login

For new users

  1. Click Register in the top right corner.
  2. Enter your email address and choose a password (at least 8 characters).
  3. A confirmation email will be sent to you — click the link in it.
  4. After confirmation, log in and start building your library.
Tip: Before registering, you can explore the app without any commitment — click Demo on the home page.

Click Login in the top right corner and enter your email address and password.

Forgot your password? Click Forgot password? below the login form and enter your email address. You will receive a message with a reset link.

You can only log in with your email address, not with your library name.

The demo lets you try all features without registering. It contains sample books and loans.

Note: The demo library is public — all changes are visible to all visitors. Do not enter personal data.

Dashboard

Library overview

The dashboard is your central overview of the library. When you log in, you are immediately greeted by four cards:

Total books

The total number of books in your collection.

Active loans

Books currently on loan.

Completed loans

All returned books over time.

Uncategorised books

Books without an assigned category. Click to categorise with AI.

Below the cards is your book list — sortable by date, title, or author, and filterable by status (available / on loan). Each book has edit and delete buttons.

At the bottom of the page all active loans are shown with the borrower's name, due date, and a button to mark the loan as returned.

Adding books

Three methods

Add a book by clicking Add book in the top navigation. Three methods are available:

By ISBN

Enter the 13-digit ISBN number — details are automatically imported from Google Books.

By COBISS ID

For Slovenian books: enter the COBISS ID and details are imported from the COBISS library system.

Manually

Fill in the form yourself — title is the only required field.

Form fields
FieldDescription
Title *Required — the only condition for saving a book.
AuthorFirst and last name of the author.
YearYear of publication.
ISBNInternational book number (10 or 13 digits).
COBISS IDIdentifier in the Slovenian library system.
Call numberYour shelf location code (e.g. A-12, shelf 2).
CategorySelect or type — supports search by name.
NotesPrivate notes (condition, special features…).
Additional infoFree field for UDC code, series, material type, etc.
Tip: On a mobile phone the fastest method is barcode scanning — see the Scanning section below.

Scanning

Fastest entry

Scanning is the fastest way to add books — ideal for entering a large number of books with your phone. Access it via Tools → Scan in the navigation.

How it works
1
The camera opens automatically — point it at the barcode (EAN-13) on the back of the book. When detected, you hear a beep and the app reads the code automatically.
2
No barcode? — Click No barcode and photograph the colophon page (the page with ISBN details). The system will use OCR technology to read the ISBN or COBISS ID from the photo.
3
Successfully detected — the code is saved as a pending scan. The camera automatically restarts for the next book.
4
Finishing up — when you view your pending scans ( in the navigation), click on each scan and the book details are automatically imported. Review and save.
Mobile only: Video camera scanning works only in browsers that support the BarcodeDetector API (Chrome on Android, Safari on iOS).
Daily OCR limit: Photo scanning (OCR) is limited to a certain number of scans per day, shown on the page.

Editing and deleting books

Managing your collection

In the dashboard or on the book page, click the pencil icon . The same form as when adding opens — change what you want and click Save.

On the book detail page (click the title) you can see all details, loan history, and edit/delete buttons.

If new data is available for your book (updated cover images, descriptions), a icon with a badge appears in the navigation. Click it to review and confirm updates.

Click the trash icon . A confirmation dialog opens — deletion is permanent and includes the entire loan history for that book.

A book currently on loan cannot be deleted — mark it as returned first.

Categories

Organising your collection

Categories help you organise your collection. Each user has their own list of categories, which you build to your own liking.

Go to Tools → Categories. Each category has:

  • Code (optional) — e.g. UDC notation (82-31, 087.5…)
  • Description — the category name (e.g. Novel, Children's literature, Cookbooks)

You can also import categories from a CSV file — see the Import / Export section.

If you have uncategorised books, AI (Claude) automatically assigns categories based on title, author, and description.

Two categorisation modes:

  • Interactive (Tools → Bulk categorise) — AI suggests a category for each book individually; you confirm or change it.
  • Bulk — AI categorises all uncategorised books in batches of 100, without individual confirmation. Suitable for large collections.
AI categorisation requires at least 5 categories in your list — AI picks the most suitable one based on your categories.

Have too many similar categories (e.g. Novels and Novel)? With Tools → Merge categories you select the categories you want to retire and specify where each book should be moved. AI suggests the most appropriate target categories.

Borrowing and returns

Loan tracking

  1. Open the book page (click the title in the dashboard).
  2. Click the Lend button.
  3. Enter the borrower's name and at least an email or phone number.
  4. Set the loan date and due date, then save.
When you confirm the loan, you will receive an email notification with the loan details.

When a book is returned, click Mark as returned in the dashboard (under the Loaned books section) or on the book detail page.

The loan moves to history — you can see it on each book's page under the Loan history section.

Overdue loans are highlighted in red in the dashboard and shown at the top of the list.

The system automatically sends email reminders for loans that have passed their due date — you don't need to do anything.

Public library

Sharing with others

Every library has a public page accessible without logging in. Share it with friends, your community, or embed the link on a website.

Setting up your public profile

In your Profile you can set:

  • Library name — displayed on the public page instead of your email.
  • URL address (slug) — e.g. mojaknjiznica.com/your-library. Choose a short, simple name without spaces.
  • Library description — a short description visible to visitors.
  • Contact details — email, phone, address (optional).
  • Library photo — a picture of your space.

You can find the link to your public library in the dashboard via the Share library button.

All public libraries are accessible on the All libraries page in the navigation — great for communities and neighbour book exchanges.

Search books

Quick search

The Search books page (button in the navigation) lets you search your own collection or all public libraries at once.

  • You can search by title, author, ISBN or any other field.
  • Filter results by category or status (available / on loan).
  • The All libraries toggle expands the search to all public libraries — useful when looking for a book at a neighbour's.
Search also works without logging in — try it on the Search books page in the top navigation.

Profile and settings

Your account

Access your profile by clicking on your library name in the top right corner → Profile.

Password: Enter your current password and your new password twice. The password must be at least 8 characters.

Email: Enter a new address — you will receive a confirmation link which you must click for the change to take effect.

Colour theme: Choose from three themes — brown (default), green, or navy. The theme is saved to your account.

Language: The app is available in Slovenian, English, German, and Italian. Logged-in users change the language in their profile.

Import and export

CSV files

In the dashboard click the Export CSV button. You download a file with all your books that you can open in Excel or Google Sheets.

In your Profile find the Import books (CSV) section. To import:

  1. Download the CSV template and open it in Excel.
  2. Fill in the data — the only required field is title.
  3. Save the file and upload it.
  4. Choose the import mode: add all / skip duplicates / update existing.
The Clear library before import option permanently deletes all existing books. Use with caution!

On the Tools → Categories page there is an import button. File format: each line contains code;description (code is optional). Lines starting with # are comments.

Example: 82-31;Novel, 087.5;Children's literature, ;Uncategorised

Duplicates

Cleaning up your collection

The Tools → Duplicates tool shows books that appear more than once in your collection (same ISBN or same title + author).

In the dashboard, duplicates are marked with a grey badge showing the number of copies (e.g. 3×). Clicking the badge takes you to the duplicates page.

Duplicates are not necessarily an error — you may genuinely own multiple copies of the same book. The tool only shows suspicious matches; the decision is yours.
Still have questions?

Try the demo library or contact us.

Demo library Register