Skip to content

Commit

Permalink
Please please
Browse files Browse the repository at this point in the history
  • Loading branch information
Jayy001 committed Dec 7, 2024
1 parent e94541b commit 001a64d
Show file tree
Hide file tree
Showing 2 changed files with 3 additions and 78 deletions.
79 changes: 2 additions & 77 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,81 +6,6 @@ A utility program that helps to manage the remarkable device version utilizing [

### Installation & Use

You can find pre-compiled binaries on the [releases](https://github.com/Jayy001/codexctl/releases/) page. This includes a build for the reMarkable itself, as well as well as builds for linux, macOS, and Windows. It currently only has support for **command line interfaces** but a graphical interface is soon to come.
You can find pre-compiled binaries on the [releases](https://github.com/Jayy001/codexctl/releases/) page. This includes a build for the reMarkable itself, as well as well as builds for linux, macOS, and Windows. Alterantivley, you can install directly from pypi with `pip install codexctl`. It currently only has support for **command line interfaces** but a graphical interface is soon to come.

## Running from source

Codexctl can be run from source on both the reMarkable, as well as on a remote device.

### Running on reMarkable

```
git clone https://github.com/Jayy001/codexctl.git
cd codexctl
pip install -r requirements.txt
python codexctl.py --help
```

### Running on a remote device

This requires python 3.11 or newer.

```
git clone https://github.com/Jayy001/codexctl.git
cd codexctl
pip install wheel
pip install -r requirements.remote.txt
python codexctl.py --help
```

## Building executables from source

This requires python 3.11 or newer, python-venv, pip. Linux also requires libfuse-dev.

```
make executable
```

## Usage

The script is designed to have as little interactivity as possible, meaning arguments are directly taken from the command to run the script.

```
❯ codexctl --help
usage: Codexctl app [-h] [--debug] [--rm1] [--auth AUTH] [--verbose] {install,download,backup,extract,mount,status,restore,list} ...
positional arguments:
{install,download,backup,extract,mount,status,restore,list}
install Install the specified version (will download if not available on the device)
download Download the specified version firmware file
backup Download remote files to local directory
extract Extract the specified version update file
mount Mount the specified version firmware filesystem
status Get the current version of the device and other information
restore Restores to previous version installed on device
list List all versions available for use
options:
-h, --help show this help message and exit
--debug Print debug info
--rm1 Use rm1
--auth AUTH Specify password or SSH key for SSH
--verbose Enable verbose logging
```

# Examples
```
codexctl install latest # Downloads and installs latest version
codexctl download toltec # Downloads latest version that has full support for toltec
codexctl download 3.0.4.1305 --rm1 # Downloads 3.0.4.1305 firmware file for remarkable 1
codexctl status # Prints current & previous version (can only be used when running on device itself)
codexctl list # Lists all available versions
codexctl restore # Restores previous version
codexctl --verbose # Enables logging
codexctl --backup # Exports all files to local directory
codexctl --backup -l root -r FM --no-recursion --no-overwrite # Exports all files from FM directory to root folder on localhost
codexctl extract 3.8.0.1944_reMarkable2-7eGpAv7sYB.signed # Extracts contents to filesystem named "extracted"
codexctl mount extracted /opt/remarkable # Mounts extracted filesystem to /opt/remarkable
codexctl ls 3.8.0.1944_reMarkable2-7eGpAv7sYB.signed / # Lists the root directory of the update image
codexctl cat 3.8.0.1944_reMarkable2-7eGpAv7sYB.signed /etc/version # Outputs the contents of /etc/version from the update image
```
### TODO
2 changes: 1 addition & 1 deletion builds/scripts/build.sh
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ set -eu
cd /opt/tmp/src

echo "Installing dependencies"
python -m pip install -r requirements.txt
python -m pip install -r ../requirements.txt

echo "Building codexctl"
python -m PyInstaller \
Expand Down

0 comments on commit 001a64d

Please sign in to comment.