Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 

Repository files navigation

The Stash ✦

The Stash — это персональный файловый буфер для Windows. Небольшое прозрачное оверлей-окно, которое всегда висит поверх всех остальных приложений и работает как промежуточная полка: бросил туда файл, переключился в другое место, вытащил обратно.

Забудь про открытие проводника, захламление папки «Загрузки» и временные копии на рабочем столе.

screenshot

🚀 Фичи

  • ⚡ Мгновенный Drag-and-Drop: Перетаскивай files из любого места на The Stash. Они останутся там, пока ты не решишь, что с ними делать.
  • 📋 Умный Буфер Обмена (Ctrl+V): Вставляй текст или картинки прямо в окно! Программа автоматически создаст .txt или .png файл и положит его на полку.
  • 🗂️ Автосортировка: Файлы сами раскладываются по системным полкам (Изображения, Код, Архивы и т.д.) на основе расширения.
  • 🎨 Кастомные полки: Создавай свои полки с уникальными цветами и привязывай к ним определенные типы файлов.
  • 🔍 Глубокий поиск: Ищи не только по названию файлов, но и внутри текстовых документов (.txt, .md, .log, .csv).
  • 📦 Быстрый ZIP-архиватор: Упаковывай содержимое любой полки в ZIP-архив в один клик.
  • 👀 Продвинутые превью: Двойной клик открывает аккордеон с текстом или картинкой. Наведение на изображение показывает крупное превью без открытия файла.
  • ⏱️ Индикатор старения: Забыл про файл? Если он не открывался заданное количество дней, появится значок 🕓.
  • ↩️ Железобетонный Undo: Случайно удалил файл с полки? Нажми Ctrl+Z, и он вернется.
  • 🌙 Нативная темная тема: Поддержка эффекта Mica (Windows 11) и Acrylic Blur (Windows 10) без костылей и сторонних библиотек.

📦 Установка

The Stash поставляется в виде удобного инсталлятора, который всё сделает за тебя.

  1. Перейди в раздел Releases.
  2. Скачай последний TheStash_Setup.exe.
  3. Запусти установщик и следуй инструкциям (программа установится в Program Files и создаст ярлык).

Программа автоматически добавится в автозагрузку (по желанию) и будет тихо висеть в трее, ожидая твоего хоткея.


⌨️ Горячие клавиши

Действие Клавиша
Показать / скрыть окно Ctrl+Alt+Z (Глобальный хоткей, настраивается)
Вставить из буфера Ctrl+V (При фокусе на окне)
Удалить с полки Delete
Отмена удаления (Undo) Ctrl+Z
Быстрый поиск Ctrl+F
Переименовать файл F2 (При выделении одного файла)

🛠️ Как это работает (Workflow)

1. Добавление

Просто брось файл на окно. Рамка подсветится, и файл окажется на полке. Если ты скопировал кусок кода или скриншот, нажми Ctrl+V в The Stash — он сам создаст файл в локальном кеше (StashCache/) и положит его на полку.

2. Организация

Файлы автоматически сортируются: скрипты летят в «Код», пдфки — в «Документы». Нужно закрепить важное? Ставь 📌. Нужна пометка? Добавь заметку 📝.

3. Использование (Drag-out)

Схвати файл из The Stash и тащи куда угодно: в Telegram, Photoshop, или браузер. Киллер-фича: Если ты тащишь текстовую заметку, созданную через Ctrl+V, в мессенджер вставится сам текст, а не файл!

4. Режимы отображения

  • Компактный режим (▲): Сворачивает окно до узкой полоски, скрывая список файлов.
  • Edge Snapping: Придвинь окно к краю экрана, и оно начнет прятаться за него при уводе мышки.

⚙️ Стек и Архитектура

The Stash написан с упором на производительность и отсутствие зависимостей.

  • Платформа: C# 12, .NET 8.0, WPF (net8.0-windows).
  • UI/UX: Кастомные шаблоны контролов, WindowStyle=None, AllowsTransparency=True.
  • Оптимизация: Асинхронный поиск (Task.Run), LRU-кеш для превью изображений на 100 позиций, ограничение параллельного декодирования картинок через SemaphoreSlim.
  • IPC: Одиночный экземпляр (Single Instance) реализован через Mutex и EventWaitHandle — второй запуск просто вытягивает первое окно на передний план.
  • Zero Dependencies: 0 сторонних NuGet пакетов. Всё, включая DWM эффекты и глобальные хоткеи, написано на нативных WinAPI вызовах (P/Invoke).

🤝 Контрибьют

Нашли баг или есть крутая идея? Открывайте Issue или кидайте Pull Request.

Для запуска из исходников:

git clone [https://github.com/ktoto246/TheStash.git](https://github.com/ktoto246/TheStash.git)
cd TheStash
dotnet run --project TheStash

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages