File types

Configure which file types are displayed in the Settings screen:

.epub
.mobi
.azw
.azw3
.pdf
.cbr
.cbz
.md
.rtf
.mp3

To add a new type, add its extension on a new line. Any file type (except .opf) can be added to your library (such as .rtf, .mp3, .txt, .docx, etc.).

Colors

Customize all colors:

  • Background
  • Buttons
  • Text
  • Search box
  • Tiles

Options

SettingDescription
Rounded cornersEnable/disable rounded buttons
Only selected file typesFilter by configured file types
Fuzzy searchEnable character-sequence matching
Scrollbar widthAdjust scrollbar size
Scrollbar always visibleNever auto-hide scrollbars
Show book titleDisplay title on cover tiles
Show tagsDisplay tags on cover tiles
Font sizeAdjust all text sizes

Customize appearance

Colors

Hexadecimal codes (‘#6F9D9F’, ‘#FFF’) and color names (white, black, red, blue, lightblue etc.) can both be used. RGB tuples (111, 157, 159) cannot.
Use this color overview to pick the colors that you like.

Default settingDescriptionDefault
Background colorMain window background#6F9D9F
Button colorButton background#793F4E
Button font colorButton textwhite
Search box colorSearch input backgroundwhite
Tile font colorText on book tilesblack
Background font colorStatus bar textblack
Search box font colorSearch input textblack
SettingValuesDescription
Rounded cornersY/NEnable rounded button corners
Scrollbar widthNumber (pixels)Width of scrollbar
Scrollbar always visibleY/NNever auto-hide scrollbars
Show book titleY/NDisplay title on cover tiles
Show tagsY/NDisplay tags on cover tiles
Font sizeNumber (points)Global font size

Tip: Increase the font size for better readability for high DPI displays
Tip: increase the scrollbar width on touch screens for easier touch:

Behavior

SettingValuesDescription
Only selected file typesY/NShow only the configured file types
Fuzzy searchY/NEnable fuzzy character matching

Field names

Rename field names for compatibility with:

  • Goodreads exports
  • Obsidian plugins
  • Custom setups

Settings locations

No environment variables are used. All configuration is file based.

The customizing settings are stored in:

  • Windows: %APPDATA%\Libiry\customize\
  • Linux: ~/.local/share/Libiry/customize/

The folder contents are: customize.txt, can be maintained from Libiry’s settings screen selected_types.txt, can be maintained from Libiry’s settings screen language_codes.txt, can only be maintained directly An icons folder, can only be maintained directly

The user settings are stored in:!!!

  • Windows: C:\Users<username>.libiry\settings.json
  • Linux: ~/.libiry/settings.json

To override an icon for a screen button, simply paste a new icon file with the same file name over the old one. When you made a mistake, you can safely remove your own icon from the customize folder. Libiry wil then use the icon from its resources folder.