An open API service indexing awesome lists of open source software.

https://github.com/rmitchellscott/rmtree

A tree-style display tool for the reMarkable tablet's document filesystem, showing the hierarchical structure of documents and folders.
https://github.com/rmitchellscott/rmtree

remarkable-tablet

Last synced: 5 months ago
JSON representation

A tree-style display tool for the reMarkable tablet's document filesystem, showing the hierarchical structure of documents and folders.

Awesome Lists containing this project

README

          

# rmtree
[![rm1](https://img.shields.io/badge/rM1-supported-green)](https://remarkable.com/store/remarkable)
[![rm2](https://img.shields.io/badge/rM2-supported-green)](https://remarkable.com/store/remarkable-2)
[![rmpp](https://img.shields.io/badge/rMPP-supported-green)](https://remarkable.com/products/remarkable-paper/pro)
[![rmppm](https://img.shields.io/badge/rMPPM-supported-green)](https://remarkable.com/products/remarkable-paper/pro-move)

A tree-style display tool for the reMarkable tablet's document filesystem, showing the hierarchical structure of documents and folders.

### Automatic Installation (Recommended)

> [!CAUTION]
> Piping code from the internet directly into `bash` can be dangerous. Make sure you trust the source and know what it will do to your system.

The easiest way to install is using the installation script that automatically detects your device architecture:

```bash
wget -qO- https://github.com/rmitchellscott/rmtree/raw/main/install.sh | bash
```

### Manual Installation

Download the correct binary for your device:

```bash
# For reMarkable 1/2 (ARMv7):
wget https://github.com/rmitchellscott/rmtree/releases/latest/download/rmtree-armv7.tar.gz
tar -xzf rmtree-armv7.tar.gz
mv rmtree-armv7 rmtree
chmod +x rmtree

# For reMarkable Paper Pro & Paper Pro Move (ARM64):
wget https://github.com/rmitchellscott/rmtree/releases/latest/download/rmtree-aarch64.tar.gz
tar -xzf rmtree-aarch64.tar.gz
mv rmtree-aarch64 rmtree
chmod +x rmtree
```

## Usage

```bash
./rmtree [path] [options]
```

**Default path**: `/home/root/.local/share/remarkable/xochitl`

## Options

- `--icons`, `-i` - Show emoji icons (πŸ“ πŸ“• πŸ“— πŸ““)
- `--labels`, `-l` - Show document type labels (pdf), (epub), (notebook)
- `--uuid`, `-u` - Show document UUIDs in square brackets (documents only, not folders)
- `--no-color`, `-n` - Disable colored output
- `--version`, `-v` - Show version information

## Examples

**Default** (clean, colored):
```
.
β”œβ”€β”€ Books
β”‚ └──Project Hail Mary
β”œβ”€β”€ Calendar
β”‚ └── Calendar-2025
└── To Do
```

**With labels** (`--labels`):
```
.
β”œβ”€β”€ Books
β”‚ └── Project Hail Mary (epub)
β”œβ”€β”€ Calendar
β”‚ └── Calendar-2025 (pdf)
└── To Do (notebook)
```

**With icons and labels** (`--icons --labels`):
```
.
β”œβ”€β”€ πŸ“ Books
β”‚ └── πŸ“— Project Hail Mary (epub)
β”œβ”€β”€ πŸ“ Calendar
β”‚ └── πŸ“• Calendar-2025 (pdf)
└── πŸ““ To Do (notebook)
```

**With UUIDs** (`--uuid`):
```
.
β”œβ”€β”€ Books
β”‚ └──Project Hail Mary [3f05b2d1-90e0-458a-b233-7966564d2172]
β”œβ”€β”€ Calendar
β”‚ └── Calendar-2025 [67f60935-7978-4fe4-b234-64b70ed17c3e]
└── To Do [d1a44483-3023-4b16-b677-ea75211252ca]
```