Skip to content

library.md

Latest commit

 

History

History
53 lines (37 loc) · 1.58 KB

library.md

File metadata and controls

53 lines (37 loc) · 1.58 KB
Raw

Library command

zim library

library lists every .zim file directly beneath the configured library directory. The default library is ~/.cache/zim; ZIM_LIBRARY_PATH or the configuration file can change it.

Usage

zim library

The command creates a missing library directory, then shows each archive's current number, display name, size, and full filename. It also reports the total file count and size.

ZIM Library: ~/.cache/zim
======================================================================

[1] simple                 400 MB  wikipedia_en-simple_all_mini_2025-01.zim
----------------------------------------------------------------------
Total: 1 files, 400 MB

Referencing archives

Most file commands accept:

  • A number from the current zim library listing: zim info 1
  • An exact filename or name without .zim: zim serve example
  • An unambiguous filename fragment: zim list simple
  • A direct path for non-destructive file commands: zim info ./archives/example.zim

Ambiguous fragments fail with the matching candidates. zim remove is additionally restricted to files inside the configured library.

Adding files

zim download simple-wiki
zim catalog search wikipedia
cp ./archives/example.zim ~/.cache/zim/

simple-wiki, wiktionary, stackoverflow, and ted are the supported download aliases. For another catalog entry, pass its normalized .zim URL directly to zim download.

Related commands