# rMC - CLI/UI/TUI file explorer for reMarkable
Use a Qt5 based UI to ~manage~ view, upload, delete content of/to your
reMarkable I/II via SSH.
[Project page](https://projects.om-office.de/frans/rmc)
## Usage
Once configured run `rmc` to start up a TUI, connect to and see a list of content on a (WiFi enabled
and switched on) reMarkable device. Drag and drop EPUB and PDF files onto the window to make them
available on the device.
Run `rmc [ls|list]` to list content on the connected device
Run `rmc [upload|push] <FILE> [<FILE>]` to copy stuff onto the connected device
Run `rmc info` to see configuration and stuff
Run `rmc reboot` to .. you know..
Run `rmc config-auth <KEY>=<VALUE> ...` to configure stuff, e.g.
Please note that currently reMarkable will not recognize file modifications done via SSH - to make
new files available you'll have to reboot the device. Run `rmc reboot` or press the `Reboot` button
to do this via SSH (or reboot it manually).
### Configuration
In the UI just enter your credentials, they're getting saved automatically.
The command line interface allows persistant configuration using the `config-auth` sub-command:
```
rmc config-auth host=192.168.178.13 password='s0rry_Pl4in+ex+!'
```
Please note that currently only connection via IP address (rather than hostname) and plaintext
password is working. This is subject to change ("of course").
## ToDo for v1.0
* Allow hostnames instead of IP addresses
* Make use of shared keys and configuration in `~/.ssh/config`
* Support drag&drop to add content in UI
* Support deletion
* Support Pdf
* Support web pages via Pdf
## Future features
* Download and manage notes
* Make backups
* Other convenience stuff via SSH, e.g. installing software
## Installation
```
pip3 install [--user] [--upgrade] rmc
```
## Development & Contribution
```
# provide dependencies, consider also using pyenv
pip3 install -U poetry pre-commit
git clone --recurse-submodules https://projects.om-office.de/frans/rmc.git
cd rmc
# activate a pre-commit gate keeper
pre-commit install
# if you need a specific version of Python inside your dev environment
poetry env use ~/.pyenv/versions/3.10.4/bin/python3
poetry install
```
## License
For all code contained in this repository the rules of GPLv3 apply unless
otherwise noted. That means that you can do what you want with the source
code as long as you make the files with their original copyright notice
and all modifications available.
See [GNU / GPLv3](https://www.gnu.org/licenses/gpl-3.0.en.html) for details.
## Remarkable stuff
Make a backup
```
ssh -t root@reMarkable "tar czvf - /home/root" > "home_root-$(date +'%y%m%d-%H%M%S').tar.gz"
```
```
ssh root@10.11.99.1 rm-ssh-over-wlan on
```
```
Host rm3
HostName imx8mm-ferrari
User root
```
```
convert *.* -auto-orient ../pictures.pdf
```
## Read
*(nothing here yet)*
## Notes
```
ID=codex
NAME="Codex Linux"
VERSION="4.0.772-6-g9c7386f5 (kirkstone)"
VERSION_ID=4.0.772-6-g9c7386f5
PRETTY_NAME="Codex Linux 4.0.772-6-g9c7386f5 (kirkstone)"
DISTRO_CODENAME="kirkstone"
BUILD_MODE_RM="public"
IMG_VERSION="3.14.1.9"
```
`/sys/class/power_supply/max77818_battery/charge_now`
### rm3
```
ID=codex-ct-prototype
NAME="Codex Linux"
VERSION="4.0.813 (kirkstone)"
VERSION_ID=4.0.813
PRETTY_NAME="Codex Linux 4.0.813 (kirkstone)"
DISTRO_CODENAME="kirkstone"
BUILD_MODE_RM="public"
IMG_VERSION="3.14.4.0"
```
`/sys/class/power_supply/max1726x_battery/charge_full`
Raw data
{
"_id": null,
"home_page": "https://projects.om-office.de/frans/rmc.git",
"name": "rm-commander",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0.0,>=3.10.4",
"maintainer_email": null,
"keywords": null,
"author": "Frans F\u00fcrst",
"author_email": "frans.fuerst+gitlab@protonmail.com",
"download_url": "https://files.pythonhosted.org/packages/0f/f5/6edd24df576e911c30ed72ec73b17617c7ff6391b0fbfe2f04b21aef005c/rm_commander-0.3.0.dev1.tar.gz",
"platform": null,
"description": "# rMC - CLI/UI/TUI file explorer for reMarkable\n\nUse a Qt5 based UI to ~manage~ view, upload, delete content of/to your\nreMarkable I/II via SSH.\n\n[Project page](https://projects.om-office.de/frans/rmc)\n\n\n## Usage\n\nOnce configured run `rmc` to start up a TUI, connect to and see a list of content on a (WiFi enabled\nand switched on) reMarkable device. Drag and drop EPUB and PDF files onto the window to make them\navailable on the device.\n\nRun `rmc [ls|list]` to list content on the connected device\n\nRun `rmc [upload|push] <FILE> [<FILE>]` to copy stuff onto the connected device\n\nRun `rmc info` to see configuration and stuff\n\nRun `rmc reboot` to .. you know..\n\nRun `rmc config-auth <KEY>=<VALUE> ...` to configure stuff, e.g.\n\nPlease note that currently reMarkable will not recognize file modifications done via SSH - to make\nnew files available you'll have to reboot the device. Run `rmc reboot` or press the `Reboot` button\nto do this via SSH (or reboot it manually).\n\n\n### Configuration\n\nIn the UI just enter your credentials, they're getting saved automatically.\n\nThe command line interface allows persistant configuration using the `config-auth` sub-command:\n\n```\nrmc config-auth host=192.168.178.13 password='s0rry_Pl4in+ex+!'\n```\n\nPlease note that currently only connection via IP address (rather than hostname) and plaintext\npassword is working. This is subject to change (\"of course\").\n\n\n## ToDo for v1.0\n\n* Allow hostnames instead of IP addresses\n* Make use of shared keys and configuration in `~/.ssh/config`\n* Support drag&drop to add content in UI\n* Support deletion\n* Support Pdf\n* Support web pages via Pdf\n\n\n## Future features\n\n* Download and manage notes\n* Make backups\n* Other convenience stuff via SSH, e.g. installing software\n\n\n## Installation\n\n```\npip3 install [--user] [--upgrade] rmc\n```\n\n\n## Development & Contribution\n\n```\n# provide dependencies, consider also using pyenv\npip3 install -U poetry pre-commit\n\ngit clone --recurse-submodules https://projects.om-office.de/frans/rmc.git\n\ncd rmc\n\n# activate a pre-commit gate keeper\npre-commit install\n\n# if you need a specific version of Python inside your dev environment\npoetry env use ~/.pyenv/versions/3.10.4/bin/python3\n\npoetry install\n```\n\n## License\n\nFor all code contained in this repository the rules of GPLv3 apply unless\notherwise noted. That means that you can do what you want with the source\ncode as long as you make the files with their original copyright notice\nand all modifications available.\n\nSee [GNU / GPLv3](https://www.gnu.org/licenses/gpl-3.0.en.html) for details.\n\n\n## Remarkable stuff\n\nMake a backup\n```\nssh -t root@reMarkable \"tar czvf - /home/root\" > \"home_root-$(date +'%y%m%d-%H%M%S').tar.gz\"\n```\n\n```\nssh root@10.11.99.1 rm-ssh-over-wlan on\n```\n\n```\nHost rm3\n\tHostName imx8mm-ferrari\n\tUser root\n```\n\n```\nconvert *.* -auto-orient ../pictures.pdf\n```\n\n\n## Read\n\n*(nothing here yet)*\n\n## Notes\n```\nID=codex\nNAME=\"Codex Linux\"\nVERSION=\"4.0.772-6-g9c7386f5 (kirkstone)\"\nVERSION_ID=4.0.772-6-g9c7386f5\nPRETTY_NAME=\"Codex Linux 4.0.772-6-g9c7386f5 (kirkstone)\"\nDISTRO_CODENAME=\"kirkstone\"\nBUILD_MODE_RM=\"public\"\nIMG_VERSION=\"3.14.1.9\"\n```\n\n`/sys/class/power_supply/max77818_battery/charge_now`\n\n### rm3\n```\nID=codex-ct-prototype\nNAME=\"Codex Linux\"\nVERSION=\"4.0.813 (kirkstone)\"\nVERSION_ID=4.0.813\nPRETTY_NAME=\"Codex Linux 4.0.813 (kirkstone)\"\nDISTRO_CODENAME=\"kirkstone\"\nBUILD_MODE_RM=\"public\"\nIMG_VERSION=\"3.14.4.0\"\n```\n`/sys/class/power_supply/max1726x_battery/charge_full`",
"bugtrack_url": null,
"license": null,
"summary": "reMarkable Commander",
"version": "0.3.0.dev1",
"project_urls": {
"Homepage": "https://projects.om-office.de/frans/rmc.git",
"Repository": "https://projects.om-office.de/frans/rmc.git"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "32da0a85735fcd41bf83d7dfb7b40415a0b0ff5add8c9a8d7e7bb47de0d03ca2",
"md5": "2c20f136d0765940a2a2179227bfcd33",
"sha256": "a4096f147e7c4065ce18dd7ca4e8354e260dd82ce83aec48dff173ff49c2fde6"
},
"downloads": -1,
"filename": "rm_commander-0.3.0.dev1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2c20f136d0765940a2a2179227bfcd33",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0.0,>=3.10.4",
"size": 12511,
"upload_time": "2024-10-08T05:55:50",
"upload_time_iso_8601": "2024-10-08T05:55:50.031952Z",
"url": "https://files.pythonhosted.org/packages/32/da/0a85735fcd41bf83d7dfb7b40415a0b0ff5add8c9a8d7e7bb47de0d03ca2/rm_commander-0.3.0.dev1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0ff56edd24df576e911c30ed72ec73b17617c7ff6391b0fbfe2f04b21aef005c",
"md5": "c4b53b870d1b4be6d5b6daecaf21c42a",
"sha256": "431ce91e387f4b02c9cdd4c537a88b6523fea629c011f0d17e47b49c75bc21ca"
},
"downloads": -1,
"filename": "rm_commander-0.3.0.dev1.tar.gz",
"has_sig": false,
"md5_digest": "c4b53b870d1b4be6d5b6daecaf21c42a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0.0,>=3.10.4",
"size": 12508,
"upload_time": "2024-10-08T05:55:51",
"upload_time_iso_8601": "2024-10-08T05:55:51.948124Z",
"url": "https://files.pythonhosted.org/packages/0f/f5/6edd24df576e911c30ed72ec73b17617c7ff6391b0fbfe2f04b21aef005c/rm_commander-0.3.0.dev1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-08 05:55:51",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "rm-commander"
}
JSON