libro-client

Libro.fm CLI Tool

This is a simple command-line tool for interacting with your Libro.fm library. It allows you to:

• List all audiobooks in your library
• Download audiobooks to your computer
• Check for new audiobooks in your library
• Run as a background service

Command-line interface

Installation

The CLI can be installed as a global package using npm:

bun add -g libro-client

To run the tool, use the following command:

libro

This will display a list of available commands.

List audiobooks

To list all audiobooks in your library, run the following command:

libro list

This will print a list of audiobook titles to the console.

Download audiobooks

To download a specific audiobook, run the following command:

libro get [...isbns]

To choose an audiobook from your library, run the following command:

libro get

Replace [...isbns] with the ISBN of the audiobook you want to download. You can find the ISBN by running the list command.

If you don't specify an ISBN, the tool will prompt you to select an audiobook from your library.

Check for new audiobooks

To check for new audiobooks in your library, run the following command:

libro check

This will print a list of new audiobooks to the console. You can also use the --json flag to output the data as JSON.

Background service

The tool can also be run as a background service. This is useful if you want to automatically download new audiobooks as they become available in your library.

To run the service, you can use Docker or another process manager.

Docker

To run the service using Docker, use the following command:

docker build -t libro .
docker run -d libro

Or use the provided docker-compose.yml file:

docker-compose up -d

Configuration

You can set the following environment variables:

DEBUG=false
LIBROFM_USERNAME=<your_librofm_username>
LIBROFM_PASSWORD=<your_librofm_password>

Disclaimer

This tool is not affiliated with Libro.fm in any way. Use it at your own risk.