ydiskarc: a command-line tool to backup public resources from Yandex.disk (disk.yandex.ru / yadi.sk) filestorage service

ydiskarc - программа, чтоб скачивать публичные раздачи с яндекс диска. Ибо родной клиент яндекс диска - чудовище. Да и оригинальная версия настоящего клиента https://github.com/ruarxive/ydiskarc не блещет продуманностью и удобством использования.

Contents

• 1   Main features
• 2   Отличия от оригинальной версии
  • 2.1   Исправления
  • 2.2   Дополнения
  • 2.3   Хорошо бы сделать
• 3   Installation
  • 3.1   Any OS
  • 3.2   Python version
• 4   Usage
• 5   Commands
  • 5.1   Sync command
  • 5.2   Full command

1   Main features

• Metadata extraction
• Download any public resource file or directory

2   Отличия от оригинальной версии

2.1   Исправления

• Ключа --update больше нет, подразумевается, что он всегда установлен. Оригинальная версия не качает вообще никаких файлов, если задать ключ --update. А если его не задавать, то, напротив, качает все файлы, в т. ч. уже скачанные. Более того, короткая версия этого ключа -u совпадала с таковой для главного ключа --url.
• Теперь она качает файлы с кавычками в именах. Да, в яндексе попадаются и такие.
• Теперь закачиваемые файлы имеют временное расширение, а затем переименовываются.
• Проверяет sha256 и размер файлов.
• Выдаёт предупреждение при ошибке скачивания файла, а не пишет втихаря эту ошибку прямо вместо скачиваемого файла.
• Теперь качает файлы с символами стирания (%3F) в именах! Не спрашивайте меня, откуда взялись такие файлы и почему яндекс, винда и линукс их позволяют. Этого нельзя понять, это можно только запомнить.
• Метаданные не пишутся на диск, ежели не указан ключ --nofiles (в противном случае пишутся только метаданные).
• Не виснет после спящего режима.
• Не вываливается при отсутствии ответа от сервера.

2.2   Дополнения

• Теперь можно закачивать не всю раздачу, а только одну папку, предоставляя url оной папки из браузера как параметр.
• Проставляет оригинальную дату у файлов.
• Рисует статистику при завершении, в т. ч. имена нескачанных файлов.

2.3   Хорошо бы сделать

• Возможность не заводить полный путь на диске. Ибо в раздачах порою встречаются аршинные пути, файлы по которым невозможно сохранить на диск (по крайней мере в винде).
• Проверить возможность скачивания по красивому url, а не только по закодированному процентами.
• Многопоточная закачка?
• Красивый индикатор прогресса? (сейчас он вроде как должен быть, но абсолютно не виден, подобно суслику)
• Починить режим -v.
• Повторное скачивание неудачных файлов и папок.
• Докачка и проверка того, что докачалось.

3   Installation

3.1   Any OS

Проверено в windows 10 и ubuntu 22.04:

$ git clone https://github.com/dining-philosopher/ydiskarc.git
$ cd ydiskarc
$ python3 setup.py build install

ну или

$ python3 setup.py build && sudo python3 setup.py install

3.2   Python version

Python version 3.6 or greater is required.

4   Usage

Synopsis:

$ ydiskarc [command] [flags]

See also python -m ydiskarc and ydiskarc [command] --help for help for each command.

5   Commands

5.1   Sync command

Synchronizes files and metadata from public resource of directory type to the local directory.

Extracts all files and metadata from "https://disk.yandex.ru/d/VVNMYpZtWtST9Q" resource to the dir "mos9maystyle"

$ ydiskarc sync --url https://disk.yandex.ru/d/VVNMYpZtWtST9Q -o mos9maystyle

Скачать всю раздачу:

$ ydiskarc sync --url https://disk.yandex.ru/d/ид_раздачи

Скачать одну папку:

$ ydiskarc sync --url "https://disk.yandex.ru/d/ид_раздачи/путь/ещё/путь"

(копируем url из браузера)

5.2   Full command

Downloads single file or directory. Single file downloaded with original file format. Directory downloaded as ZIP file with all files inside.

Downloads file from url "https://disk.yandex.ru/i/t_pNaarK8UJ-bQ" and saves it into folder "files" with metadata saved as "_metadata.json"

$ ydiskarc full --url https://disk.yandex.ru/i/t_pNaarK8UJ-bQ -o files -v -m

Команда ydiskarc full не проверялась.