Kobo Configuration Options

From MobileRead
Jump to: navigation, search

Contents

[edit] How to apply these options

  1. Connect your Kobo eReader to your computer
  2. Navigate to KoboeReader/.kobo/Kobo and open the file "Kobo eReader.conf"
  3. Place your option under the relevant heading e.g [FeatureSettings]. If it does not exist then create it
  4. Save the file then eject your Kobo eReader

If you are having any issues then reboot your eReader. If there are any issues check that the options is supported on your firmware, have spelt the setting right and having given it the right value e.g (true, false or a string). Most options should take true or false. Windows users, don't use Notepad to edit the file.

If you are reading this and can fill in some of the UNKNOWN's, please edit this page and fill them in

[edit] [FeatureSettings]

The FeatureSettings options are all booleans, meaning that they take options of true or false.

[edit] Working with latest firmware

Option Name Summary last tested
BookSpecificStats Enables a new book context menu option which shows the reading stats page for the selected book. 4.32
AcceptPreviewUpgrades Will allow the Kobo to install beta firmware upgrades. Does nothing without invitation from Kobo. 4.25+
ExportHighlights Enables a new book context menu option which opens a dialog allowing you to export annotations in a book to a txt file in /mnt/onboard. 4.32
Screenshots Will take PNG screenshots and save them to /mnt/onboard whenever the power button is pressed. Sleepcovers function as normal. 4.32
FullScreenBrowser Makes the experimental web browser fully fullscreen, with no menus or options to exit without rebooting. 4.25+
SketchNote Changes the page into a drawing page, similar to the Sketchpad feature, when a highlight is taken. 4.25+
MyWords Adds a new tab under "Activity" which allows users to create a list of words. 4.32
InvertScreen Inverts the screen. 4.25+ / BROKEN before 4.32
ExcludeSyncFolders This controls which folders are not processed into the database and supports regular expressions. Added after 4.16 made all hidden folders excluding .kobo and .kobo-images automatically imported into the database [1] 4.25+

[edit] Not working with recent firmware/Unknown

