Skip to content

v2.2.2
Compare
Choose a tag to compare
@Eeems Eeems released this 26 Sep 23:37
· 178 commits to master since this release
v2.2.2
a2b6fd5
This commit was created on github.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.

Issues Fixed

  • #217 OS 2.9 support
  • #220 Change how service is defined to properly keep other launchers from being enabled at the same time.

Known Issues

  • There have been some odd issues reported on the rM2 that haven't been fully validated yet. #135
  • #147 Multiple button press actions do not work in remarkable-hacks

Warnings

There is currently no way to change your PIN after you've set it. You can do the following over SSH to clear your PIN and the lockscreen will prompt for a new pin the next time it's shown:

systemctl stop tarnish
rm /home/root/.config/Eeems/decay.conf
systemctl start tarnish

If you change the lockscreen application to another application, it will need to make sure to launch the launcher application via the system service after validating the user.

When importing applications from draft, it will fail to import applications that have configured the call= option to use arguments. This is due to oxide only supporting pointing at a single file for an application without arguments.

As part of implementing #38 users have lost the ability to choose what order applications will display. There is a plan to add this back in a future release as part of #11.

By default, the clock will use UTC, if you need to change your timezone you'll need to ssh into the device and use timedatectl set-timezone to change your timezone (e.g. timedatectl set-timezone America/Denver). You can see possible timezones by looking in /usr/share/zoneinfo/ (Don't trust the output of timedatectl get-timezones)). You can install more timezones through toltec by installing the various zoneinfo-* packages.

reMarkable 2 support requires rm2fb.

Manual Installation/Upgrade

  1. Copy packges.zip to your remarkable
  2. Decompress files onto a temporary folder
  3. Run opkg install path/to/folder/*.ipk
  4. If you are on a rM2, make sure you have rm2fb installed/enabled/running
  5. Enable the tarnish service: systemctl enable --now tarnish

Automated Installation

  1. Add the toltec repository to your entware install
  2. Run opkg update
  3. Run opkg install oxide
  4. If xochitl or another launcher is enabled, disabled them: systemctl disable --now xochitl
  5. Enable the tarnish service: systemctl enable --now tarnish

Automated Upgrade

  1. Run opkg update
  2. Run opkg upgrade
  3. If xochitl or another launcher is enabled, disabled them: systemctl disable --now xochitl
  4. Enable the tarnish service if it isn't already: systemctl enable --now tarnish

Configuration

Configuration files can be in one of the following locations:

  1. /etc
  2. /opt/etc
  3. /home/root/.config

The configuration folder contains the following:

  • oxide.conf Application configuration file. The launcher will automatically maintain this file.

There are two other application specific configuration files that are not intended for user modification. You must stop the tarnish service before modifying either of them.

  1. /home/root/.config/Eeems/tarnish.conf
  2. /home/root/.config/Eeems/decay.conf

Usage

See the wiki for usage information.

Assets 3
Loading