v1.1-beta
Pre-releaseNew Features
- Added clock to top bar
- Moved battery indicator to top bar.
- Added dynamic icons for battery life.
- Added option to display battery percentage (hidden by default).
- Added option to display battery temperature.
- Added dynamic wifi status indicator.
- Added option to display wifi signal strength in decibels.
- Added ability to change how many minutes before automatic suspend is triggered.
Known Issues
Warnings
Currently, battery/wifi status will be checked every 3 seconds, but the UI should only change if they have changed. I'm not sure how much this will affect performance. Please let me know on the community Discord if you notice that your battery is draining quicker on this version.
Upgrade Instructions
- Replace the
oxide
andbutton-capture
binaries on your device. - Optionally add the missing settings to your
conf
file.
Installation
- Copy oxide.tar.xz to your remarkable
- Decompress files into one of the following locations
a. Root filesystem:/
b. Entware:/opt
- If you haven't installed to the root filesystem, copy the
oxide.service
file to/etc/systemd/system
- Edit
oxide.service
to point it at the correct location ofoxide
- Reload systemd unit files:
systemctl daemon-reload
- Disable xochitl:
systemctl disable --now xochitl
- Enable and start oxide
systemctl enable --now oxide
Configuration
Configuration files can be in one of the following locations:
/etc/draft
/opt/etc/draft
/home/root/.config/draft
The configuration folder contains the following:
icons/
Folder containing.png
files that are used by applications.conf
Application configuration file. The launcher will automatically maintain this file.- Any other file will be used to define an application.
Oxide will search through all three locations when building a list of applications. So be careful not to duplicate files between all the locations as they will show up multiple times in the applications list in oxide.
Configuration files for an application use the following format:
name=xochitl
desc=The standard environment for reMarkable.
imgFile=xochitl
call=/usr/bin/xochitl
term=killall xochitl
Options:
- name: Name of the application
- desc: Description of the application, will show on long press.
- imgFile: Name of the icon to use.
- call: Command to run when launching the application
- term: Command to run when button-capture is used to kill the application
Since this format is based off of the configuration format used by the draft launcher, you can leave entries blank by either omitting them from the file, or setting them to :
, or leaving them blank.
Usage
oxide
After you have configured and launched oxide you can access the power menu from the button on the top right of the screen. This will allow you to put the device to sleep, or to power off the device.
The button on the top left side of the screen will open up the tools menu. This allows you to either refresh the grid, or to open up the options dialog.
The options dialog will allow you to configure various settings in the application. You have the option to reload the settings from the conf
file on disk, or to close the options dialog and save the current settings to disk.
button-capture
Press and hold the left button for 1 second or longer to execute the contents of /tmp/.terminate
. Oxide will automatically populate this file when launching an application with the term
setting.
Press and hold the right button for 1 second or longer to create a screenshot at /tmp/fb.png
. It will then execute /tmp/.screenshot
if it exists. Due to how the reMarkable preserves colour information in the framebuffer used to generate the screenshot, there may be colour in the screenshots that are not visible on the reMarkable itself.