Option Name Summary Status
SyncEmuPath UNKNOWN UNKNOWN
ExcludeEndMatterFromStats UNKNOWN UNKNOWN
MediaOverlay UNKNOWN UNKNOWN
MaxDownload UNKNOWN UNKNOWN
MaxWifiTimeout UNKNOWN UNKNOWN
ShowFirstPurchaseCredit UNKNOWN UNKNOWN
ShowNewTasteProfile UNKNOWN UNKNOWN
ReaderBookmarkHistory UNKNOWN UNKNOWN
NewAnnotationsSync UNKNOWN UNKNOWN
CookieSlot UNKNOWN UNKNOWN
OptlyTest UNKNOWN UNKNOWN
FacebookShare Re-enables Facebook sharing since 4.13 removed it NOT WORKING (Enables feature, but logging in fails to stick. Sharing to Facebook fails.)
SmartShelves Automatically creates shelves/collections based on metadata. UNKNOWN
TestSync UNKNOWN UNKNOWN
ShowLayoutRectangles UNKNOWN UNKNOWN
GestureKeyboard Allows the virtual keyboard to be swipeable, complete with suggestions in a similar layout to iOS devices. Causes a reboot in newer firmwares when keyboard is accessed NOT WORKING
PhraseTranslation Allows online translation of phrases. NOT WORKING
Thesaurus Allows online thesaurus lookup of phrases. NOT WORKING
NewKeyboard Enables the new keyboard without the .com button and outlines around keys. Can be used for reverting the newer keyboard in newish firmwares. NOT WORKING (Since 4.17)
IgnoreCaptivePortal Bypasses the check for whether the Wi-Fi network has internet access (by connecting to http://www.kobo.com/buildinfo.xml). NOT WORKING (Not needed since 4.15 added official support for this)

[edit] [ApplicationPreferences]

[edit] Working with latest firmware

Option Name Summary Last Tested
AIRPLANE_MODE If this is equal to true, then the WiFi will be turned off. 4.25
QuickTourShown This option will be set to true once the "Quick Tour" has been shown. Removing it or setting it to false will show it again. 4.25
SideloadedMode If set to true (and device rebooted), will not require Kobo Account to read sideloaded books. Will not sync. Home Screen is replaced with My Books. "Discover" icon replaced with "Activity" 4.31+, 4.32

[edit] Not working with recent firmware/Unknown

Option Name Summary Status
ImageCacheSize UNKNOWN UNKNOWN
CurrentLocale UNKNOWN UNKNOWN
CurrentDemoRegion UNKNOWN UNKNOWN
LastFTEStep UNKNOWN UNKNOWN
demoModeTimeout UNKNOWN UNKNOWN
EarliestChangeLog UNKNOWN UNKNOWN
LastSyncTime UNKNOWN UNKNOWN
LastUpdateCheckTime UNKNOWN UNKNOWN
LastTopPicksSyncTime UNKNOWN UNKNOWN
removeLibrarySubFilter() UNKNOWN UNKNOWN
NumMaxToasts UNKNOWN UNKNOWN
QuickTourWidgetShown UNKNOWN UNKNOWN
VisitCount UNKNOWN UNKNOWN
ZoomFTEShown UNKNOWN UNKNOWN
SwipeDialogShown UNKNOWN UNKNOWN
LongPressDialogShown UNKNOWN UNKNOWN
SyncReminderDialogShown UNKNOWN UNKNOWN
DesktopSyncCount UNKNOWN UNKNOWN
WifiReminderDialogShown UNKNOWN UNKNOWN
PeriodicAutoSync UNKNOWN UNKNOWN
PeriodicAutoSyncTime UNKNOWN UNKNOWN
ReadABookShown2 UNKNOWN UNKNOWN
DictionaryOpenCount UNKNOWN UNKNOWN
LastLibraryViewType UNKNOWN UNKNOWN
hasSyncedExistingRelatedItems UNKNOWN UNKNOWN
hasSetupDevice UNKNOWN UNKNOWN
affiliateCode UNKNOWN UNKNOWN
firstRunDate UNKNOWN UNKNOWN
lastPlugTime UNKNOWN UNKNOWN
sleepOnNextBoot UNKNOWN UNKNOWN
syncOnNextBoot UNKNOWN UNKNOWN
ReviewUser UNKNOWN UNKNOWN
WelcomeShown UNKNOWN UNKNOWN
KoboLoveDialogShown UNKNOWN UNKNOWN
BorrowDialogShown UNKNOWN UNKNOWN
IntegratedBrowseDialogShown UNKNOWN UNKNOWN
IntegratedBrowseDialogTime UNKNOWN UNKNOWN
LibraryCuratedListsDialogShown UNKNOWN UNKNOWN
OverDriveFilterShown UNKNOWN UNKNOWN
SignInTime UNKNOWN UNKNOWN
MarkAsFinishedLastShown UNKNOWN UNKNOWN
MarkAsUnreadLastShown UNKNOWN UNKNOWN
LibraryFTEShown UNKNOWN UNKNOWN
eReaderBooksManagementFTEShown UNKNOWN UNKNOWN
SyncWarningDialogShown UNKNOWN UNKNOWN
SyncRequiredDialogShown UNKNOWN UNKNOWN
SubsCancelledDialogShown UNKNOWN UNKNOWN
OverDriveExpiryDialogShown UNKNOWN UNKNOWN
KoboPlusWishlistDialogCount UNKNOWN UNKNOWN
KoboPlusUpgradedPreviewCount UNKNOWN UNKNOWN
KoboPlusWishlistDialogShown UNKNOWN UNKNOWN
AddedToMyWordsDialogShown UNKNOWN UNKNOWN
KoboPlusPromoShown UNKNOWN UNKNOWN
LastSearchType UNKNOWN UNKNOWN
SmartLink UNKNOWN UNKNOWN
SmartLinkMessage UNKNOWN UNKNOWN
MostRecentReadID UNKNOWN UNKNOWN
VisitedFrontLightLearnMore UNKNOWN UNKNOWN
VisitedUserGuide UNKNOWN UNKNOWN
ReadingSettingsChanged UNKNOWN UNKNOWN
LargePrintFontScale UNKNOWN UNKNOWN
LargePrintMode UNKNOWN UNKNOWN
LastLibraryTab UNKNOWN UNKNOWN
MissingBookWizardPage UNKNOWN UNKNOWN
AcsmReminder UNKNOWN UNKNOWN
QuickTurnHoldTimer UNKNOWN UNKNOWN
MM8652PLCount UNKNOWN UNKNOWN
lockedOrientation UNKNOWN UNKNOWN
firstRotateDone UNKNOWN UNKNOWN
SubscriptionPlanAbTestEnabled UNKNOWN UNKNOWN
DuplicateAnnotationsCleanedUp UNKNOWN UNKNOWN
ExtraLocales UNKNOWN UNKNOWN

[edit] [DeveloperSettings]

[edit] Working with latest firmware - 4.25

Option Name Summary Status
AutoUsbGadget Automatically accepts the "Computer detected" popup when plugged into a computer. WORKING
ShowKeyboardTaps Shows a small dot above the precise place where the virtual keyboard was tapped. WORKING
ForceAllowLandscape Enables the rotation menu on all devices, even for those which do not officially support it. WORKING 4.37
EnableDebugServices Enables a GUI for changing many of the developer settings, which can be found under the "Device Information" section of Settings. This can also be activated by typing 'devmodeon' in the settings. In addition, this enables a telnet server and writes logs to the ".kobo" directory. WORKING
ForceWifiOn Forces the WiFi connection to always remain connected, regardless of how long the device has been inactive for. WORKING

[edit] Not working with recent firmware/Unknown

Option Name Summary Status
IgnoreSSLErrors UNKNOWN UNKNOWN
GeoClientIP UNKNOWN UNKNOWN
EnableInspector UNKNOWN UNKNOWN
WebPlatformId UNKNOWN UNKNOWN
DumpWebStoreHtml UNKNOWN UNKNOWN
LogThreadNames UNKNOWN UNKNOWN
ShowWidget UNKNOWN UNKNOWN
ShowKanaData UNKNOWN UNKNOWN
DisablePM UNKNOWN UNKNOWN

[edit] [DialogSettings]

[edit] Working with latest firmware - 4.25

Option Name Summary Status
ReleaseNotesShown This option will be set to true once the release notes for the current firmware been shown. Removing it or setting it to false will show them again. WORKING
NewQuickTurnDialogShown This option will be set to true once the dialog showing how to use fast page turning has been shows. Removing it or setting it to false will show it again. WORKING


[edit] Not working with recent firmware/Unknown

Option Name Summary Status
FirstPurchaseCreditJitShown UNKNOWN UNKNOWN
TasteProfileJitShown UNKNOWN UNKNOWN
KoboPlusUpgradeBannerShown UNKNOWN UNKNOWN
ReturningReaderDialogShown UNKNOWN UNKNOWN

[edit] [GeneralSettings]

[edit] Working with latest firmware - 4.25

Option Name Summary Status
AnnotationsRecentSearches Stores the recent searches in the Annotations category. WORKING
ArticlesRecentSearches Stores the recent searches in the My Articles category. WORKING
DictionaryRecentSearches Stores the recent searches in the Dictionary category. WORKING
LibraryRecentSearches Stores the recent searches in the My Books category. WORKING
StoreRecentSearches Stores the recent searches in the Kobo Store category. WORKING

[edit] Not working with recent firmware/Unknown

Option Name Summary Status
selectionForceBlackText UNKNOWN UNKNOWN
scrambleHighScores UNKNOWN UNKNOWN
timeZoneOffset UNKNOWN UNKNOWN
proxyUrl UNKNOWN UNKNOWN


[edit] [Reading]

[edit] Working with latest firmware

Option Name Summary last tested
readingFontFamily Stores the name of the most recently used font in the reader. 4.25+
swipeBrightness Controls the setting "Swipe left edge to adjust brightness". 4.25+
numPartialUpdatePageTurns Controls the setting "Refresh the screen every". WORKING
readingFontSize Stores the value of the most recently used font size in the reader. 4.32
readingLineHeight Stores the value of the most recently used line height in the reader. 4.32
readingLeftMargin Stores the value of the most recently used margin in the reader. This is set to the same value as the right margin, however they can be changed individually. 4.32
readingRightMargin Stores the value of the most recently used margin in the reader. This is set to the same value as the left margin, however they can be changed individually. 4.32
readingFontSharpness Stores the value of the most recently used font sharpness in the reader. This option used to have a graphical option in older firmwares, however currently it can only be set by the config file. 4.25+
readingFontWeight Stores the value of the most recently used font weight in the reader. 4.25+
readingAlignment Stores the value of the most recently used alignment option (Left, Centered, Justified). 4.25+
chapterProgressType Controls the setting "Header". 4.32
newBookProgressType Controls the setting "Footer". 4.25+
showProgressBar Controls the setting "Show book progress bar". 4.25+
readingAdobeShowPageNumbers Controls the setting "Show Adobe EPUB page numbers". 4.32
disableDoubleTap Disables the image viewer which appears when double tapping an image in a Kobo EPUB or Pocket article. 4.25+
disableQuickTurn Disable the fast page turning in a Kobo EPUB or Pocket article. 4.32+
showNoteIndicators false disables the icon next to highlights that include annotations in the kepub reader 4.25+
webkitTextRendering optimizelegibility enables kerning (in kepub?) [2] [3] added 4.32?
pageTurningOption Controls the setting "Onscreen Control". Values seems to be "default", "option1", "option2" and "option3". 4.35
pageTurnGesture Controls the setting "Page forward and backward by:". Values seems to be "0" or "1" for Tapping and Swiping, "2" for Swiping only. 4.35

[edit] Not working with recent firmware/Unknown

Option Name Summary Status
excludeEndMatterFromStats UNKNOWN UNKNOWN
readingMenuState UNKNOWN UNKNOWN
annotationsViewStyle UNKNOWN UNKNOWN
highQualityDithering UNKNOWN UNKNOWN
pinchToZoom UNKNOWN UNKNOWN
WaterDetection UNKNOWN UNKNOWN
WaterDialog UNKNOWN UNKNOWN
readingColumnCount UNKNOWN UNKNOWN
disableForcedGC16 UNKNOWN UNKNOWN
disableRegal UNKNOWN UNKNOWN
disableHyphenation UNKNOWN UNKNOWN
deleteVolumeOnFinished UNKNOWN UNKNOWN
invertPageTurnButtons UNKNOWN UNKNOWN

[edit] [PowerOptions]

[edit] Working with latest firmware - 4.25

Option Name Summary Status
UnlockEnabled Controls whether the "Swipe to Unlock" screen is shown when waking the eReader. WORKING
FrontLightLevel Stores the value of the last used frontlight level as a percentage. It only accepts integers. WORKING
FrontLightState Is true when the frontlight is turned on, false when it is not. WORKING
AutoOffMinutes Controls the setting "Automatically power off after". Value can be an integer between 1 and 255. WORKING
AutoSleepMinutes Controls the setting "Automatically go to sleep after". Value can be an integer between 1 and 255. WORKING
ShowBookCover Controls the setting "Show current read". WORKING
FullscreenCoverStretch Controls the setting "Show book covers full screen". WORKING
FullscreenCoverInfoPanel Controls the setting "Show info panel on full screen covers". WORKING
SleepAccessoryEnabled Controls the setting "Automatically sleep and wake up". WORKING

[edit] Not working with recent firmware/Unknown

Option Name Summary Status
IndicatorCharging UNKNOWN UNKNOWN
AmbientLightSensorEnabled UNKNOWN UNKNOWN
LowLightBrightnessInput UNKNOWN UNKNOWN
AutoBrightnessInput UNKNOWN UNKNOWN
BrightLightBrightnessInput UNKNOWN UNKNOWN
ColorSetting UNKNOWN UNKNOWN
BedTime UNKNOWN UNKNOWN
AutoColorEnabled UNKNOWN UNKNOWN
TurnOffLightInBrightSunlight UNKNOWN UNKNOWN
UnlockTimeout UNKNOWN UNKNOWN
Personal tools
Namespaces

Variants
Actions
Navigation
MobileRead Networks
Toolbox