Power Tip: Logos on e-ink with page turn buttons working!

I recently got a Boyue T63 e-reader device to run Verbum / Logos, thanks to the advice of Mark Nolette. I am very happy with how it runs Verbum, but was disappointed to see the physical page turn buttons don’t work.

I found out how to make them work, however! Click on the image below to see a brief video demonstrating me using the hardware buttons to flip pages forward and backward in Verbum: 

In this post, I’ll explain how I did it. Hopefully this method will work for other e-reader brands as well (some of the steps will likely need to be adapted – feel free to follow up in this post with questions about how to do so).

Steps to make the Page Turn buttons work with Logos / Verbum on the Boyue T63

NOTE: This process involves rooting the Boyue T63, which may void your warranty. Do so at your own risk.

OVERVIEW: After rooting the device (necessary for this to work), we’re going to install and configure some apps which will allow us to “remap” the hardware buttons, so that pressing them will replicate what we do when we physically tap the right-hand or left-hand side of the screen, causing Logos / Verbum to flip pages!

Install the necessary software:

1. Root the Boyue T63 following the instructions here. As part of the process, following the instructions in the forum post, install the Google Play Store, and the Nova Launcher, but don’t install the Xposed Installer yet.
2. Install Tasker from the Google Play Store. It costs a few dollars.
3. After installing Tasker, install the Xposed Installer, using the T6x Toolkit you used in step 1. This installs the XPosed Framework and XPosed Installer.
4. Once you’ve installed the XPosed Installer, download version 3.4.1 of the Xposed Additions from here and install it on the T63. This program allows the XPosed Framework to remap the hardware button commands. It is an older version of the app (newer versions don’t work on the T63), so we have to side-load it to install it. To do so:
   1. Connect the T63 by USB cable to your computer.
   2. Copy the Xposed Additions file you downloaded to the Android --> Downloads folder.
   3. Disconnect the T63 from the USB cable.
   4. Open the Downloads folder on the T63, and click on the Xposed Additions APK file to install it.
5. Install Xposed Additions Pro from the Google Play store, available here. It costs a few dollars. We need the "Pro" add-on because we need the integration with Tasker to make this work. 

Basic configuration of the apps:

1. We need to configure Tasker to accept commands from the XPosed Additions. To do so:
   1. Open Tasker
   2. Select the three dots on the upper right, then Preferences
   3. Go the “Misc” tab
   4. Activate the option “Allow External Access”
   5. Press the back button to save changes
2. Activate the XPosed Additions:
   1. Open XPosed Installer
   2. Tap on the “Modules” option.
   3. Check the Xposed Additions to activate it (NOTE: If the T63 asks you in a pop-up if it is okay to grant the program root access here or in other moments throughout this installation, you’ll need to say OK for it to work).
   4. Reboot the T63.

Create actions in Tasker to simulate tapping on the far right, or far left of the screen

1. Open Tasker
2. Activate the “Tasks” tab if it isn’t already

Create a Left tap action:

1. Press the + button on the bottom center
2. Type the name “Left tap” and tap on the check mark to save
3. Press the + button in the bottom center to add a new action
4. Select the Action Category “Code”
5. Select the Code Action “Run Shell”
6. In the command box, type “input tap 15 700” (without the quotation marks). This is a command which will tap on the screen, 15 pixels from the far left, and 700 pixels from the top.
7. Check the “Use Root” option
8. Press back two times to save changes and return to the Tasks menu.

Create a Right tap action – Repeat the above process, with the name “Right tap”, and in the command box, type “input tap 1030 700”

Remap the hardware buttons using Xposed Additions:

1. Open the app “Xposed Additions”
2. Tap on “Buttons”
3. Tap on Allow External Devices. Activate “Miscellaneous” and tap OK.

Remap the right button:

1. Tap on “Add new Key”
2. A dialogue box will appear. Press the right hardware button on your T63. The words “Page Down” should appear in the dialogue box. Tap on OK.
3. Tap on the newly created “Page Down” key to open it
4. Tap on “Add new Condition”
5. Tap on “Screen on”
6. Tap on the newly created “Screen on” condition to open it.
7. Activate the "Click" option by checking the box on the right.
8. Tap on “Click” to configure what happens when you click the button
9. Scroll to the bottom, and choose “Tasker: Select a task from Tasker”
10. Tap on the “Right tap” action we had created in Tasker
11. If you like, configure the “Long Press” option as well by activating it, then tapping on it. I use “Recent Applications.”
12. Press the back button twice to return to the “Buttons” page

Remap the left button – Do the same process as for the right button, but choosing the “Left tap” task from Tasker. For the “Long Press” button, I use the “Back” button.

Optional: Add, and remap the button on the bottom of the T63 using the same process. I have it set to go to “Home” on click. “Long Press” doesn’t seem to work with this button.

Grant the new actions "root" permission - When you press the right and left hardware button for the first time after remapping them, a popup will appear, asking if you want to grant root permission. You need to grant the access for this to work.

Open Verbum / Logos and enjoy!

I hope I remembered all the steps correctly! This is not for the fainthearted, but if you don’t mind experimenting with your device, having the hardware buttons working adds a lot to the Verbum / Logos e-reader experience!

And… maybe, just maybe, this post will motivate Faithlife to make an e-reader optimized version, with hardware buttons supported OOTB.