guide

how vivliothiki works

vivliothiki is a catalogue of every book on your shelves. All it asks of you is to point your phone’s camera at the barcode on the back of a book: the book catalogues itself, with everything worth knowing — title, author, translator, publisher, cover — in Greek and in every other language. Once your books are scanned, your library is on your phone and on your computer. It works without a signal, and you can share it with the people you live with, as you see fit.

vivliothiki is in a closed test, open by invitation to members of the 241020 Club. The library in these pictures is invented and its covers were drawn for this guide; the screens are the app as it really looks.

1 · getting in

There is no password. Open vivliothiki.com, type the email address your invitation came to and press email me a code. Six digits arrive within a minute — look in spam if they do not. Type them and press sign in. A code works once, for ten minutes; a device stays signed in for a year after you last used it.

The sign-in page: an email field and the button email me a code
The way in. Nothing else on the site is open without an invitation.
The second step: a six-digit code field and the button sign in
The code, from your email.

If you were invited to keep a library of your own, you name it next. If you were added to somebody’s library, its books start arriving on your device, with a bar showing how many are left.

On your phone, make it an app

On an iPhone, in Safari: Share › Add to Home Screen. On Android, in Chrome: ⋮ › Add to Home screen (or Install app). vivliothiki then opens full-screen like any other app, and works with no signal: what you change offline goes up the next time there is one.

An empty library opens on a short welcome with the three ways to add a book, and a line on each part of the app. It goes away with your first book.

The welcome page of an empty library, with three buttons: Scan, Type an ISBN, Add by name

2 · the library at a glance

The library on a computer: the menu on the left, the toolbar at the top, a wall of covers12345678910111213
  1. Library — the library you are looking at. Tap to switch to another, or to add or rename one. You can keep as many as you like — home, office, a summer house.
  2. Library, Stats, Settings — the three places in the app.
  3. Add — scan barcodes, type an ISBN, or add a book by name.
  4. The library in figures: titles, pages, metres of shelf, and its languages.
  5. read and to read — your own marks. Tap one to see only those books. Below them, still need naming (books still waiting for a title) and off the shelves (books that have left your collection).
  6. Lists — tap a list to see its books; Manage goes to Settings.
  7. Search — any word of a title, author, publisher, series, subject, ISBN, note or shelf. Accents and capitals do not matter. On a computer, / jumps here.
  8. Showcase — one book at a time, at random: a way of wandering through your own collection.
  9. Sort — by title, author, publisher, year, length, date added, shelf, language, or whether you have read them.
  10. Size — of the covers, from Large to Smallest, remembered on each device.
  11. Select — choose several books and do something to all of them: put them on a shelf or a list, or take them off the shelves.
  12. Wall, Table, Shelves — three ways to look at the same books.
  13. A book. The small marks on a cover: ✓ read, + want to read, ×2 two copies, λ still being looked up, ? no catalogue knows it yet.

On a phone the same things are arranged for the thumb: the four places along the bottom, and the library’s figures and lists behind ☰.

The library on a phone, with a tab bar at the bottom12345678
The phone menu opened: the library picker, the places, figures and lists
Behind ☰.
  1. ☰ — the menu: which library, the figures, read and to read, lists.
  2. Search.
  3. Showcase.
  4. Wall, Table, Shelves.
  5. Library.
  6. Stats.
  7. Settings.
  8. Add.

3 · adding books

Press Add, then Start scanning, and allow the camera. Point it at the barcode on the back cover; there is no button to press for each book — every barcode it reads is a book, and the count goes up. You can sweep along a shelf without stopping. A laptop’s camera works too.

The Add screen: the camera area, a Shelving into field, and the buttons Start scanning, Type an ISBN, Add by name
The Add screen, before the camera starts.
The Type an ISBN box
For a worn barcode: type the number, usually printed under it.
Add a book by name: title and author fields, and a result with the button This one
For a book with no barcode.

Each book is then looked up in public catalogues, Greek and international, in the background — you can go on scanning, or close the app. While it is being looked up a book shows λ. One that no catalogue knows shows ? and Tap to name: open it and type its title yourself, if you like. still need naming, in the menu, gathers them all.

4 · a book’s page

Tap a cover, or a row in the table, and the book’s page opens.

A book’s page: the cover, the reading marks, a list, details, a description, and the buttons along the bottom12345678910111213141516
  1. The cover.
  2. Want to read and Have read — your marks: the books you mean to read, and the ones you have. With Have read, you can note the year you read it. Tap a mark again to take it off.
  3. Same book in another language? — if you have a book in another language and its Greek translation too, or two editions of one book with different ISBNs, link them here; marking one then marks the others.
  4. The lists the book is on (with the month, on a list that carries dates, like a book club’s). Tap one to see the list.
  5. Publisher, language, shelf, subject and author are links: tap the author’s name, say, to see every book of theirs.
  6. Shelf — where it stands in your house.
  7. Copies — how many you have scanned, with − and + to put it right.
  8. Read by — what the other people on this library have read, if there are any.
  9. Added — when the book was first scanned into the app.
  10. About the book: a description drawn automatically from the public catalogues, with the rest of its details.
  11. Remove — takes the book off the shelves. Where do books go when they leave? On loan, To give (set aside to give away) or Gone (for good). Nothing is deleted.
  12. The arrows ‹ › step to the previous and the next book of what you are looking at; on a computer, so do the arrow keys.
  13. Edit — change anything.
  14. Look up — ask the catalogues again for anything that may be missing.
  15. Lists — put the book on lists, or take it off them.
  16. Done — close the page.
