====== TCTorrent для Total Commander ====== TCTorrent — это совмещенный WLX/WDX/WCX (только просмотр структуры файлов) плагин для работы с файлами .torrent. Эта реализация использует другой подход к визуализации содержимого файла (в отличие от предыдущих реализаций). Все части полностью поддерживают Юникод. ===== Требования ===== Плагин тестировался на Total Commander начиная с версии 8.5. В настоящее время тестируется под Windows 10 (x64), но должен полноценно работать начиная минимум с Windows XP. ===== Установка ===== Просто откройте **wlx_wdx_tctorrent_xxx.zip** в Total Commander для запуска автоматической установки. ===== Использование ===== Конфигурирование колонок в Total Commander смотрите в документации к программе. Вы можете выбрать: * Название * Число файлов * Общий размер * Размер блока * Число блоков * Трекер ("Полный" и "Только хост") * Дата создания * Хэш SHA * Программа * Комментарий * Кодировка * Приватный * Многофайловый * Издатель * Ошибки (содержит данные, если при загрузке файла произошла ошибка) * Число пропущенных (число пропущенных неподдерживаемых полей) * URL издателя В части просмотра вы можете использовать контекстное меню для копирования только данных либо всей строки с форматированием и дополнительной информацией. Работает поиск. Экспорт позволяет извлекать значки, но для их преобразования нужен установленный GDI+. Если у вас хотя бы WinXP, он у вас скорее всего уже установлен. Значки в HTML будут видимы только в современных браузерах, IE6 не входит в их число, извините. ===== Горячие клавиши ===== * Ctrl+A — выделить всё * Ctrl+C — копировать данные (без заголовков) * Shift+Ctrl+C — копировать всё (включая заголовки) * Shift+Ctrl+Down — развернуть все папки * Shift+Ctrl+Up — свернуть все папки * Ctrl+E — экспорт HTML * Ctrl+D — открыть текущий торрент в связанном (или пользовательском) клиенте * Ctrl+O — опции * Ctrl+Z — развернуть/свернуть секцию "Дополнительно" * Ctrl+G — открыть URL в выделенной строке (если есть) в браузере Специальная горячая клавиша Shift+Ctrl+D, действие аналогично Ctrl+D, но значение специальной переменной %TD меняется на путь в целевой панели. Аналогичного результата можно достигнуть удерживая Shift во время нажатия соответствующего пункта меню или клику по секции статусной панели. ===== Опции ===== Разъяснение некоторых опций, которые могут быть неочевидны. **Стили -> Группы расширений** --- здесь вы можете определить группы расширений. После этого ваша группа появится в списке доступных стилей, где вы можете задать их собственный цвет. **Magnet -> Шаблон для отображения** --- здесь вы можете ввести текст, который будет виден при просмотре (ссылка все равно останется полной). В этом тексте вы можете использовать следующие переменные: * %HS — Хэш SHA1 * %HB — Хэш BASE32 * %N — имя торрента * %T — трекер * %S — размер **Клиент -> Пользовательский торрент-клиент** --- вы можете использовать здесь собственный торрент-клиент (например портабельный). В обоих полях вы можете использовать переменные окружения (например %COMMANDER_PATH%). В поле параметров могут подставляться следующие переменные: * %P — полный путь к файлу торрента * %F — родительский каталог файла торрента * %T — целевой каталог (противоположный каталогу с файлом торрента) * %L — список файлов, выделенных в окне просмотра (ANSI) * %UL — список файлов, выделенных в окне просмотра (UTF-16) * %V:ИмяСвойства — вставляет значение свойства торрента. Допустимые имена свойств (регистр значения не имеет): Name, TotalSize, FileCount, BlockSize, BlockCount, FirstTracker, Created, Creator, Hash, Comment, Encoding, Webseed, Multifile, PrivateTorrent, Publisher, PublisherURL. Например: %V:TotalSize вставит общий размер файлов торрента. * %TD — специальная переменная, возвращает исходный или целевой каталог в зависимости от нажатой горячей клавиши (см. раздел горячих клавиш). Также реализована поддержка некоторых специфических возможностей для консольного torrent-клиента [[https://github.com/aria2/aria2/releases|aria2]] ([[https://aria2.github.io/manual/ru/html/aria2c.html|справка по параметрам командной строки]]): * %AI — %%список индексов файлов в торренте, выделенных в окне просмотра в виде " --bt-remove-unselected-file=true --select-file=" (с пробелом перед ключом). Если список пустой, параметр заменяется пустой строкой, " --bt-remove-unselected-file=true --select-file="%% не выводится. Пример использования: ''%% -q -c -Z --no-conf --bt-enable-lpd=true --console-log-level=error --seed-time=0 --summary-interval=0%AI --file-allocation=none --no-file-allocation-limit=20000M --always-resume=true --stream-piece-selector=geom -d "%F" "%P" %%'' ===== Опции, изменяемые правкой ini-файла ===== **MarginLeft** — левый отступ. По умолчанию 3. **AdditionalInfoSeparator** — строка, содержащая один или более символов разделителя дополнительных данных, по умолчанию "->". ==== Подмена доменов для ссылок ==== Для замены одного домена на другой при клике на ссылки создайте в ini-файле секцию **[Mirrors]** с парами значений ИмяДомена=ИмяЗеркала. Например: [Mirrors] domain.com=mirror.com В этом случае при клике на ссылку **%%http://domain.com/topic123.html%%** будет открыта ссылка **%%http://mirror.com/topic123.html%%** ===== История версий ===== Version 2.1.4 (2023--) + Добавлена онлайн-справка, оффлайн-справка теперь генерируется на её основе - WDX: Парсер некорректно работал на файлах с дополнительными данными (хэш ed2k и т. д.) + WLX: Для пользовательского клиента добавлены параметры %T, %TD Version 2.1.3 (2021-07-27) + WLX: Для пользовательского клиента добавлена возможность вставки большинства свойств торрента в командную строку + WDX: Добавлена колонка "Publisher URL" - WLX: Исправлен AV при загрузке некоторых служебных файлов, создаваемых Transmission - WLX: Исправлено неправильное родительское окно для диалога сохранения при экспорте - WLX: Исправлен AV при нажатии "отмена" в диалоге сохранения при экспорте под x64 Version 2.1.2 (2020-09-18) - WLX: Исправлена высокая загрузка процессора на некоторых торрентах Version 2.1.1a (2019-08-16) + Обновлен украинский перевод (спасибо YuriPet) Version 2.1.1 (2019-08-09) - Исправления в справке (спасибо Flasher) - WLX: Исправлена работа с зеркалами * WLX: При запуске клиента в нормальном/свернутом состоянии окно Листера/TC не теряет фокус Version 2.1.0 (2019-07-24) * Список изменений смотрите в истории бета-версий Version 2.0.7 (2019-07-19) beta + WLX: Опция разворачивания нестандартной информации при запуске - WLX: Исправление отображения нестандартной информации * WLX: Для клиента еще раз изменена работа параметра %AI Version 2.0.6 (2019-07-17) beta * WLX: Для клиента изменена работа параметра %AI + WLX: Для клиента возможность запуска в свернутом/развернутом/спрятанном виде + WLX: Поддержка языкового файла в любых юникодных кодировках + WLX: Поддержка пустых переменных окружения для клиента Version 2.0.5 (2019-06-20) beta + WLX: Поддержка зеркал для ссылок (ini) + WLX: Поддержка путей клиента относительно пути каталога плагина + WLX: %AI в параметрах клиента создает список индексов файлов (для aria2) + WLX: %F в параметрах клиента для родительского пути к файлу торрента + WLX: %UL в параметрах клиента создает юникодный список - WLX: Исправлено падение TC при наличии %L в параметрах клиента Version 2.0.4 (2019-03-31) beta + WDX: Добавлено поле с числом полей, не поддерживаемых плагином + WLX: Добавлен просмотр нестандартных полей для файлов + WLX: Улучшен просмотр нестандартных полей, теоретически, должны показываться все доступные поля + Добавлена поддержка большего числа полей с суффиксом .utf-8 (старый BitComet) + WLX: Поддержка publisher и publisher-url + Парсер теперь должен быть более толерантен к повреждениям структуры - WLX: Исправлено раскрытие элементов при поиске + WLX: Протокол ed2k:// теперь должен определяться как ссылка - WLX: Исправлена неправильная кодировка в нестандартных полях - WCX: Исправлен размер для файлов > 4Gb Version 2.0.3 (2019-03-24) beta * Wdx-версия отдельно больше выкладываться не будет (в этом уже нет смысла) * Файлы перевода теперь в Юникоде + Добавлена простая функциональность WCX (просмотр структуры файлов) - WLX: исправлена неправильная кодировка в некоторых комментариях (возможно в других секциях тоже) * Шрифт по умолчанию MS Sans Serif изменен на Microsoft Sans Serif (юникодный) + Поиск может производиться с применением опций "слово целиком", "в обратном порядке" и "учитывать регистр" - Исправлен поиск, также ищет в заголовках (папках) + WLX: Статусная строка показывает статус загрузки торрента (успешно или с ошибками) + Parser: Перевод ошибок + Немного переделано отображение ошибок (показываются в списке, без всплывающих окон) + Parser: Будет пытаться исправить некоторые некорректные файлы для их отображения - Parser: Поддерживается случай, когда "announce-list" фактически не список, а строка - WLX: Практически устранено мерцание списка Version 2.0.2 (2012-04-03) + Добавлен венгерский перевод (спасибо Bluestar) - Parser: Исправлена ошибка на некоторых торрентах с сегментом "url-list" Version 2.0.1 (2011-11-29) * Обновлен украинский перевод (спасибо Maximus) - Parser: Исправлена ошибка на некоторых торрентах с большими текстовыми блоками Version 2.0.0 (2011-11-11) * WDX: Объединены поля "Трекер" и "Трекер (хост)" (использованием единиц) Version 1.0.22 (beta) (2011-11-10) + Parser: Добавлены более информативные сообщения об ошибках - WDX: Исправлено разделение тысяч на некоторых локалях - WLX: Дублирующийся текст в строках, где ссылка находится в конце текста - Parser: Исправлена ошибка на файлах с поврежденным сегментом "announce-list" - Parser: Исправлена ошибка с чтением отрицательных целых чисел Version 1.0.21 (beta) (2011-11-09) + WLX: Шаблон для отображения магнита + WLX: Наконец (?) исправлена ширина текста * WLX: Убрана опция для укорачивания магнита (теперь шаблон) Version 1.0.20 (beta) (2011-11-08) + WLX: Опция для укорачивания магнита при просмотре + WLX: Добавлен пункт меню "Копировать ссылку" * WLX: Убрано сочетание Ctrl+Click (теперь просто кликайте ссылку) * WLX: Убран пункт меню "Ссылки" - WDX: Неправильное отображение SHA1 - WLX: Исправлено положение, где появляется меню ссылок - WLX: Наконец исправлено вычисление ширины текста - WLX: Исправлено пропадание размера при включенной опции "Скрыть скобки" Version 1.0.19 (beta) (2011-11-03) + WLX: Настраиваемый цвет выделенных элементов + WLX: Добавлен левый отступ * WLX: Обновлен украинский перевод - WLX: Неправильная отрисовка отскроллированного окна - WLX: Исправлена (опять) установка максимальной ширины окна Version 1.0.18 (beta) (2011-11-02) + WLX: Подсветка ссылок в списке + WLX: Для размеров можно спрятать скобки - WLX: Не появлялся скроллбар, когда ширина информации > ширины файлов Version 1.0.17 (beta) (2011-10-25) + WLX: Ctrl+G переходит по ссылке в выделенной строке + WLX: При необходимости, будет появляться горизонтальный скроллбар - WLX: Исправлена неправильная detect string * WLX: Слегка увеличена скорость загрузки Version 1.0.15 (beta) (2010-12-27) + Парсер предпочтительно использует теги ***.utf-8, если они найдены + WLX: Добавлено перекодирование некоторых азиатских кодировок, если они корректно указаны в файле - WLX: Исправлено падение на некоторых испорченных торрентах - WLX: Исправлено копирование русского текста в буфер Version 1.0.14 (beta) (2010-12-25) + WDX: Задействована фоновая загрузка торрентов + WDX: Добавлен кэш для ускорения повторного просмотра Version 1.0.13 (beta) (2010-12-25) - WDX: Не считался размер для многофайловых торрентов - Различные исправления, связанные с обработкой UTF-8 - Поддержка Юникода была отключена * Изменен тип полей Multifile и Private в булевый + WDX: добавлено забытое поле Multiline Version 1.0.12 (beta) (2010-12-24) + WDX: Добавлено поле, выводящее только хост трекера (http://bt.tracker.org/announce -> bt.tracker.org) - WLX: Новые поля не добавлялись в список + WLX: Добавлено поле с Magnet-ссылкой + WLX: Добавлены различные горячие клавиши - WLX: Исправлена проблема, когда плагин блокировал переименование каталога, в котором был просмотренный торрент - WLX: Исправлен поиск русского текста + WLX: Поддержка Юникода для отображения. Надежно работает только с торрентами, реально закодированными UTF-8 + WLX: Добавлена поддержка Web-сидов + Добавлено поле "Многофайловый" * Флаг приватности теперь сделан отдельным полем * Поле "Дополнительно" убрано — все возможные в будущем дополнительные параметры будут в своих полях * Различные оптимизации скорости * Написан свой парсер торрент-файлов, скорость работы увеличилась в ~2 раза Version 1.0.11 (beta) (2010-07-08) + Добавлено перемещение полей в настройках с клавиатуры (Ctrl+Arrows) - Исправлены мелкие баги Version 1.0.10 (beta) (2010-07-06) + Добавлена возможность изменять порядок информационных полей + Добавлена возможность выбрать свой торрент-клиент - Исправлена невозможность перемещаться по элементам списка в опциях клавиатурой Version 1.0.9 (beta) (2010-06-30) + Расцветка файлов по расширениям Version 1.0.2 (2010-06-30) - Небольшое исправление языкового файла - Исправлен некорректный символ "e" в имени поля "Created". Если вы используете его, то поменяйте его в своих настройках. Version 1.0.1 (2010-06-26) - Исправлено падение wdx на файлах с юникодовыми именами, не имеющими связанного короткого имени (спасибо CheeseCake) Version 1.0.0 (2010-06-24) - Исправлено неверное отображение размеров при включенной опции "Разделитель тысяч" (спасибо za222) - Исправлена работа с клавиатурой при переходе на плагин в режиме Ctrl+Q (спасибо Den_Klimov) Version 0.93 (2010-03-14) + Испанский перевод (спасибо Jose Manuel Breto) - Исправлен перехват фокуса в режиме Ctrl+Q - Исправлено падение при нажатии Esc в режиме Ctrl+Q Version 0.92 (2009-12-16) + Украинский перевод интерфейса (спасибо Maximus) + Опция запоминать (или нет) путь экспорта * Диалог "о плагине" перемещен на страницу опций - Исправлен баг WLX, когда не отображался список трекеров на торрентах без сегмента "announce" Version 0.91 (2009-11-30) + Плагин пытается замаскировать пасскей при экспорте html (опционально) - Исправлена некорректная обработка списка трекеров, что приводило к задваиванию URL Version 0.90 (2009-11-20) + Ctrl+Click открывает URL, найденный в данных (если ссылок больше одной, выводится меню) + Имя торрента подставляется как имя файла экспорта + Плагин теперь не показывает название и значок клиента в статусе, если нет ассоциированного клиента * Стили сбрасываются в стандартные значения по отдельности * "Авто" высота строки теперь 0 вместо -1 (косметика) * Список трекеров выводится без дубликатов - Исправлено падение плагина на файлах с отсутствующим сегментом "announce" - Исправлено копирование русского текста в буфер обмена на системах без известного хака "c_1251.nls" Version 0.89 (2009-11-07) - Исправлена ошибка при переключении на другой плагин клавишей "4" - Исправлен перевод формы просмотра при выборе языка вручную Version 0.88 (2009-11-06) * Теперь экспорт производится в UTF-8 + Подтверждение перезаписи для экспорта + Возможность ручного задания высоты строки - Исправлен мелкий баг с определением URL - Исправлено отображение единиц в экспорте Version 0.87 (2009-10-29) + Добавлен простой экспорт в HTML (для экспорта значков требуется GDI+) Version 0.86 (2009-10-29) + Очень значительно увеличена скорость загрузки - Возможно исправлена проблема с падением на некоторых торрентах Version 0.85 (2009-10-28) * Увеличена скорость юникодной версии WDX + Юникодный WDX теперь действительно юникодный + Сброс настроек стиля в стандартные значения + Опция для раскрытия при запуске всех элементов + Счетчик файлов (может давать неверные значения на юникодных именах) - Исправлены случайные падения в юникодном WDX - Исправлено неверное вычисление положения разделителя в информационном блоке - Изменен парсер для возможности загрузки файлов с поврежденным сегментом "announce-list" Version 0.81 (2009-10-22) + Возможность ручного выбора языка в случае неверного автоопределения - Возможно исправлен баг с пропадающими значками Version 0.80 (2009-10-21) * TCTorrent.sample.ini больше не нужен, файл конфигурации создается автоматически * Некоторые ключи ini-файла изменились, рекомендуется удалить старый файл конфигурации перед использованием новой версии + Разделитель тысяч + Диалог настроек + Многострочные комментарии теперь действительно многострочные и могут быть развернуты - Исправлен метод получения языка - Исправлено неправильное поведение диалога "О плагине" Version 0.71 (2009-10-05) + Копирование примера конфигурации в рабочую копию, если она не найдена - Исправлено пропадание значка клиента после вызова окна "О плагине" - Исправлено два бага, связанных со сворачиванием/разворачиванием элементов Version 0.70 (2009-10-01) + Возможность использования больших значков + Добавлено обнаружение строк, сохраненных в ANSI + Значительно ускорена загрузка плагина + Пункты меню для сворачивания/разворачивания всех каталогов + Опция округления значений размера до целого + Сворачивание/разворачивание каталогов по Enter + Добавлена поддержка юникодных файлов для WDX * Изменен метод отображения прогресса загрузки - Исправлена функция поиска для случаев, когда открыто несколько окон Листера - Устранено мельтешение при клике правой кнопкой мыши - Исправлена работа с юникодовыми именами в WLX - Исправлено падение плагина на торренте с огромными комментариями Version 0.60 (2009-09-29) + Прогресс загрузки для торрентов с большим количеством файлов + Опция: отображение значков ассоциированных программ + Опции отображения размера (авто или фиксированные единицы) + Опция: состояние отображения дополнительной информации при запуске (скрыта или нет) + Возможность установить цвет и шрифты для различных элементов + Статусная строка + Скрытие/отображение информации и содержимого каталогов + Добавлено 3 параметра в WDX: Program name, Encoding и флаг Private + Окно стартует сфокусированным + Выравнивание размера - Исправлено некорректное отображение суммарных объемов каталогов - Исправлена совместимость с Universal Viewer Version 0.50 (2009-09-23) Первый релиз. ===== Благодарности ===== Christian Ghisler — за бесконечно мощный инструмент.\\ Maximus, YuriPet — украинский перевод\\ Jose Manuel Breto — испанский перевод\\ Bluestar — венгерский перевод ===== Лицензия ===== Плагин распространяется бесплатно. Разрешено включение в любые сборки Total Commander, персональные или публичные, при условии сохранения текста данного информационного файла.