A quick little note on kdenlive: to use the composite and transform transition it needs something to composite to. Just the regular black background won’t do. I normally only use color clips for colors other than black, so I was a touch confused by the transition not working.
If you don’t know how to add one, it’s in the top left (or wherever you put the project bin).
I went with a mildly deceptive clickbait title since this is generic, not specific.
The simplest way is to add
synclient TapButton3=2 to your
echo synclient TapButton3=2 >> ~/.bashrc
This release debuts the new KOReader logo, courtesy of @AliLozano. We’re very happy with it!
MuPDF has been updated to version 1.13, which means there is now basic support for tables in EPUB in that rendering engine.
We’d like to thank all contributors for their efforts. Some highlights include:
- Various AppImage improvements (#3868, #3884, #3892, #3893) @Frenzie
- README: add new logo and links from koreader.rocks homepage (#3881) @Frenzie
- [chore] A round of Kobo specific script cleanup (#3876) @NiLuJe
- [fix, spec] Stop the kobo_touch_probe test from causing problems for other tests. (#3877) @edorfaus
- [spec] Replace custom assert[Not]AlmostEquals with assert.is[_not].near (#3885) @edorfaus
- Wiki saved as EPUB: stylesheet fix (#3894) @poire-z
- cre hyphenation: allow for setting min left/right fragment length (#3890) @poire-z
- Fix the bug where “Press” key does not open config menu on Kindle 4 NT (#3898) @insraq
- [fix] tar args order & Kobo IR grid regression (#3895) @NiLuJe
- Update OTA mirrors (#3901) @NiLuJe
- [Menusorter] Ignore warning for the plus_menu. (#3903) @onde2rock
- ImageViewer: allow viewing a list of images @poire-z
- Many crengine fixes @poire-z
- [CI] Add a check to detect tab in lua files (#3919) @onde2rock
- bump base for MuPDF 1.13.0 (#3927) Thanks very much to @TnS-hun
- CloudStorage: Allow use reserved characters in FTP username and FTP password (#3924) @robert00s
- Add HTML widget in GoodReads review (#3929) @robert00s
- Close filemanger after open last document (#3933) @robert00s
- Another round of Kobo Fixes (#3939) @NiLuJe
- Font menu: add symbols for default and fallback fonts (#3941) @poire-z
- Style tweaks: use css snippets to tweak book styles (#3944) @poire-z
- End of document action (#3943) @robert00s
- [feat] Integrated Dropbear SSH server (#3842) @onde2rock
- Re-order typeset menu (#3946) @poire-z
- [chore] Make the binary fonts a submodule (#3951) @Frenzie
- [chore] Default to shallow clone of binary submodules where history is seldom relevant (#3951) @Frenzie
- Update Google Fonts (#3942) @NiLuJe
- A round of Kindle fixes (#3955) @NiLuJe
- Try to inhibit USBMS on Kindles (#3957) @NiLuJe
- Show current and default values in config dialog (epub) (#3952) @robert00s
- [UX] Notification are displayed too short (#3962) @robert00s
- [feat] Add default to the last value used in ReadTimer (#3963) @robert00s
- Always close filemanger before open document (#3935) @robert00s
- bump crengine: LI and CITE fixes are now the defaults (#3976) @poire-z
- TouchMenu: added hook to show help text on long-press (#3980) @poire-z
- Show current and default values in config dialog (pdf) (#3973) @robert00s
- Screen refresh between chapters (#3989) @robert00s
- Fix sort-by-last-read when partition is mounted noatime (#3990) @alethiophile
- bump crengine: HTML and rendering fixes (#3992) @poire-z
- UI Behavior tweaks (#3983) @NiLuJe
Windows and Mac have added some conveniences over the past decade that I’m missing to some degree, also see my post on mimicking Windows snap hotkeys in Xfce. There’s something called libinput-gestures, supposed to be an interim solution but it is nonetheless extremely useful. The website contains installation instructions but here’s the rundown based on my installation notes.
libinput-tools is a required package to install for people like me who use Debian and derivaties,
xdotool is to automate X11, mostly through faking keyboard presses. Docs here.
sudo apt install libinput-tools xdotool
Compile and install the actual program:
git clone http://github.com/bulletmark/libinput-gestures cd libinput-gestures sudo make install
Copy the global config to your user dir so you don’t need sudo to edit:
cp /etc/libinput-gestures.conf ~/.config/libinput-gestures.conf
Ensure you have permission to read input from the touchpad:
sudo gpasswd -a $USER input
NB Normally if you’re not a part of a group by default it’s for sensible security reasons. In this case you’re giving more programs access to your input so the negative implications are fairly self-evident.
The program can now be controlled through the
libinput-gestures-setup command. You probably want to set it up to autostart:
While playing around with the configuration you’ll probably be using
libinput-gestures-setup restart a fair bit.
As the docs say, log out of your session and log back in (or just restart) to make it work.
There are some default gestures of possible use, but I’d rather keep it closer to Windows insofar as I don’t dislike what it does to reduce disconnects when switching between systems. As such I’d stick with three finger swipe up (away from yourself) to mean window switching. For example, if you have Nimbler or something equivalent installed you can use xdotool to trigger it, whether through the default F10 or my preferred Alt+`. On various systems you also have overviews similar to Windows and Exposé. Of course I’d be remiss if I didn’t point out that as far as I know Compiz Scale preceded it, but that aside.
gesture swipe up 3 xdotool key F10 gesture swipe up 4 xdotool key alt+F1
That Alt+F1 is to trigger the global menu in Xfwm. It’s just something I’ve got in there as an experiment. We’ll see how it goes.
Should you decide to use the default gestures for back & forward in the browser, you still have to customize them because they go in the wrong direction by default. Left is back, not forward, and vice versa.
gesture swipe left xdotool key alt+Left gesture swipe right xdotool key alt+Right
It’s a little rough around the edges but definitely a lot better than nothing.
It’s quite simple to do but surprisingly hard to find. Mixed files and folders confuse me. They seem disorganized.
To resolve the weird “ERROR: Missing required OpenGL extensions,” set the environment variable
An alternative, more permanent solution consists of isntalling
sudo apt install libtxc-dxtn-s2tc
Thanks to the game’s forum.
It’s quite simple. Open Settings → Window Manager → Keyboard. Then find the various “Tile window to the…” options. Finally, pick your desired keys.
You can’t make it function quite as smoothly as in Windows 10, but it certainly helps.
Of course you can also just drag the window against the side of the screen with the mouse. But sometimes the keyboard is faster.
This release significantly improves usability on non-touch devices thanks to @onde2rock. @dengste dotted the i’s and crossed the t’s of natural light support by implementing an automatic setting for warmth. KOReader now also supports the Pocketbook Inkpad 3 (PB740). Last but not least, this release debuts an AppImage for Linux desktop computers.
Besides the emboldened introduction, there’s been a small change with big consequences. KOReader will now start in CoverBrowser view by default (#3834). If you want to change to a different view, choose the file browser menu (top left) →
Display mode →
NB Only the Kobo Aura One and the Kobo H2Ov2 support warmth. The new automatic warmth settings look like this:
So what is this “AppImage”?
Simply put, it’s a portable app for Linux, which has been a long-standing request (#1417). After you download the file, you’ll first need to allow it to run as a program. You can do so by right clicking in your file manager, choosing
Permissions and checking the box that reads
Allow this file to run as a program or something equivalent. If you prefer to use the terminal, run
chmod +x koreader-appimage-x86_64-linux-gnu-v2015.11-1644-ge39ed90_2018-04-09.AppImage.
The AppImage is a release version of what we KOReader developers call “the emulator.” It has existed since all the way back in 2011 to ease the development process. Until the past few weeks it didn’t have any of the regular desktop amenities, but I’ve added a few over the past weeks. The improvements include dragging and dropping a file onto the window to open it, a title that indicates the currently opened file, a basic albeit imperfect form of window resizing and a filechooser dialog accessible through Ctrl + O. For now the filechooser will only work if your system has Gtk3 installed.
Because the AppImage is built on top of the emulator, you can set default window sizes and DPI through the command line.
EMULATE_READER_W=2000 EMULATE_READER_H=1500 EMULATE_READER_DPI=180 ./koreader-appimage-x86_64-linux-gnu-v2015.11-1644-ge39ed90_2018-04-09.AppImage. You could also try out other debugging aids such as
EMULATE_READER_FLASH=100. There’s also another more practical use besides just reading documents: you could use the AppImage to verify whether a bug is specific to your device or if it’s inherent in the program.
All of the improvements I mentioned above, such as dragging a file onto the window, were merely part of making the emulator easier to use. There’s not much point to emulating the limitations of a Kindle or a Kobo if you’re just trying to figure out why a document crashed the program! But a better emulator is also a better desktop app. What actually pushed me over the edge into creating the AppImage, which was surprisingly easy in spite of the somewhat sprawling yet vague documentation, was @onde2rock‘s efforts to make the program properly usable on the Kindle 4NT and other older non-touch devices.
After the program became usable without touch, I thought it’d be a fun experiment to implement game controller support (#3819). The control scheme is depicted below, and you can use it in the AppImage. It’s currently equivalent to the functionality offered by the Kindle 4NT.
It might sound slightly odd, but it’s rather nice to just lean back with a gamepad while having some document on your screen. I implemented it as a half joking “wouldn’t it be cool if…” but it turned out to be a killer feature, at least to me. It’s what made me think that having KOReader easily available as a desktop app just might be a worthwhile endeavor.
|1||Left stick & d-pad||Arrow keys (menu navigation)|
|2||Right stick||Page up & down|
|3||A button||Press/enter (also opens bottom reader menu)|
|5||Left bumper||Page up|
|6||Right button||Page down|
|Start/Menu button (not shown)||Open menu|
We’d like to thank all contributors for their efforts. Some highlights include:
- Clarification of error messages (#3752, #3753) @anarcat
- [i18n] Update frontend/ui/language: add Basque and uncomment Vietnamese (#3755) @Frenzie
- coverbrowser: allow for batch metadata extraction (#3750) @poire-z
- Most of the program is now usable on non-touch devices (such as the Kindle 4NT) thanks to @onde2rock (#3796, #3785, #3774, #3765 and #3745)
- Adds ‘cre_disk_cache_max_size’ setting (#3760) @poire-z
- new option: Save Wikipedia EPUB in current book directory (#3762) @poire-z
- UIManager: avoid painting widgets covered by a full screen widget (#3770) @poire-z
- [feat] SDL2: resize window (#3775, #3776, #3780 ) @Frenzie
- [crengine] Supports
<li value=N>attributes (koreader/crengine#135) @poire-z
- [UX] SDL2: set window title (#3784) @Frenzie
- fix MuPDF Mac Build (#3788) @Frenzie
- FileManagerMenu: show tab from gesture position (#3792) @poire-z
- [feat, UX] SDL2: drop file to open (#3793) @Frenzie
- [fix] calibrecompanion.plugin (#3799) @Frenzie
- [Fix] Make ScrollTextWidget:moveCursor return the new charpos. (#3808) @edorfaus
- [fix] Kobo suspend when touching screen (#3809) @Frenzie
- [feat, UX] Support the virtualKeyboard on non touch-device (#3796) @onde2rock
- [feat, UX] bump base for SDL2: preliminary gamepad support (#3819) @Frenzie
- [feat] Add ReaderBack (#3821) @Frenzie
- Automatic setting for ‘warmth’ (#3820, #3840) @dengste
- [chore] Handle SDL_MOUSEWHEEL and less hackish SDL events (#3826) @Frenzie
- [feat, UX] SDL: add Gtk3 filechooser (#3827) @Frenzie
- [chore] device/input: migrate custom event map to settings dir (#3822) @Frenzie
- [PocketBook] Add Inkpad 3 (PB740) definition (#3830) @Frenzie (hat tip @Vaanen @Maradar)
- [UX] FileManager menu: split Settings tab into 2 tabs (#3836) @poire-z
- [UX] CoverBrowser: set default display modes on first launch (#3834) @poire-z
- Wikipedia link: check if previously saved as EPUB (#3837) @poire-z
- djvulibre: add Kobo always UTF-8 filenames patch (#3845) This finally allows for opening DjVu files with Cyrillic characters @Frenzie
- [feat] Build AppImage (#3850) @Frenzie
gnome-keyring you won’t get a useful error message. If you uninstall it, you’ll get the real culprit right where it matters, but in retrospect
ssh-add gives you the same error message:
$ git pull upstream master @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @ WARNING: UNPROTECTED PRIVATE KEY FILE! @ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ Permissions 0644 for '/home/frans/.ssh/id_rsa' are too open. It is required that your private key files are NOT accessible by others. This private key will be ignored. Load key "/home/frans/.ssh/id_rsa": bad permissions firstname.lastname@example.org: Permission denied (publickey). fatal: Could not read from remote repository. Please make sure you have the correct access rights and the repository exists.
That means something like this, or maybe just read:
So much for the GitHub help. 🙂