Skip to content

Instantly share code, notes, and snippets.

@folliehiyuki
Last active July 19, 2025 17:32
Show Gist options
  • Save folliehiyuki/8effccc0f35e95bdfee4de838357838b to your computer and use it in GitHub Desktop.
Save folliehiyuki/8effccc0f35e95bdfee4de838357838b to your computer and use it in GitHub Desktop.
Kobo Libra Colour setup
# Location: /mnt/onboard/.adds/nm/config
# https://www.svgrepo.com/svg/21377/cogwheel-outline
experimental :menu_main_15505_icon :/mnt/onboard/.adds/cogwheel.svg
experimental :menu_main_15505_icon_active :/mnt/onboard/.adds/cogwheel.svg
menu_item :main :KOReader :cmd_spawn :quiet:exec /mnt/onboard/.adds/koreader/koreader.sh
menu_item :main :Plato :cmd_spawn :quiet:exec /mnt/onboard/.adds/plato/plato.sh
menu_item :main :Browser :nickel_browser :
menu_item :main :Browser (popup) :nickel_browser :modal
menu_item :main :Rescan books :nickel_misc :rescan_books_full
menu_item :main :USB Connect :nickel_misc :force_usb_connection
menu_item :main :Toggle Telnet :cmd_output :500:quiet:/usr/bin/pkill -f "^/usr/bin/tcpsvd -E 0.0.0.0 2023"
chain_success :skip:5
chain_failure :cmd_spawn :quiet:/bin/mount -t devpts | /bin/grep -q /dev/pts || { /bin/mkdir -p /dev/pts && /bin/mount -t devpts devpts /dev/pts; }
chain_success :cmd_spawn :quiet:exec /usr/bin/tcpsvd -E 0.0.0.0 2023 /usr/sbin/telnetd -i -l /bin/login
chain_success :dbg_toast :Started Telnet server on port 2023
chain_failure :dbg_toast :Error starting Telnet server on port 2023
chain_always :skip:-1
chain_success :dbg_toast :Stopped Telnet server on port 2023
menu_item :main :Toggle FTP :cmd_output :500:quiet:/usr/bin/pkill -f "^/usr/bin/tcpsvd -E 0.0.0.0 1021"
chain_success :skip:4
chain_failure :cmd_spawn :quiet:exec /usr/bin/tcpsvd -E 0.0.0.0 1021 /usr/sbin/ftpd -w -t 30 /mnt/onboard
chain_success :dbg_toast :Started FTP server for KOBOeReader partition on port 1021
chain_failure :dbg_toast :Error starting FTP server on port 1021
chain_always :skip:-1
chain_success :dbg_toast :Stopped FTP server on port 1021
menu_item :main :Toggle Screensaver :cmd_output :500:quiet:test -e /mnt/onboard/.kobo/screensaver_old
chain_failure :skip:3
chain_success :cmd_spawn :quiet:mv /mnt/onboard/.kobo/screensaver_old /mnt/onboard/.kobo/screensaver
chain_success :dbg_toast :Screensaver on
chain_always :skip:-1
chain_failure :cmd_spawn :quiet:mv /mnt/onboard/.kobo/screensaver /mnt/onboard/.kobo/screensaver_old
chain_success :dbg_toast :Screensaver off
menu_item :main :Toggle Dark Mode :nickel_setting :toggle :dark_mode
menu_item :main :Toggle Screenshots :nickel_setting :toggle :screenshots
menu_item :main :Dump Syslog :cmd_spawn :logread > /mnt/onboard/.adds/syslog.log
menu_item :main :Free Memory :cmd_output :500:free -m
menu_item :main :IP Address :cmd_output :500:/sbin/ifconfig | /usr/bin/awk '/inet addr/{print substr($2,6)}'
menu_item :main :Reboot :power :reboot
menu_item :main :Shutdown :power :shutdown
menu_item :reader :Free Memory :cmd_output :500:free -m
menu_item :reader :Browser :nickel_browser :
menu_item :reader :Browser (popup) :nickel_browser :modal
menu_item :reader :Toggle Dark Mode :nickel_setting :toggle :dark_mode
menu_item :reader :Toggle Screenshots :nickel_setting :toggle :screenshots
menu_item :browser :Goodreads :nickel_browser :https://www.goodreads.com/book
menu_item :browser :Wikipedia :nickel_browser :https://www.wikipedia.org/
menu_item :browser :Wikipedia (popup) :nickel_browser :modal:https://www.wikipedia.org/
menu_item :browser :Quit :nickel_misc :home
menu_item :selection :Google Translate :nickel_browser :modal :https://translate.google.com/m?sl=auto&tl=en&q={1||%}
menu_item :selection_search :Google Translate :nickel_browser :modal :https://translate.google.com/m?sl=auto&tl=en&q={1||%}
menu_item :selection_search :Search DuckDuckGo :nickel_browser :modal :https://duckduckgo.com/?q={1|S|%}

3rd-party software

