---
name: "lesana"
section: "1"
platform: "linux"
package: "lesana"
version: "0.10.1-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/lesana"
---

# lesana(1)

manages collection inventories

## NAME

lesana - manages collection inventories

## SYNOPSIS

lesana \[–help\] \<command\>

## DESCRIPTION

lesana is a tool to organize collections of various kinds.  It is designed to have a data storage / serialization format that is friendly to git and other VCSs, but decent performances.

To reach this aim it uses *yaml* as its serialization format, which is easy to store in a VCS, share between people and synchronize between different computers, but it also keeps an index of this data in a local *xapian* database in order to allow for fast searches.

lesana supports collections of any kind, as long as their entries can be described with a mostly flat dictionary of fields of the types described in the documentation file **field\_types**.

Some example collection schemas are provided, but one big strength of lesana is the ability to customize your collection with custom fields either by simply writing a personalized **settings.yaml**.

## OPTIONS

- **-h, --help**

  Prints an help message and exits.

## COMMANDS

- **[new(1)](/new/1.md)**

  Creates a new entry.

- **[edit(1)](/edit/1.md)**

  Edits an existing entry.

- **[show(1)](/show/1.md)**

  Shows an existing entry.

- **index(1)**

  Index some entries in the xapian cache.

- **search(1)**

  Searches for entries in the xapian cache.

- **[export(1)](/export/1.md)**

  Exports entries from one lesana collection to another

- **[init(1)](/init/1.md)**

  Initialize a new lesana collection

- **[rm(1)](/rm/1.md)**

  Removes an entry.

## TEXT EDITOR

Many lesana subcommands will try to open files in a text editor chosen as follows:

- •

  first, the value of $EDITOR is tried

- •

  then the command **sensible-editor**, as available under e.g. Debian and its derivatives

- •

  lastly, it will try to fallback to **vi**, which should be available under any posix system.

## AUTHOR

valhalla@trueelena.org

## COPYRIGHT

2020-2021, Elena Grandi