Skip to content

README.md

Latest commit

 

History

History
69 lines (47 loc) · 2.25 KB

README.md

File metadata and controls

69 lines (47 loc) · 2.25 KB
Raw

Basket

Basket is a portable Windows utility that lets you collect multiple files and folders into a persistent basket, then independently drag each item to any destination or application without losing the other items.

Collect now. Decide where later.

What it does

  • Add files and folders by drag & drop or by browsing.
  • Items stay available across app restarts and Windows reboots.
  • Drag a single item out to a folder, browser upload field, email attachment area, chat or AI tool, or any app that accepts files.
  • A successful drop removes only that item. A cancelled drag keeps it.
  • removes the basket reference only. It never deletes the real file.
  • [Clear] empties the basket after confirmation. Real files are never touched.
  • Basket stores references (metadata) only, never file contents.
  • [INBOX] shows developer announcements (internet required). The core basket works fully offline.

Run from source

Requires Windows and Python 3.x.

pip install -r requirements.txt

Then double-click Launch.bat, or run:

python run.py

Build the portable release (no installer)

pip install pyinstaller
python -m PyInstaller --name Basket --onedir --noconsole run.py

Output lands in dist\Basket\. To finish the portable folder:

  1. Inside dist\Basket\, create a Launch.bat containing:

    @echo off start "" Basket.exe

  2. Copy GUIDE.txt into dist\Basket\.

  3. Zip the Basket folder inside dist\. That zip is the shippable product.

Never delete or move the _internal folder away from Basket.exe.

Runtime data

On first run, Basket creates a BasketData\ folder next to the executable (or next to run.py in development) and stores basket.json there. It contains basket metadata only: paths, names, types, timestamps. Real files are never copied into it.

AP / INBOX

Announcements are delivered read-only from the DTAP platform (Firebase Realtime Database + Firebase Storage). If the network is unavailable, Basket shows "Unable to load announcements." and continues working normally.

Disclaimer

This software is provided as-is, without any guarantees or warranty. We are not responsible for any loss, damage, or issues that may arise from using it. By using this software you accept this condition. If you do not agree, please do not use it.