The edit form: title, subtitle, authors one per box, translators, publisher, year
Edit: title, subtitle, authors and translators one per box (start typing and the names already in the library are offered), publisher, year, pages, language, shelf, copies, ISBN, tags, the address of a cover picture if no catalogue has one, and your notes. What you type is never overwritten by a later look-up, even if the catalogues find something new about the book.

5 · wall, table, shelves

Three ways of looking at your books, in three small buttons at the top right. Wall is the familiar one, all the covers side by side. Table is a table you can sort by any column — tap its heading. Shelves arranges the books into bookcases: by the shelves you have recorded, or by author, publisher, subject, decade, language, or A–Ω. Tap a bookcase’s name to see all of its books.

The Table view: title, author, publisher, year, pages, language, shelf, read and ISBN columns
The Shelves view: books grouped into bookcases by shelf

6 · finding books

Start typing in Search and the results narrow with every letter, wherever you are — the wall, the table, the shelves, even Stats. What is narrowing the view shows as small labels under the toolbar, and ← All 37 books, always there, takes you back to the whole library. The read and to-read figures, the lists in the menu, and the links on a book’s page are searches too, and work the same way.

A search for a title, with one book found and the label Search beneath the toolbar

7 · several books at once

Press Select and tap the covers you want. A bar appears at the bottom with what you can do to all of them at once:

Four books selected on the wall, with a bar at the bottom of the screen

8 · lists and shelves

A shelf is where a book stands — the living room, the study, the bedside table — and a book has one. A list is any company you like — a book club’s readings, a prize shortlist, books for the summer — and a book can be on many.

9 · off the shelves

A book you lend, set aside to give away, give, sell or lose is taken off the shelves, not deleted: its marks and its history stay, and the wall and the figures stop counting it. off the shelves, in the menu, shows them grouped as On loan, To give and Gone. Open one to note who has it, if you lent it, to put it back on the shelf, or — if the record should never have existed — to delete it for good.

Off the shelves: one book on loan, one given away

10 · showcase

Showcase opens a book at random: a way of wandering through your books in no order — to remember ones you had forgotten, to mark what you want to read, or to put a mistake right. Next book brings another, also at random. Inside a list or a search, it draws only from the books there — narrow it to to read, say, and it becomes a way of choosing what to read next.

A book shown in Showcase, with the button Next book

11 · sharing a library

A library can be kept by several people, its curators — you might share yours with someone in your household. Everyone on it sees the same books and can add and edit them; what each person has read, or wants to read, is their own, and the others see it on a book’s page as Read by. The owner of a library adds people in Settings › Who has access, by the email address they use on vivliothiki.

The Who has access card: the owner and one curator, and a field to add somebody

12 · stats

The library in figures: how many books by how many authors, how much shelf they take, the oldest of them, how many are translations, how many pages in all, how much is fiction. Every figure is a link to the books behind it.

The top of Stats: a paragraph about the library and a row of figures

Then your reading: what you have marked read and what you mean to read, with a reckoning of the days the first took and the second will. Share as a picture makes a square image (PNG) of these figures, to send if you want to show off a little.

Further down: the library as it grows (books in, in green; books out, in red), books read by year, where they stand, when they were written, what they are about, who wrote and who translated them, publishers, languages, your lists, and what is still not known.

The library as it grows: a monthly chart of books in and out

13 · settings, card by card

The You card
You — the name the others on your library see; signing in with a different address; signing out of this device (your books stay on it).
The Feedback card
Feedback — write a note to the person who makes the app, and see what became of each one: read, fixed (and in which version), or not now. The same box opens from feedback at the foot of the menu.
The Libraries card
Libraries — make another (the house in the country, an office), rename one, or delete one. Deleting a whole library is deliberately not easy: it asks you to type DELETE, and offers to move its books somewhere safe first.
The Shelves card
Shelves — every shelf and how many books it holds; rename or clear one; see the books not yet on a shelf.
The Lists card
Lists — rename or remove a list; or load a spreadsheet saved as CSV (from Excel: Save As › CSV) with author, title and optionally a date, and the app finds the books and puts them on a list.
The A catalogue you already have card
A catalogue you already have — bring in a whole library from Goodreads, StoryGraph or Libib, or from any spreadsheet (CSV) with a title and an author column.
The Data input card
Data input — bring in what you keep elsewhere: a list of what you have read, by year (a Word or text file), marks those books read; your Amazon data brings in your audiobooks and ebooks; a spreadsheet (CSV) of anything else adds a line to each book’s page. You are shown how it will look before anything is written.
The Your data card
Your data — fill in what is missing; ask the catalogues again about every record; Export the whole library as JSON or CSV — it is always yours to take; erase the copy on this device.
The Appearance card
Appearance — light, dark, or as the device is set.

Two more cards are there for when something needs attention: Server (sync now, and when this device last did) and Ask the catalogue again (go back over records read before the catalogues were read as well as they are now).

What vivliothiki keeps about you, and who can see it, is on the privacy page. Who makes it: about.