Metadata-Version: 2.5
Name: tiptoi-dl
Version: 1.0.0
Summary: A TipToi Download helper
Requires-Python: >=3.13
Requires-Dist: anyio>=4.14.2
Requires-Dist: beautifulsoup4>=4.14.2
Requires-Dist: coloredlogs>=15.0.1
Requires-Dist: httpx>=0.28.1
Requires-Dist: psutil>=7.1.0
Requires-Dist: requests>=2.32.5
Requires-Dist: textual>=8.2.8
Requires-Dist: tqdm>=4.67.1
Description-Content-Type: text/markdown

# TipToi-dl

A linux CLI TipToi audiofile downloader.

## Motivation

[Ravensburger](https://www.ravensburger.de/), the manufacturer of the famous [TipToi](https://www.ravensburger.de/de-DE/entdecken/tiptoi) offers a Windows and a Mac Program for downloading new audiofiles.
As a Linux user you have to do that [manually via their website](https://service.ravensburger.de/tiptoi%C2%AE/tiptoi%C2%AE_Audiodateien) which is not the best experience.

So I decided to build this little CLI that allows me to download and copy the audiofile for a new book onto my kids TipToi within seconds.

## Setup

1. Install uv if you have not already (see https://docs.astral.sh/uv/getting-started/installation/)
2. Run `uv tool install tiptoi-dl` (or `uv tool install git+https://github.com/Bouni/tiptoi-dl.git` for the main branch)
3. Run the app: `tiptoi-dl`

> [!NOTE]
> If the command is not found, the path is most likely not in your PATH.
> run `uv tool update-shell` to fix that

## Usage

On start, tiptoi-dl loads the full catalog and shows it in a table.

| Key | Action |
| --- | --- |
| type in the search bar | filter the catalog by name or product ID |
| `Tab` | jump from the search bar to the table |
| `↑` / `↓` | select an entry |
| `Enter` | show details of the selected entry |
| `Ctrl+D` | download the `.gme` file of the selected entry |
| `Ctrl+Q` | quit |

If a TipToi pen is connected via USB and mounted, the `.gme` file is saved directly onto it.
Otherwise it is saved into the current directory.

![](demo.gif)

## Disclaimer

tiptoi-dl is neither offered nor supported by Ravensburger.
The authors do not take any liability for possible damages.
