Skip to content

Kobar-Project/KoBox-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

KoBar Logo

KoBox (Dropzone) - KoBar Plugin

An accessible, temporary file dropzone right on your sidebar.

KoBar Ecosystem License


📌 Overview

KoBox (Dropzone) is a dedicated productivity plugin for the KoBar ecosystem. It acts as a quick "pocket" or temporary repository located directly on your always-on-top sidebar. You can easily drag and drop files from anywhere in your operating system into KoBox for temporary keeping, and open the folder with a single click.

✨ Features

  • Seamless Drag & Drop: Just drag any file onto the KoBox icon to instantly move it into your temporary dropzone. The UI provides dynamic visual feedback (scaling, tilt, and glow) during hover.
  • Robust File Handling: Automatically moves files into local storage. Incorporates a smart fallback strategy (Copy & Delete) to flawlessly transfer files across different disk partitions or drives if high-speed renaming fails.
  • One-Click Access: Click the dropzone icon to natively open the temporary directory in Windows Explorer or macOS Finder.
  • Autonomous Cleanup: Keep your storage clean! KoBox automatically purges unused temporary files based on your configuration (either aggressively wiping on application exit or safely deleting files older than 24 hours).
  • AppX / MS Store Virtualization Bypass: Seamlessly resolves true physical paths in Windows environments, ensuring correct directory resolution even when KoBar is abstracted within a Windows Store container.
  • Multi-Language Support: Localized in English and Turkish.

🛠️ Technical Architecture

KoBox gracefully bridges a fluid React frontend with a robust Electron backend:

  • React Frontend: Utilizes HTML5 Drag and Drop APIs directly on the sidebar buttons, managing dynamic UI states.
  • Electron IPC & Backend: Manages file system manipulations, including robust cross-drive copying mechanisms inside main.cts.
  • Path Virtualization Mitigation: Features a custom algorithm to reconstruct actual absolute paths deep within %LOCALAPPDATA% to counter AppX virtualization blockades.
  • Automated Lifecycle: Managed through Zustand and global React hooks that trigger IPC calls for synchronous directory cleanup.

📖 Developer Note: For a deeper dive into the kobox-drop event, cross-drive mitigations, AppX path resolution, and autonomous cleanup flows, check out the Technical Documentation included in this repository.

🚀 Installation

As part of the KoBar ecosystem, this plugin loads dynamically.

  1. Ensure you have the latest version of KoBar installed.
  2. Download the KoBox plugin package.
  3. Place the plugin folder into your KoBar plugins directory.
  4. Restart KoBar or reload the plugin registry.

✉️ Contact

For support or inquiries, you can contact us at hello@kobar.org.

KoBar.org


💛 Sponsors & Backers

If you find KoBar useful and want to support its ongoing development, consider backing the project through any of the platforms below:

Become a Patron Open Collective

About

An accessible, temporary file dropzone right on your sidebar. Drag files to store, click to open.

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors