Drisiúr / User guide / Getting started

Getting started

Install Drisiúr, find your way around the window, and set it up the way you like.

Install

Drisiúr runs on Windows and macOS. Linux builds work too.

To scan barcodes you need a webcam. Any built-in laptop camera works. Reading trading cards with the webcam also needs a key for Claude.

The window

  • Category chips along the top switch between kinds of shelf: Books, Music, Films and the rest. Drag a chip to move it. The ones that don’t fit go under More ▾, and the + makes a category of your own.
  • At the top left, beside the sidebar button, the arrows go back and forward between the shelves you’ve looked at (Alt + ← and Alt + →).
  • Top right is Add, for adding something by hand. The arrow beside it has the other ways in: Type a barcode, Scan with the webcam, Add by hand, Import a library and Find gear in my photos. See Adding things.
  • The sidebar has your Library lists, smart shelves, the reading, listening, watching and playing lists, your cards, loans and, under Tools, Tags, Stats & reports and Recently removed. See Finding things. The panel button at the top left, or Ctrl + \, hides it.
  • The footer has the dots that show how each lookup service is doing, the item count, the Spacing and Size sliders, and ? for About and the keyboard shortcuts. Click the percentage beside a slider to put it back to 100%.

Click any item to open its details. See Items and loans.

Preferences

Open Preferences with the gear icon. It has four pages.

Appearance

  • Window: the frame around the bookcase. As the system (the default) follows your computer’s light or dark setting, or pick Dark or Light.
  • Shelves: the bookcase itself. Gallery (pale oak on soft plaster, in daylight, the default), Birch & board, Walnut, Cherry, Light oak, Painted white or Black lacquer. Each category can also have a finish of its own.
  • Accent: the one colour for things you can act on and what’s selected. Verdigris is Drisiúr’s own; Ink, Garnet, Forest, Plum, Copper and Graphite are there too. The logo stays verdigris whichever you choose.
  • Units: centimetres or inches, for heights and thicknesses in the details.
  • Switches for Status and loan badges, Format bands on films and games, Curiosities on the shelves and Reduce motion. Reduce motion follows Windows until you change it.
  • Pictures for the bands: your own pictures for the format bands across the top of film and game cases, with the size each one should be.
Drisiúr’s Preferences on the Appearance page: the window as the system, Dark or Light, and the shelf finishes, Gallery, Birch and board, Walnut, Cherry, Light oak, Painted white and Black lacquer.
Preferences → Appearance.
The Reading now shelf with Drisiúr’s window set to Light: a pale toolbar and sidebar around a wooden bookcase of comics and books.
The window in Light.

Scanning & lookups

  • Beep when a barcode is read, on to start with.
  • Ask before adding each item, off to start with. Turn it on to check each scan before it lands on the shelf.
  • Your languages: when you look something up by title, editions in these languages come first and the rest go under Other languages. Leave it empty to use your computer’s language.

Plugins

The lookup services, their keys, their order and any plugins you add. It has a page of its own: Plugins.

Your data

Sharing between computers, filling in what’s missing, export, backup and the lookup cache. See Your data.

Keyboard

KeysDoes
?Shows every keyboard shortcut
/ or Ctrl + FSearches your shelves
Ctrl + NAdds something by hand
Ctrl + ,Opens Preferences
Ctrl + \Hides or shows the sidebar
Alt + ← →Goes back or forward between shelves. On a category chip, moves it along
EscCloses what’s open, or lets go of picked items
Ctrl + ZUndoes, while the message at the bottom offers it
EnterOpens the item in focus
SpaceA closer look at the artwork of the item that’s open
EEdits the item that’s open
Delete or BackspaceTakes the item that’s open off the shelves (it asks first)
Ctrl + click, Shift + clickPicks one more, or a run of items, to change several at once
Shift + Space or Ctrl + SpacePicks the item in focus too
Ctrl + APicks everything on the shelf
↑ ↓ in the list viewMoves between rows
← → Home, or scroll over a crateFlicks through the records; Enter or Space pulls out the front one
Alt + ↑ ↓ on a sidebar headingMoves that section up or down
↑ ↓ in a series numberCounts it up or down in whole numbers
Enter or , in tagsAdds the tag you’ve typed
← → on a panel edgeMakes a side panel wider or narrower. Add Shift for bigger steps; double-click the edge to reset it
← → in the editorSwitches between Details and Artwork
Ctrl + V in ArtworkPastes a picture as the cover
Space or Enter in Cards modeReads the card in the frame now
Right-click a pocketOn a set’s page, takes your card out of that set
Right-click or Shift + click a stickerTakes one away

On a Mac, the Ctrl shortcuts use ⌘ instead.