reordermenus.koplugin

KO | EN

gitlite — search

#awesome #cross-platform #mysql #devops #graphql #chatbot #pytorch #video #pdf #open-source

reordermenus.koplugin

(★ 9)

KOReader plugin to reorder & hide menus

File Explorer

ZIP Download

- - taste.md
- architecture.md
- compatibility-matrix.md
- migration-policy.md
- testing.md
- atomic_writer.lua
- commit_pipeline.lua
- data_loader.lua
- ghost_gc.lua
- intent_store.lua
- koreader_adapter.lua
- materializer.lua
- menu_schema.lua
- menu_titles.lua
- menuorder_manager.lua
- native_writer.lua
- placement.lua
- plugin_prefs.lua
- presets.lua
- registry.lua
- semantic_diff.lua
- ui_compat.lua
- ui_editor_model.lua
- ui_editor_registry.lua
- ui_screens.lua
- unicode_fold.lua
- validator.lua
- visibility.lua
- release-manifest.conf
- menusorter-sorting-hint-nil-guard.patch
- 01-menu-order.png
- 02-submenu-order.png
- 03-submenu-actions.png
- 04-submenu-presets.png
- - failure_sig.lua
  - fuzz_lib.lua
  - runtime_world.lua
  - shrinker.lua
  - sm_world.lua
  - storage_safety_hostile.lua
  - subprocess_harness.lua
