pandoras-box/explorer-bookmarks
8
0
Fork 0
Code Issues Pull requests Projects Releases 5 Packages 2 Wiki Activity Actions
Save your File Explorer windows and tabs!
86 commits 1 branch 5 tags 328 KiB
  • Rust 48%
  • TypeScript 32.7%
  • Just 7.4%
  • Nushell 6.5%
  • Shell 3.1%
  • Other 2.3%
Find a file
Exact
David ee267c28ae
All checks were successful
Check / fmt + clippy + build + tests (push) Successful in 17s
Details
Merge pull request 'feat(justfile): add dev-clean / dev-clean-all teardown recipes' (#36) from feat/dev-clean-recipes into main 
Reviewed-on: #36
2026-06-13 19:47:46 +02:00
.claude - Two steps collapsed into one — RELEASE_ID is a plain shell variable in the same process, never touching 2026-04-02 19:25:50 +02:00
.devcontainer feat: Sync build process with other repos 2026-03-15 02:40:25 +01:00
.forgejo/workflows ci: update path-self-reference in build-windows.yml 2026-05-14 21:16:23 -04:00
.idea feat: Claude code review 2026-02-05 01:19:29 +01:00
oci-build chore: align with governance repo conventions 2026-05-14 21:06:13 -04:00
src fix(tests): serialize env-mutating apply_env tests 2026-06-07 10:40:24 -04:00
.gitignore chore: Sync .gitignore 2026-06-06 13:21:33 -04:00
build.rs chore: align with governance repo conventions 2026-05-14 21:06:13 -04:00
Cargo.lock fix(tests): serialize env-mutating apply_env tests 2026-06-07 10:40:24 -04:00
Cargo.toml Release v0.4.0 2026-05-14 21:31:37 -04:00
CLAUDE.md - Build Commands: replaced cargo build with cargo zigbuild --target x86_64-pc-windows-gnu for both debug and 2026-04-02 12:47:49 +02:00
justfile feat(justfile): add dev-clean / dev-clean-all teardown recipes 2026-06-13 12:51:51 -04:00
LICENSE.md chore: align with governance repo conventions 2026-05-14 21:06:13 -04:00
README.md - Prerequisites: msvc → gnu target, cargo-zigbuild link added 2026-04-02 17:55:36 +02:00

README.md

Explorer Bookmarks

Explorer Bookmarks is a tool that saves and restores Windows File Explorer windows.

Building

Prerequisites

Build Commands

# Release build for Windows (cross-compilation from Linux)
cargo zigbuild --target x86_64-pc-windows-gnu

# Or on Windows directly
cargo build --release

The compiled binary will be at target/x86_64-pc-windows-gnu/release/explorer-bookmarks.exe (cross-compilation) or target/release/explorer-bookmarks.exe (on Windows).

Usage

See the help output for full usage:

explorer-bookmarks --help

Basic Operations

# Save current Explorer windows
explorer-bookmarks

# Restore from a specific file
explorer-bookmarks path\to\bookmarks.txt

# Run as scheduled task (restores last saved bookmarks)
explorer-bookmarks task

Administrative Operations

These require running as Administrator:

# Install integration (right-click menu + scheduled task)
$ENV:EB_ACTION="install"; explorer-bookmarks

# Uninstall integration
$ENV:EB_ACTION="uninstall"; explorer-bookmarks

# Reinstall integration
$ENV:EB_ACTION="reinstall"; explorer-bookmarks

Environment Variables

Variable Description Default
EB_ACTION Administrative action: install, uninstall, reinstall, dev, help -
EB_INSTALL_PATH Installation path for the executable C:\ProgramData\TacticalRMM\Explorer-Bookmarks.exe
EB_SAVE_DIR Directory for bookmark files %USERPROFILE%\Documents\Explorer-Bookmarks
EB_SAVE_FILENAME_PREFIX Prefix for bookmark filenames ExplorerBookmarks
EB_SAVE_MAX_NUM_FILES Maximum bookmark files to keep (1-1000) 50
EB_RESTORE_MAX_FILE_SIZE Maximum file size to restore in bytes (1-16384) 4096
EB_RESTORE_MAX_WINDOWS Maximum windows to restore (1-100) 50
EB_RESTORE_DELAY_SECONDS Delay between opening windows (0-10) 0.5
EB_LOG_LEVEL Log level: error, warn, info, debug, trace warn
RUST_LOG Alternative log level setting -

Features

  • Save bookmarks: Captures all open File Explorer window paths
  • Restore bookmarks: Opens Explorer windows from a saved bookmark file
  • Deduplication: Automatically removes duplicate consecutive saves
  • File rotation: Keeps only the configured maximum number of bookmark files
  • Right-click integration: Adds "Restore my Explorer Bookmarks" to .txt file context menu
  • Scheduled task: Automatically restores bookmarks at login
  • Safety limits: Configurable limits on file size and window count to prevent accidental misuse
  • Tab support: Saves and restores multiple tabs within a single File Explorer window on Windows 11 22H2 and later. Falls back to single-window behavior on older versions.

License

MIT