Book management software

  • Sigil: edit EPUB files
  • Calibre: manage local library, edit files' metadata and convert them between formats
  • Komga: book hosting server (can act as a Kobo sync server)

Tweaks

Bypass the first login page

  • Plug the device to a computer
  • In /mnt/onboard/.kobo/Kobo/Kobo eReader.conf set:
[ApplicationPreferences]
SideloadedMode=true
  • Delete /mnt/onboard/.kobo/KoboReader.sqlite if it exists
  • Unplug and restart the device

Custom screensaver

Put PNG/JPEG images into /mnt/onboard/.kobo/screensaver with size 1264x1680. Turn on the options Show current read and Show book covers full screen in Kobo's Settings page.

Plato's screensaver is configured in Settings.toml file.

KoReader can display random images via a configuration in its menu settings (Sleep screen > Wallpaper).

KoReader

  • Document > Book metadata location should be set to ./docsettings

Others

  • Remove /mnt/onboard/.kobo/affiliate.conf file (ref: https://wiki.mobileread.com/wiki/Affiliate.conf)
  • Type devmodeon into the search bar of Nickel interface to activate Developer settings
    • The default color profile can be changed in CFA Mode option

Fonts

Fonts should be downloaded to /mnt/onboard/fonts (for Kobo's Nickel reader and Plato) and /mnt/onboard/.adds/koreader/fonts for KoReader. Each font should contain Bold, Italic, Bold Italic and Regular variants.

Dictionaries

  • KoReader: /mnt/onboard/.adds/koreader/data/dict (StarDict format)
  • Plato: /mnt/onboard/.adds/plato/dictionaries (StarDict format)
  • Kobo's Nickel reader: /mnt/.kobo/{custom-dict,dict} (HTML dictionary format)

Where to get dictionaries:

# Location: /mnt/onboard/.adds/plato/Settings.toml
selected-library = 0
keyboard-layout = "English"
frontlight = true
wifi = false
inverted = false
sleep-cover = true
auto-share = false
rotation-lock = "portrait"
button-scheme = "inverted"
auto-suspend = 2.0
auto-power-off = 3.0
time-format = "%H:%M"
date-format = "%A, %B %-d, %Y"
external-urls-queue = "bin/article_fetcher/urls.txt"
[[libraries]]
name = "On Board"
path = "/mnt/onboard/Library"
mode = "database"
sort-method = "file-name"
first-column = "title-and-author"
second-column = "progress"
thumbnail-previews = true
[[libraries.hooks]]
path = "Articles"
program = "bin/article_fetcher/article_fetcher"
sort-method = "added"
first-column = "title-and-author"
second-column = "progress"
[[libraries]]
name = "Dropbox"
path = "/mnt/onboard/.kobo/dropbox"
mode = "database"
sort-method = "opened"
first-column = "title-and-author"
second-column = "progress"
thumbnail-previews = true
[[libraries]]
name = "KePub"
path = "/mnt/onboard/.kobo/kepub"
mode = "database"
sort-method = "opened"
first-column = "title-and-author"
second-column = "progress"
thumbnail-previews = true
[intermissions]
suspend = "/mnt/onboard/.kobo/screensaver/kokkoro.png"
power-off = "/mnt/onboard/.kobo/screensaver/kokkoro.png"
share = "logo:"
[home]
address-bar = false
navigation-bar = true
max-levels = 2
max-trash-size = 33554432
[reader]
finished = "notify"
south-east-corner = "go-to-page"
bottom-right-gesture = "toggle-dithered"
south-strip = "toggle-bars"
west-strip = "previous-page"
east-strip = "next-page"
strip-width = 0.6
corner-width = 0.4
font-path = "/mnt/onboard/fonts"
font-family = "Literata"
font-size = 11.0
min-font-size = 5.5
max-font-size = 16.5
text-align = "left"
margin-width = 8
min-margin-width = 0
max-margin-width = 10
line-height = 1.2
continuous-fit-to-width = true
ignore-document-css = false
dithered-kinds = ["jpeg", "jpg", "png", "cbz"]
[reader.paragraph-breaker]
hyphen-penalty = 50
stretch-tolerance = 1.26
[reader.refresh-rate]
regular = 8
inverted = 2
[import]
unshare-trigger = true
startup-trigger = true
sync-metadata = true
metadata-kinds = ["djvu", "epub", "pdf"]
allowed-kinds = ["oxps", "fb2", "xps", "djvu", "cbz", "pdf", "epub", "txt"]
[dictionary]
margin-width = 4
font-size = 11.0
[sketch]
save-path = "Sketches"
notify-success = true
[sketch.pen]
size = 2
dynamic = true
amplitude = 4.0
min-speed = 0.0
max-speed = 3000.0
[sketch.pen.color]
gray = 0
[calculator]
font-size = 8.0
margin-width = 2
history-size = 4096
[battery]
warn = 10.0
power-off = 3.0
[frontlight-levels]
intensity = 40.0
warmth = 60.0
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment