OnlySQ Cloud Drive

[fakelag28]

OnlySQ Cloud Drive (https://github.com/fakelag28/onlysq-cloud-drive)​

OnlySQ Cloud Drive — это неофициальное кроссплатформенное приложение и CLI‑инструмент, который монтирует OnlySQ Cloud (безлимитное хранилище файлов «Telegram‑based») прямо в файловую систему:

- на Windows — как отдельный диск в Проводнике через WinFsp + winfspy;

- на Linux — как обычный каталог в файловой системе через FUSE3 + pyfuse3.

После настройки можно работать с облаком почти как с локальным хранилищем: загружать, скачивать, удалять файлы, копировать публичные ссылки и настраивать автозапуск после входа в систему.



https://i.yapx.ru/daQBw.png

https://i.yapx.ru/da2BT.png

​

Особенности


Кроссплатформенный CLI: одна команда `onlysq-drive` для Windows и Linux.

Локальный индекс и кэш: быстрый доступ к структуре файлов и повторным операциям.

SQLite внутри: без отдельной БД и без дополнительного сервера.

Автозапуск после входа в систему:
Windows — через Планировщик заданий;

Linux — через `systemd --user`.


Копирование публичной ссылки из контекстного меню.

Интеграция с файловыми менеджерами:
Windows — Проводник;

Linux — Dolphin, Nautilus, Nemo, Caja.


Поддержка боковой панели на Linux: Dolphin через FUSE mount options, GTK‑менеджеры через `x-gvfs-show` и GTK bookmarks.

Кастомная иконка диска на Windows.


Поддерживаемые платформы


Windows 10/11: монтируется как диск (по умолчанию `O:`), требуется WinFsp.

Linux: монтируется как каталог (по умолчанию `/run/media/$USER/OnlySQCloud` или `~/OnlySQCloud`), требуется FUSE3.


Требования


Python 3.10+ на обеих платформах.

WinFsp для Windows (устанавливается через `winget` или командой `onlysq-drive bootstrap`).

FUSE3 и пакеты `pyfuse3`, `trio` для Linux (устанавливаются командой `onlysq-drive bootstrap`).

Для Linux: один из инструментов буфера обмена — `wl-copy` (Wayland), `xclip` или `xsel` для команды `copy-link`.


Быстрый старт

Windows:

Код:






winget install -e --id WinFsp.WinFsp
pip install onlysq-drive
onlysq-drive setup --mount O: --label "OnlySQ Cloud"
onlysq-drive doctor




Linux:

Код:






onlysq-drive bootstrap
pip install onlysq-drive
onlysq-drive setup --mount ~/OnlySQCloud --label "OnlySQ Cloud"
onlysq-drive doctor




Основные команды CLI


`onlysq-drive mount` — смонтировать вручную.

`onlysq-drive doctor` — проверить состояние.

`onlysq-drive stats` — посмотреть статистику.

`onlysq-drive ls` — показать содержимое папки.

`onlysq-drive info ` — информация о файле.

`onlysq-drive pull ` — скачать файл.

`onlysq-drive rm ` — удалить файл.

`onlysq-drive copy-link ` — скопировать публичную ссылку.

`onlysq-drive purge --yes` — удалить локальные данные.


Где хранятся данные

Windows:


Конфиг: `%APPDATA%\OnlySQDrive\config.json`

Индекс: `%APPDATA%\OnlySQDrive\index.sqlite3`

Кэш: `%LOCALAPPDATA%\OnlySQDrive\cache`


Linux:


Конфиг: `~/.config/onlysq-drive/config.json`

Индекс: `~/.local/share/onlysq-drive/index.sqlite3`

Кэш: `~/.cache/onlysq-drive/files`




https://i.yapx.ru/daQCS.png

https://i.yapx.ru/daQDI.png

​

Репозиторий приложения — https://github.com/fakelag28/onlysq-cloud-drive

Установка из PyPI — https://pypi.org/project/onlysq-drive/

Это неофициальное приложение. Все права на бренд и платформу принадлежат OnlySQ.

[extrimator]

Не очень понял, зачем это вообще нужно, если Telegram уже через свои клиенты нормально файлы шерингуют. Зачем городить этот весь фреймворк с монтированием? Надёжность и скорость реально будут на уровне или просто дополнительная прослойка?

[myvin]

Честно, идея монтировать облако в виде диска звучит круто, но я бы не уверен, что это проще и быстрее обычного телеграмовского шаринга. Там где лишняя прослойка, там обычно и зависания могут быть. Может и удобно для тех, кто привык работать через проводник, но надежность и скорость – это другой вопрос. В любом случае, интересно бы попробовать, посмотреть как оно себя покажет на практике.