[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-92710":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":12,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":14,"stars30d":15,"stars90d":14,"forks30d":14,"starsTrendScore":14,"compositeScore":16,"rankGlobal":9,"rankLanguage":9,"license":17,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":20,"hasPages":18,"topics":21,"createdAt":9,"pushedAt":9,"updatedAt":22,"readmeContent":23,"aiSummary":24,"trendingCount":14,"starSnapshotCount":14,"syncStatus":25,"lastSyncTime":26,"discoverSource":27},92710,"remagic","MaximeRivest\u002Fremagic","MaximeRivest","Make your reMarkable Paper Pro magical — one-command developer-mode → AppLoad installer for builders and tinkerers.",null,"Go",60,4,52,0,5,42.6,"MIT License",false,"main",true,[],"2026-07-22 04:02:06","# ✨ remagic\n\n**Make your reMarkable Paper Pro magical.**\n\n**→ [Visit the remagic website](https:\u002F\u002Fmaximerivest.github.io\u002Fremagic\u002F)**\n\nTurn on developer mode, run one command, and you have the AppLoad launcher and a\nplace to run your own apps — no terminal wrangling. Built to lower the barrier\nfor builders and tinkerers. Open source, MIT licensed.\n\n> Works on the **reMarkable Paper Pro** (Ferrari \u002F Chiappa \u002F Tatsu — i.MX8MM,\n> aarch64). Not for the reMarkable 1 or 2.\n\nremagic is also the umbrella for a small family of apps that show what the tablet\ncan do once it's opened up — see [The remagic family](#the-remagic-family) below.\n\n---\n\n## Two steps\n\n### 1. Turn on developer mode\n\nThis is the only manual part, and it **erases the tablet** (a reMarkable\nsecurity requirement — no tool can skip it), so **sync your notebooks to the\ncloud first**. Full walkthrough:\n\n**→ [docs\u002FDEVELOPER-MODE.md](docs\u002FDEVELOPER-MODE.md)**\n\n### 2. Run the installer\n\nPlug the tablet in over USB and run one line — no git, no compiler, nothing\nelse to install:\n\n**Linux \u002F macOS**\n\n```sh\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fmaximerivest\u002Fremagic\u002Fmain\u002Fget.sh | sh\n```\n\n**Windows** (PowerShell)\n\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002Fmaximerivest\u002Fremagic\u002Fmain\u002Fget.ps1 | iex\n```\n\nThis downloads the `remagic` CLI for your machine and runs `remagic setup`.\nThe tablet is found automatically — USB or Wi-Fi, no address needed (use\n`remagic -host \u003Cip> setup` to pick one explicitly).\n\n\u003Cdetails>\n\u003Csummary>Prefer the shell-script installer? (Linux\u002FmacOS, needs git + ssh)\u003C\u002Fsummary>\n\n```sh\ngit clone https:\u002F\u002Fgithub.com\u002Fmaximerivest\u002Fremagic\ncd remagic\n.\u002Finstall.sh                      # USB\nRM_HOST=\u003Ctablet-ip> .\u002Finstall.sh  # Wi-Fi\n```\n\n\u003C\u002Fdetails>\n\nSetup:\n\n1. **Checks the connection** and confirms it's a Paper Pro in developer mode.\n2. **Installs your SSH key** — no more typing the device password.\n3. **Installs xovi + AppLoad** from official upstream releases.\n4. **Sets up persistence** via [xovi-tripletap](https:\u002F\u002Fgithub.com\u002Frmitchellscott\u002Fxovi-tripletap):\n   **triple-press the power button** to toggle xovi on or off. Survives reboots,\n   needs no computer, and can't bootloop you.\n5. **Installs the Store app**, so from then on you can browse and install apps\n   right on the tablet — no computer needed.\n\nWhen it finishes, the **AppLoad** launcher appears on your tablet. You type\nthe device password at most once: setup installs an SSH key (and generates\none for you if you've never made one).\n\nAfter a reMarkable OS update, just run `remagic setup` again.\n\n---\n\n## The remagic CLI\n\nBeyond the installer there's a companion CLI — one static Go binary that makes\nthe tablet feel like a normal, friendly device, over USB **or Wi-Fi**:\n\n```\nremagic setup                     # the whole install, one command\n.\u002Fremagic find                    # discovers tablets (USB + LAN scan)\n.\u002Fremagic doctor                  # health check: stack, SSH, battery, apps\n.\u002Fremagic key                     # passwordless SSH from then on\n.\u002Fremagic wifi on                 # after this, the cable is optional\n.\u002Fremagic install \u003Capp|.\u002Fdir>     # catalog app or local folder → AppLoad\n.\u002Fremagic config \u003Capp>            # settings form in your browser + QR for phone\n.\u002Fremagic repair-ssh              # fixes the \"connection reset\" SSH wedge\n```\n\nDetails: **[cli\u002FREADME.md](cli\u002FREADME.md)**.\n\n---\n\n## Adding apps\n\nThree ways, from easiest to most manual:\n\n1. **The Store, on the tablet.** Install it once (`remagic install store`),\n   then browse and install apps right on the device — no computer needed.\n2. **From your computer:** `remagic install \u003Capp>` pulls a checksum-verified\n   app from the [catalog](catalog.json), or `remagic install .\u002Fmyapp` pushes a\n   local folder straight into AppLoad.\n3. **By hand:** AppLoad apps live in `\u002Fhome\u002Froot\u002Fxovi\u002Fexthome\u002Fappload\u002F\u003Capp>\u002F`.\n   An \"external\" app (wrapping any aarch64 binary) needs just two files:\n\n   ```\n   myapp\u002F\n   ├── external.manifest.json\n   └── icon.png\n   ```\n\n   ```json\n   {\n     \"name\": \"My App\",\n     \"application\": \"myapp\",\n     \"qtfb\": true\n   }\n   ```\n\n   Copy the folder over and tap **Reload** in AppLoad.\n\nBuilding (or publishing) your own? The full app format — manifest fields,\nsettings schemas, UI conventions, and `remagic publish` — is specified in\n**[docs\u002FAPP-SPEC.md](docs\u002FAPP-SPEC.md)**.\n\n---\n\n## Turning it off\n\n- **Temporarily:** triple-press the power button, or just reboot — you're back\n  to stock reMarkable software instantly. Your apps stay installed.\n- **Fully:** `ssh \u003Cdevice> '\u002Fhome\u002Froot\u002Fxovi\u002Fstock'`.\n- **Back to a clean tablet:** disable developer mode via reMarkable's recovery\n  application (this factory-resets again).\n\nNothing here touches the bootloader or your encrypted data. It is designed to be\nsafe and reversible.\n\n---\n\n## Advanced: autostart on every boot\n\nBy default xovi loads on a power-button triple-press (the safe, recommended\nway). If you want it to load automatically on **every** boot with no press, see\n[`scripts\u002F99-advanced-autostart.sh`](scripts\u002F99-advanced-autostart.sh) — it\ninstalls a guarded systemd unit with a crash-loop safety net. It's riskier\n(upstream advises against naive autostart on the encrypted device), so it's\nopt-in and separate.\n\n---\n\n## How it works \u002F layout\n\n| Path | What it is |\n|------|-----------|\n| `install.sh` | Top-level installer; runs the steps below in order. |\n| `scripts\u002Flib.sh` | Shared helpers: SSH wrappers, device detection, and `persist_local_to_rootfs` (the `\u002Fetc`-overlay persistence trick). |\n| `scripts\u002F01-preflight.sh` | Connection + developer-mode + model checks with friendly errors. |\n| `scripts\u002F02-ssh-key.sh` | Passwordless SSH setup (idempotent). |\n| `scripts\u002F03-install-xovi.sh` | Downloads and installs xovi + AppLoad + tripletap. |\n| `scripts\u002Fsources.env` | Pinned upstream release URLs (one place to update versions). |\n| `scripts\u002F99-advanced-autostart.sh` | Optional unattended boot autostart. |\n| `get.sh` \u002F `get.ps1` | One-line bootstrap: download the prebuilt CLI, run `remagic setup`. |\n| `cli\u002F` | The `remagic` companion CLI (Go), including `remagic setup` (the pure-Go installer) and the on-device Store app (`cli\u002Fstore\u002F`). |\n| `catalog.json` | The app catalog: pinned versions, URLs, and sha256 checksums. Feeds `remagic install` and the Store. |\n| `docs\u002FDEVELOPER-MODE.md` | The developer-mode walkthrough. |\n| `docs\u002FAPP-SPEC.md` | The remagic app format: manifest, settings schemas, publishing. |\n\nRe-run `remagic setup` (or `install.sh`) after a reMarkable OS update to\nrefresh the pieces an update can disturb.\n\n---\n\n## Troubleshooting\n\n**`ssh`\u002F`scp` says `kex_exchange_identification: read: Connection reset by peer`.**\nThe SSH host-key mount on the tablet got knocked over (upstream tripletap's\ninstaller does this on the Paper Pro; the installer now repairs it\nautomatically). One reboot of the tablet fixes it. Not to be confused with the\nnormal ~20 s USB-network dropout whenever the reMarkable UI restarts —\nthat one heals itself.\n\n**The tablet stops answering after a minute idle.** It's asleep — e-ink devices\nsleep aggressively. Tap the power button and reconnect.\n\n**Wi-Fi ssh refused.** The *SSH over Wi-Fi* toggle (Settings → General →\nSoftware → Advanced) resets with developer-mode\u002Ffactory resets; USB\n(`10.11.99.1`) always works when the cable is in. Plug in once and run\n`remagic wifi on` to flip it back.\n\n---\n\n## The remagic family\n\nOnce your tablet is open, here's what we build on top of it — install any of\nthem from the Store or with `remagic install \u003Capp>`.\n\n- **[Chromium](https:\u002F\u002Fgithub.com\u002Fmaximerivest\u002Fchromium)** — a real browser on\n  e-ink: on-device Chromium driven over CDP. Tap to click, swipe to scroll,\n  type on the built-in keyboard, browse anywhere with the URL bar —\n  ChatGPT-ready. (The app installs from the catalog; the ~830 MB engine\n  installs once with the repo's bootstrap scripts.)\n- **[Riddle](https:\u002F\u002Fgithub.com\u002Fmaximerivest\u002Friddle)** — an enchanted diary. Write\n  with the pen; after a pause the page drinks your ink and an answer writes\n  itself back in a flowing hand. A magical blackboard, powered by an LLM.\n- **Store** (in this repo, `cli\u002Fstore\u002F`) — browse and install apps right on\n  the tablet, no computer needed.\n- **[PaperTerm](https:\u002F\u002Fgithub.com\u002Fmaximerivest\u002Fpaperterm)** — a real terminal\n  emulator with pixel-wise partial e-ink updates and an on-screen keyboard. A\n  shell on your tablet.\n- **Quill** *(repo coming soon)* — the low-level takeover display host the\n  apps stand on: it drives the e-ink panel directly through the vendor\n  waveform engine for instant-ink latency. More a library than an app.\n\nBuilding your own? These are worked examples of an AppLoad app, from a full\ntakeover renderer (Quill\u002FRiddle) to a windowed qtfb app (the Store, Paperterm).\nStart with **[docs\u002FAPP-SPEC.md](docs\u002FAPP-SPEC.md)**.\n\n---\n\n## Credits\n\nThis kit stands on the work of the reMarkable modding community:\n\n- **[xovi](https:\u002F\u002Fgithub.com\u002Fasivery\u002Fxovi)** and\n  **[rm-appload](https:\u002F\u002Fgithub.com\u002Fasivery\u002Frm-appload)** by **asivery** — the\n  function-hooking loader and app host this kit installs.\n- **[xovi-tripletap](https:\u002F\u002Fgithub.com\u002Frmitchellscott\u002Fxovi-tripletap)** by\n  **rmitchellscott** — the power-button persistence.\n- **[vellum](https:\u002F\u002Fgithub.com\u002Fvellum-dev\u002Fvellum-cli)** — a fuller package\n  manager for the ecosystem, if you outgrow this kit.\n\nremagic just wires these together into a one-command, beginner-friendly install.\nPlease support the upstream projects.\n\n## License\n\nMIT — see [LICENSE](LICENSE). This installs third-party software under their own\nlicenses; it does not redistribute reMarkable's proprietary components.\n\n## Disclaimer\n\nNot affiliated with reMarkable. Developer mode and third-party software are used\nat your own risk. This kit avoids the bootloader and your encrypted data and is\ndesigned to be reversible, but you are responsible for your device.\n","remagic 是一个为 reMarkable Paper Pro 平板（i.MX8MM 架构）提供一键式开发者环境部署的工具，核心功能包括自动启用 AppLoad 应用启动器、注入 SSH 密钥、集成 xovi 系统增强组件及内置应用商店，并支持通过 USB 或 Wi-Fi 远程管理。基于 Go 编写的单文件 CLI 工具，无需编译或依赖，简化了设备解锁后的开发与定制流程。适用于希望在 reMarkable Paper Pro 上运行第三方应用、进行系统级 tinkering 或构建定制化笔记\u002F阅读体验的技术用户。",2,"2026-07-10 02:30:15","CREATED_QUERY"]