# maiden-remote-repl

> Remote REPL session for [Norns Maiden](https://monome.org/docs/norns/maiden/).

Latest version **1.1.1** (published 2022-11-18) · MIT license · 0 weekly downloads

## Install

```sh
npm install maiden-remote-repl
pnpm add maiden-remote-repl
yarn add maiden-remote-repl
bun add maiden-remote-repl
```

Provides the command `maiden-remote-repl`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.1.1 |
| Published | 2022-11-18 |
| First published | 2021-02-14 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 3.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Szymon Kaliski |
| Maintainers | szymon_k |

## Links

- npm: https://www.npmjs.com/package/maiden-remote-repl
- npm.io page: https://npm.io/package/maiden-remote-repl

## Dependencies (2)

- [ws](https://npm.io/package/ws.md) ^8.11.0
- [yargs](https://npm.io/package/yargs.md) ^17.6.2

## Recent versions

- 1.1.1 (latest) — 2022-11-18
- 1.1.0 — 2022-11-15
- 1.0.0 — 2021-02-14

## README

# `maiden-remote-repl`

Remote REPL session for [Norns Maiden](https://monome.org/docs/norns/maiden/).

# Installation

```
npm install -g marden-remote-repl
```

# Usage

- `maiden-remote-repl` starts the remote repl, user input is sent to Norns, and messages are sent back to the CLI
- `maiden-remote-repl send [msg]` sends `msg` as a one-off, useful for reloading script: `'maiden-remote-repl send "norns.script.load("code/APP/APP.lua")'`
- you can specify the norns url with `--host`, for example: `maiden-remote-repl --host fates.local`

## Tips

You can combine `maiden-remote-repl send` with `nodemon` and `rsync` to get live-reload experience:

1. create `dev-sync.sh` (assuming you're working on `APP.lua`):
    ```bash
    rsync -azP . --exclude .git --delete we@norns.local:/home/we/dust/code/APP
    maiden-remote-repl send 'norns.script.load("code/APP/APP.lua")'
    ```
2. start file watching session, for example: `nodemon -e lua -x ./dev-sync.sh`

Now, on every file change to lua the code is sent to Norns, and the script is restarted.

---
_Source: https://npm.io/package/maiden-remote-repl · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._