Skip to content

oanh5631/simpleui.koplugin

Repository files navigation

🛠️ simpleui.koplugin - Customizable UI for KOReader

Download simpleui.koplugin


📖 About simpleui.koplugin

simpleui.koplugin is a user interface plugin designed to improve your KOReader experience. It adds a home screen, bottom navigation bar, top bar, and desktop modules or widgets. These features help you manage your ebooks more easily and customize your reading environment.

The plugin works on KOReader devices such as Kobo e-readers. It supports common formats and offers tools to organize your library with quick access to key functions. It is built with Lua, the language used by KOReader plugins.


✅ System Requirements

Before installing, please make sure your device meets these conditions:

  • Running KOReader on a compatible e-reader (Kobo or Kindle with KOReader installed)
  • KOReader version 2023 or later recommended
  • Device has at least 100 MB free storage space
  • USB connection or Wi-Fi access to transfer files
  • Windows PC to download and transfer plugin files

🚀 Getting Started

Follow these steps to get simpleui.koplugin up and running on your KOReader device using a Windows computer.


💾 Download simpleui.koplugin

Click the button below to visit the main page where you can download the plugin files:

Download simpleui.koplugin

This link takes you to the GitHub page. There is no direct download file, so you will find the latest plugin version under the "Releases" section or in the repository files.


🛠️ Installation Instructions

  1. Download Plugin Files

    • Open the GitHub page linked above.
    • Click on the "Releases" tab near the top of the page.
    • Download the latest release zip file. The name usually contains the version number, such as simpleui.koplugin-v1.0.zip.
    • Save the downloaded file to your Windows PC.
  2. Extract the Files

    • Locate the downloaded .zip file in your Downloads folder.
    • Right-click the file and select "Extract All".
    • Choose a destination folder you can easily find, such as your Desktop or Documents.
  3. Prepare Your KOReader Device

    • Connect your e-reader to your Windows PC using a USB cable.
    • Your device should appear as a removable drive in File Explorer.
    • Open the KOReader folder on your device’s internal storage. This folder usually has a path like /KOReader/plugins or /koreader/plugins.
  4. Copy simpleui.koplugin to KOReader

    • Find the extracted folder named simpleui.koplugin on your PC.
    • Copy the entire folder.
    • Paste it inside the plugins folder on your device.
  5. Safely Disconnect Your Device

    • Use the Windows "Safely Remove Hardware" option.
    • Disconnect the USB cable once it is safe.

🔧 Setup on KOReader

  1. Start KOReader on your device.

  2. Open the Plugin Manager

    • From the main menu, look for the Plugins or Add-ons section.
    • You should see simpleui.koplugin listed.
  3. Enable the Plugin

    • Select simpleui.koplugin and activate it.
    • The plugin may require KOReader to restart. Confirm if prompted.
  4. Customize Your UI

    • Access the plugin settings through the KOReader interface.
    • Adjust the home screen, navigation bars, and widgets to your preference.
    • Changes take effect immediately or after restarting KOReader.

📝 Features Overview

  • Home Screen: A customizable page to organize your most used books and tools.
  • Bottom Navigation Bar: Quick access to main functions such as Library, Files, and Settings.
  • Top Bar: Displays useful information like battery status, time, and page number.
  • Desktop Modules/Widgets: Small tools you can place on screen, like clocks, bookmarks, or brightness controls.
  • Support for Multiple File Formats: Works with ebooks in EPUB, PDF, and MOBI.
  • Easy Plugin Management: Activate or deactivate without needing technical skills.

⚙️ Troubleshooting

  • If the plugin does not appear after installation, make sure it is copied exactly to the /plugins folder.
  • Verify KOReader is updated to a supported version.
  • Restart the device after enabling the plugin.
  • For missing features, check the plugin settings within KOReader.
  • Consult the README.md file inside the plugin’s folder for further instructions.

📚 Additional Resources


🔗 Key Links


🔍 How to Update simpleui.koplugin

  1. Check the GitHub page regularly for new releases.
  2. Download the updated version's zip file following the same process as the first install.
  3. Extract the new plugin folder.
  4. Replace the old simpleui.koplugin folder on your device with the new files.
  5. Restart KOReader to apply the update.

⚠️ Common Questions

Q: Can I use this plugin on Kindle devices?
A: This plugin is designed for KOReader, which can run on some Kindle models if KOReader is installed. Confirm KOReader works first.

Q: Do I need programming skills to use this?
A: No. The installation and use steps require only basic file management and KOReader menu navigation.

Q: Will this plugin affect my ebooks?
A: No. The plugin changes only the interface and does not modify your ebook files.


🛑 Uninstalling simpleui.koplugin

To remove the plugin:

  1. Connect your e-reader to your Windows PC.
  2. Open the KOReader plugins folder.
  3. Delete the simpleui.koplugin folder.
  4. Disconnect and restart KOReader to see it removed.

Releases

No releases published

Packages

 
 
 

Contributors

Languages