feat: add reMarkable tablet skill and setup guide
Add skill for managing documents on reMarkable tablets via SSH: - Upload PDFs and EPUBs to device library - List documents with UUIDs - Delete documents by name or UUID Also includes docs/guides/remarkable-integration.md with full Tailscale setup instructions for remote access. Tested on reMarkable 2, OS 3.24.0.149.
This commit is contained in:
SPANISH FLU
parent
1a947a21d6
commit
2652109d7f
172
docs/guides/remarkable-integration.md
Normal file
172
docs/guides/remarkable-integration.md
Normal file
@ -0,0 +1,172 @@
|
|||||||
|
# reMarkable Tablet Integration
|
||||||
|
|
||||||
|
Connect your reMarkable tablet to Clawdbot via Tailscale for direct SSH access from anywhere.
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
This guide sets up:
|
||||||
|
- Tailscale VPN on your reMarkable (userspace networking mode)
|
||||||
|
- Direct SSH access via Tailscale IP
|
||||||
|
- Ability to upload/manage documents remotely
|
||||||
|
|
||||||
|
**Tested on:** reMarkable 2, OS 3.24.0.149
|
||||||
|
|
||||||
|
## Prerequisites
|
||||||
|
|
||||||
|
- reMarkable with SSH access enabled
|
||||||
|
- Another computer on the same network (for initial setup)
|
||||||
|
- Tailscale account
|
||||||
|
|
||||||
|
## Step 1: Get Tailscale Binaries
|
||||||
|
|
||||||
|
The reMarkable's root partition is small (~21MB free), so we install to `/home`.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# On a computer that can reach your reMarkable
|
||||||
|
# Download the ARM static binary
|
||||||
|
curl -fsSL https://pkgs.tailscale.com/stable/tailscale_1.94.1_arm.tgz -o /tmp/tailscale_arm.tgz
|
||||||
|
|
||||||
|
# Copy to reMarkable (replace IP with yours)
|
||||||
|
scp /tmp/tailscale_arm.tgz root@<REMARKABLE_IP>:/home/
|
||||||
|
```
|
||||||
|
|
||||||
|
## Step 2: Install on reMarkable
|
||||||
|
|
||||||
|
SSH into your reMarkable and run:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd /home
|
||||||
|
tar xzf tailscale_arm.tgz
|
||||||
|
mkdir -p /home/bin /home/tailscale-state
|
||||||
|
cp tailscale_*/tailscale tailscale_*/tailscaled /home/bin/
|
||||||
|
chmod +x /home/bin/tailscale /home/bin/tailscaled
|
||||||
|
```
|
||||||
|
|
||||||
|
## Step 3: Start Tailscale
|
||||||
|
|
||||||
|
The reMarkable kernel doesn't have TUN support, so we use userspace networking with `--statedir` for SSH keys:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Start the daemon
|
||||||
|
nohup /home/bin/tailscaled \
|
||||||
|
--statedir=/home/tailscale-state \
|
||||||
|
--socket=/tmp/tailscaled.sock \
|
||||||
|
--tun=userspace-networking > /tmp/tailscaled.log 2>&1 &
|
||||||
|
|
||||||
|
# Wait a few seconds, then authenticate
|
||||||
|
sleep 5
|
||||||
|
/home/bin/tailscale --socket=/tmp/tailscaled.sock up --ssh
|
||||||
|
```
|
||||||
|
|
||||||
|
This will print an authentication URL. Visit it to add the reMarkable to your Tailnet.
|
||||||
|
|
||||||
|
## Step 4: Create Systemd Service
|
||||||
|
|
||||||
|
For auto-start on boot:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cat > /etc/systemd/system/tailscaled.service << 'EOF'
|
||||||
|
[Unit]
|
||||||
|
Description=Tailscale VPN
|
||||||
|
After=network-online.target
|
||||||
|
Wants=network-online.target
|
||||||
|
|
||||||
|
[Service]
|
||||||
|
Type=simple
|
||||||
|
ExecStart=/home/bin/tailscaled --statedir=/home/tailscale-state --socket=/tmp/tailscaled.sock --tun=userspace-networking
|
||||||
|
ExecStartPost=/bin/sh -c 'sleep 3 && /home/bin/tailscale --socket=/tmp/tailscaled.sock up --ssh'
|
||||||
|
Restart=on-failure
|
||||||
|
RestartSec=5
|
||||||
|
|
||||||
|
[Install]
|
||||||
|
WantedBy=multi-user.target
|
||||||
|
EOF
|
||||||
|
|
||||||
|
systemctl daemon-reload
|
||||||
|
systemctl enable tailscaled
|
||||||
|
systemctl start tailscaled
|
||||||
|
```
|
||||||
|
|
||||||
|
## Step 5: Configure SSH Client
|
||||||
|
|
||||||
|
On your local machine, add to `~/.ssh/config`:
|
||||||
|
|
||||||
|
```
|
||||||
|
Host rem
|
||||||
|
HostName <TAILSCALE_IP> # e.g., 100.91.182.5
|
||||||
|
User root
|
||||||
|
StrictHostKeyChecking no
|
||||||
|
UserKnownHostsFile /dev/null
|
||||||
|
```
|
||||||
|
|
||||||
|
Now you can simply run:
|
||||||
|
```bash
|
||||||
|
ssh rem
|
||||||
|
```
|
||||||
|
|
||||||
|
## Clawdbot Integration
|
||||||
|
|
||||||
|
Once SSH is configured, Clawdbot can:
|
||||||
|
|
||||||
|
### Upload PDFs/EPUBs
|
||||||
|
```bash
|
||||||
|
# Copy file to reMarkable
|
||||||
|
scp document.pdf rem:/home/root/
|
||||||
|
|
||||||
|
# Create metadata and add to library
|
||||||
|
ssh rem 'cd /home/root/.local/share/remarkable/xochitl && \
|
||||||
|
UUID=$(cat /proc/sys/kernel/random/uuid) && \
|
||||||
|
cat > ${UUID}.metadata << EOF
|
||||||
|
{
|
||||||
|
"createdTime": "$(date +%s)000",
|
||||||
|
"lastModified": "$(date +%s)000",
|
||||||
|
"lastOpened": "0",
|
||||||
|
"lastOpenedPage": 0,
|
||||||
|
"parent": "",
|
||||||
|
"pinned": false,
|
||||||
|
"type": "DocumentType",
|
||||||
|
"visibleName": "My Document"
|
||||||
|
}
|
||||||
|
EOF
|
||||||
|
cp /home/root/document.pdf ${UUID}.pdf && \
|
||||||
|
echo "{}" > ${UUID}.content && \
|
||||||
|
systemctl restart xochitl'
|
||||||
|
```
|
||||||
|
|
||||||
|
### List Documents
|
||||||
|
```bash
|
||||||
|
ssh rem 'grep -h visibleName /home/root/.local/share/remarkable/xochitl/*.metadata'
|
||||||
|
```
|
||||||
|
|
||||||
|
### Delete Documents
|
||||||
|
```bash
|
||||||
|
# Find UUID by name
|
||||||
|
ssh rem 'grep -l "Document Name" /home/root/.local/share/remarkable/xochitl/*.metadata'
|
||||||
|
# Delete all files with that UUID
|
||||||
|
ssh rem 'rm /home/root/.local/share/remarkable/xochitl/<UUID>* && systemctl restart xochitl'
|
||||||
|
```
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
### "no var root for ssh keys"
|
||||||
|
Use `--statedir=/home/tailscale-state` instead of `--state=`
|
||||||
|
|
||||||
|
### Connection timeouts
|
||||||
|
The reMarkable goes to sleep aggressively. Wake it by tapping the screen.
|
||||||
|
|
||||||
|
### Tailscale not starting on boot
|
||||||
|
Check logs: `journalctl -u tailscaled`
|
||||||
|
|
||||||
|
### No TUN support
|
||||||
|
This is normal - the reMarkable kernel doesn't include the TUN module. Userspace networking mode works around this.
|
||||||
|
|
||||||
|
## Limitations
|
||||||
|
|
||||||
|
- **Userspace networking**: Outbound connections from reMarkable require proxy configuration
|
||||||
|
- **Sleep mode**: The tablet sleeps frequently; connections may timeout
|
||||||
|
- **Kernel TUN**: Not available without custom kernel (risky)
|
||||||
|
|
||||||
|
## References
|
||||||
|
|
||||||
|
- [remarkable.guide/tech/tailscale](https://remarkable.guide/tech/tailscale.html)
|
||||||
|
- [Tailscale userspace networking](https://tailscale.com/kb/1112/userspace-networking)
|
||||||
85
skills/remarkable/SKILL.md
Normal file
85
skills/remarkable/SKILL.md
Normal file
@ -0,0 +1,85 @@
|
|||||||
|
---
|
||||||
|
name: remarkable
|
||||||
|
description: Manage documents on reMarkable tablets via SSH. Upload PDFs/EPUBs, list library, delete documents. Requires Tailscale or direct SSH access to the device.
|
||||||
|
metadata: {"clawdbot":{"emoji":"📓","requires":{"bins":["ssh","scp"]}}}
|
||||||
|
---
|
||||||
|
|
||||||
|
# reMarkable
|
||||||
|
|
||||||
|
Manage documents on reMarkable tablets over SSH.
|
||||||
|
|
||||||
|
## Prerequisites
|
||||||
|
|
||||||
|
SSH access to reMarkable via Tailscale (recommended) or local network. Add to `~/.ssh/config`:
|
||||||
|
|
||||||
|
```
|
||||||
|
Host rem
|
||||||
|
HostName <TAILSCALE_IP>
|
||||||
|
User root
|
||||||
|
StrictHostKeyChecking no
|
||||||
|
UserKnownHostsFile /dev/null
|
||||||
|
```
|
||||||
|
|
||||||
|
Test: `ssh rem echo ok`
|
||||||
|
|
||||||
|
## Document Paths
|
||||||
|
|
||||||
|
- Library: `/home/root/.local/share/remarkable/xochitl/`
|
||||||
|
- Documents: `<uuid>.pdf` + `<uuid>.metadata` + `<uuid>.content`
|
||||||
|
- Restart UI after changes: `systemctl restart xochitl`
|
||||||
|
|
||||||
|
## Upload PDF/EPUB
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Copy file
|
||||||
|
scp document.pdf rem:/home/root/
|
||||||
|
|
||||||
|
# Create document entry
|
||||||
|
ssh rem 'cd /home/root/.local/share/remarkable/xochitl && \
|
||||||
|
UUID=$(cat /proc/sys/kernel/random/uuid) && \
|
||||||
|
cat > ${UUID}.metadata << EOF
|
||||||
|
{
|
||||||
|
"createdTime": "'$(date +%s)'000",
|
||||||
|
"lastModified": "'$(date +%s)'000",
|
||||||
|
"lastOpened": "0",
|
||||||
|
"lastOpenedPage": 0,
|
||||||
|
"parent": "",
|
||||||
|
"pinned": false,
|
||||||
|
"type": "DocumentType",
|
||||||
|
"visibleName": "My Document Title"
|
||||||
|
}
|
||||||
|
EOF
|
||||||
|
cp /home/root/document.pdf ${UUID}.pdf && \
|
||||||
|
echo "{}" > ${UUID}.content && \
|
||||||
|
systemctl restart xochitl'
|
||||||
|
```
|
||||||
|
|
||||||
|
Adjust `visibleName` and source filename as needed.
|
||||||
|
|
||||||
|
## List Documents
|
||||||
|
|
||||||
|
```bash
|
||||||
|
ssh rem 'grep -h visibleName /home/root/.local/share/remarkable/xochitl/*.metadata 2>/dev/null | sed "s/.*: \"//" | sed "s/\".*//"'
|
||||||
|
```
|
||||||
|
|
||||||
|
With UUIDs:
|
||||||
|
```bash
|
||||||
|
ssh rem 'for f in /home/root/.local/share/remarkable/xochitl/*.metadata; do echo "$(basename $f .metadata): $(grep visibleName $f | sed "s/.*: \"//" | sed "s/\".*//")" ; done 2>/dev/null'
|
||||||
|
```
|
||||||
|
|
||||||
|
## Delete Document
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Find UUID by name
|
||||||
|
ssh rem 'grep -l "Document Name" /home/root/.local/share/remarkable/xochitl/*.metadata'
|
||||||
|
|
||||||
|
# Delete (replace UUID)
|
||||||
|
ssh rem 'rm /home/root/.local/share/remarkable/xochitl/<UUID>.* && systemctl restart xochitl'
|
||||||
|
```
|
||||||
|
|
||||||
|
## Notes
|
||||||
|
|
||||||
|
- Device sleeps aggressively; wake screen before SSH
|
||||||
|
- EPUBs work the same way as PDFs
|
||||||
|
- `parent` field can reference a folder UUID for organization
|
||||||
|
- Changes require `systemctl restart xochitl` to appear in UI
|
||||||
Loading…
Reference in New Issue
Block a user