- mutation_test.lua
- probe_airbag_end_to_end.lua
- probe_anchor_stale.lua
- probe_b2b.lua
- probe_b2d.lua
- probe_b2e.lua
- probe_b2f.lua
- probe_b2g.lua
- probe_b2h.lua
- probe_b2trace.lua
- probe_bisect2.lua
- probe_bisect_views.lua
- probe_bug1.lua
- probe_bug2.lua
- probe_bug3.lua
- probe_classify.lua
- probe_cluster_detail.lua
- probe_custom_equiv.lua
- probe_default_order.lua
- probe_delguard.lua
- probe_df1466206.lua
- probe_df_batch.lua
- probe_dumpfmt.lua
- probe_e_durability.lua
- probe_e_edge.lua
- probe_e_edge2.lua
- probe_e_edge3.lua
- probe_e_reset_sweep.lua
- probe_first_double.lua
- probe_fuzz_dump.lua
- probe_fuzz_exact.lua
- probe_g_filetrace.lua
- probe_g_surfaces.lua
- probe_historical_dense.lua
- probe_historical_dense2.lua
- probe_io_fault_sm.lua
- probe_kohome.lua
- probe_m2b.lua
- probe_m2c.lua
- probe_m2d.lua
- probe_m2e.lua
- probe_m2f.lua
- probe_m2g.lua
- probe_m2h.lua
- probe_m2iso.lua
- probe_m45.lua
- probe_m4b.lua
- probe_m5b.lua
- probe_m5c.lua
- probe_m5d.lua
- probe_m5e.lua
- probe_m5f.lua
- probe_m7dbg.lua
- probe_m7diff.lua
- probe_mirror_hij.lua
- probe_mirror_hij2.lua
- probe_mirror_hij3.lua
- probe_n5.lua
- probe_n5seq.lua
- probe_n5seq2.lua
- probe_n5seq3.lua
- probe_n5seq4.lua
- probe_n6.lua
- probe_n6_txn_race.lua
- probe_n6b.lua
- probe_n_i6.lua
- probe_n_unhide.lua
- probe_n_unhide2.lua
- probe_n_unhide3.lua
- probe_nightmode.lua
- probe_p1c.lua
- probe_p4_migration.lua
- probe_p4b.lua
- probe_p4e.lua
- probe_p7dbg.lua
- probe_p7full.lua
- probe_reorder_hidden.lua
- probe_replay13.lua
- probe_replay_stability.lua
- probe_reset2.lua
- probe_reset3.lua
- probe_reset4.lua
- probe_reset5.lua
- probe_reset6.lua
- probe_reset7.lua
- probe_reset8.lua
- probe_resetcustom.lua
- probe_restart_reconcile.lua
- probe_seed23757.lua
- probe_selfref_hang.lua
- probe_semantic_compare.lua
- probe_sep_double.lua
- probe_seq13.lua
- probe_seq13b.lua
- probe_seq13c.lua
- probe_seq_trace.lua
- probe_shared_table_cycles.lua
- probe_shared_table_cycles2.lua
- probe_sorting_hint_matrix.lua
- probe_stale2.lua
- probe_stale_container_and_cycles.lua
- probe_steptrace.lua
- probe_strand.lua
- probe_strand2.lua
- probe_strand3.lua
- probe_t7anchor.lua
- probe_t7b.lua
- probe_t7c.lua
- probe_t7d.lua
- probe_tab_unhide_paths.lua
- probe_taps.lua
- probe_trigger_scan.lua
- probe_triple_fixture.lua
- probe_unhide2.lua
- probe_unhide_sep.lua
- probe_unhide_setting.lua
- probe_w5.lua
- probe_w_ghosts.lua
- probe_w_ghosts2.lua
- probe_w_ghosts3.lua
- probe_w_ghosts4.lua
- run_all.sh
- run_crash_pipeline.sh
- run_n5_repeat.sh
- run_storage_safety_hostile.sh
- run_tier.sh
- test_anchor_noop_residue.lua
- test_close_route_equivalence.lua
- test_collision_lifecycle_full.lua
- test_conditional_items.lua
- test_contradictory_determinism.lua
- test_contradictory_native.lua
- test_corrupt_canonical_intent.lua
- test_crash_pipeline.lua
- test_cross_view_partial_failure.lua
- test_custom_menu_lifecycle.lua
- test_custom_submenus.lua
- test_differential_fuzz.lua
- test_dirty_state_equivalence.lua
- test_disable_revert_lifecycle.lua
- test_drag_index_mapping.lua
- test_external_edit_lifecycle.lua
- test_external_top_level_plugin_menus.lua
- test_gen1_determinism.lua
- test_generation_precedence.lua
- test_ghost_isolation.lua
- test_ghost_tombstone_scale.lua
- test_guard_composition.lua
- test_hidden_display_mode.lua
- test_hint_guard_recovery.lua
- test_hint_migration.lua
- test_historical_fixtures.lua
- test_import_inference_gaps.lua
- test_insert_menu_singleton.lua
- test_insertion_order_hunt.lua
- test_interacting_sequences.lua
- test_io_failure_injection.lua
- test_koreader_contract.lua
- test_koreader_integration.lua
- test_live_top_level_tab_editor_filter.lua
- test_localization_identity.lua
- test_malformed_native.lua
- test_malformed_targets_and_airbag.lua
- test_materializer_determinism.lua
- test_menu_lifecycle_matrix.lua
- test_menusorter_differential_fuzz.lua
- test_minimal_import.lua
- test_mirror_failure_matrix_gaps.lua
- test_mirror_partial_failure_contracts.lua
- test_mirroring.lua
- test_module_namespace_isolation.lua
- test_multi_external_edits.lua
- test_multiprocess_restart.lua
- test_native_deletion_while_disabled.lua
- test_native_semantic_roundtrip.lua
- test_nested_editor_txn.lua
- test_noop_and_sparse_purity.lua
- test_notify_after_durable_success.lua
- test_p0_commit_pipeline.lua
- test_p0_corruption_backup.lua
- test_p0_editor_consistency.lua
- test_p0_fault_matrix.lua
- test_p0_loaders_and_presets.lua
- test_p0_metadata_ownership.lua
- test_p0_spent_txn_gate.lua
- test_p1a_canonical_invariants.lua
- test_p1a_canonical_state.lua
- test_p1a_schema_migration.lua
- test_p1b_preset_semantics.lua
- test_p2_persistence_hygiene.lua
- test_p2_pure_model.lua
- test_pairwise_matrix.lua
- test_persistence_restart.lua
- test_plugin_absence_fuzz.lua
- test_plugin_removal_lifecycle.lua
- test_popular_plugins_top50.lua
- test_preset_captures_tab_draft.lua
- test_preset_futures.lua
- test_preset_ghost_lifecycle.lua
- test_preset_robustness.lua
- test_preset_sparse_semantics.lua
- test_preset_unsaved_editor_state.lua
- test_preset_update_and_new_items.lua
- test_presets.lua
- test_projection_determinism.lua
- test_projection_restart_equivalence.lua
- test_protection_and_inactive.lua
- test_provider_identity.lua
- test_provider_semantic_reuse.lua
- test_reentrancy.lua
- test_registration_order_determinism.lua
- test_regressions_generated.lua
- test_regressions_promoted.lua
- test_release_install_smoke.lua
- test_removal_safety_policy.lua
- test_reordering.lua
- test_reset_after_stage_regression.lua
- test_reset_all_gc.lua
- test_reset_metamorphic.lua
- test_restart_prompt.lua
- test_restore_default_placement.lua
- test_save_reload_failure.lua
- test_schema_migration.lua
- test_self_absence_contract.lua
- test_self_reachability.lua
- test_semantic_diff_unit.lua
- test_semantic_ordering_unit.lua
- test_serialization_torture.lua
- test_staged_exit_and_commit_crash.lua
- test_stale_editor_provider_churn.lua
- test_stale_editor_revert.lua
- test_state_machine.lua
- test_state_machine_verbs.lua
- test_stock_slot_insertion.lua
- test_storage_resilience.lua
- test_storage_safety.lua
- test_structural_matrix.lua
- test_submenu_arrow_nav.lua
- test_submenu_safety.lua
- test_tab_placement_safety.lua
- test_targeted_interactions.lua
- test_three_way_fuzz.lua
- test_tombstone_gc.lua
- test_top_plugins_compatibility.lua
- test_transaction_contract.lua
- test_txn_concurrency.lua
- test_ui_flows.lua
- test_ui_i18n_robustness.lua
- test_ui_move_hide_plugin.lua
- test_ui_robustness.lua
- test_unhide_editor_flow.lua
- test_unsaved_close_prompt.lua
- test_upgrade_downgrade_matrix.lua
- test_upgrade_downgrade_upgrade.lua
- test_user_plugin_tab_hiding.lua
- test_view_lifecycle_soak.lua
- test_visibility_inheritance_regression.lua
- test_writer_version_upgrade.lua
.gitignore
_meta.lua
build_release.sh
main.lua
README.md
run_tests.sh

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Reorder, hide, move, and group KOReader menu items in both **Book view** and the **File Manager**, using KOReader's native interface.

## Features

- Customize Book view and File Manager independently, including nested submenus.
- Reorder and hide items, move items or submenus to valid destinations, and
  create custom submenus. Top-level tabs can be reordered or hidden.
- Save view layouts or direct/nested submenu presets.
- Reset an item, submenu, one view, or both views to stock defaults.
- Optionally mirror visibility changes and cross-menu moves between views
  when the item and destination exist in both. Other changes remain per-view.
- Let untouched items follow KOReader and plugin updates automatically.

## Installation

1. Download the latest `reorderingmenus-v<version>.zip` from the [Releases](https://github.com/nraikm/ReorderingMenus/releases) page.
2. Unpack the zip file.
3. Copy the `reorderingmenus.koplugin` folder into your KOReader `plugins/` directory (e.g. `koreader/plugins/reorderingmenus.koplugin`).
4. Restart KOReader.

## Editing menus

Open **Tools → More tools → Reorder menus**.

1. Drag entries to reorder them; tap a checkbox to hide or show an entry.
2. Open a submenu with the arrow at the row's trailing edge. You can also tap
   an already-selected submenu or hold it and choose **Edit submenu contents**.
   Nested editor titles show the path, such as `Book view › Tools › More tools`.
3. Use the top-left hamburger menu for search, hidden items, sorting, presets,
   custom submenus, resets, and advanced options.
4. Tap the bottom-right checkmark to save. The title marks unsaved changes;
   closing a changed editor offers **Save / Discard / Cancel**.

## Presets

**View presets** save the current Book view or File Manager layout. Open
**Presets…** in the top-level editor to save a named layout or apply a built-in
preset. View presets include explicit placement and visibility choices.

**Submenu presets** are available under **Presets for _menu name_…**:

- **Save this menu order…** (`[Direct]`) captures the immediate item sequence.
- **Save with nested submenu orders…** (`[Nested]`) also captures descendant orders.

Applying a submenu preset changes sequences while retaining existing visibility
settings and custom-created submenus.

## Disabling or uninstalling

**Disabling** Reordering Menus (via the plugin manager) automatically
returns Book view and File Manager menus to stock KOReader order on the
next menu build. Your custom layout is kept safely aside, so
**re-enabling** restores it exactly as it was.

**Uninstalling** (deleting the plugin folder) runs no plugin code, so use
the removal preparation tool first if you hid any top-level menus or tabs:

```text
Tools → More tools → Reorder menus → Hamburger → Advanced… → Prepare for plugin removal…
```

This unhides all items across both views, ensuring that stock KOReader and other third-party plugins can find their default menu destinations without issue when Reordering Menus is no longer active.

## Compatibility

- The automated integration baseline is KOReader
  `v2025.10-43-g562fc11_2025-11-28`. Other releases may work, but are not
  claimed supported until they pass the same suite. Private integration
  points are capability-gated where KOReader exposes a reliable probe; see
  the compatibility matrix before widening this window.
- Works entirely within user settings (`settings/reader_menu_order.lua`, `settings/filemanager_menu_order.lua`, `settings/reorderingmenus_intent.lua`) without patching core KOReader application files.

## Development

- [Architecture](docs/architecture.md): data flow, modules, state, and invariants.
- [Compatibility](docs/compatibility-matrix.md): integration boundaries and workaround removal.
- [Migration policy](docs/migration-policy.md): file versions and recovery rules.
- [Testing](docs/testing.md): suites, seed replay, fixtures, and release verification.

### Running Tests

Run the quick suite with the LuaJIT bundled with your KOReader installation:

```bash
./run_tests.sh
```

See the [Testing Guide](docs/testing.md) for targeted suites, scaled tiers,
seed replay, fixture handling, and release verification.

reordermenus.koplugin

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README