Документация TCTorrent

# TCTorrent plugin for Total Commander 2.1.2

## Описание плагина

TCTorrent — это совмещенный WLX/WDX/WCX (только просмотр структуры файлов) плагин для работы с файлами .torrent. Эта реализация использует другой подход к визуализации содержимого файла (в отличие от предыдущих реализаций). Все части полностью поддерживают Юникод.

## Требования

Плагин тестировался на:

- Total Commander 8.5 под Windows 7 (x64)
- Total Commander 9.22 под Windows 10 (x64)

## Установка

Просто откройте wlx_wdx_tctorrent.zip в Total Commander для запуска автоматической установки.

## Использование

Конфигурирование колонок в Total Commander смотрите в документации к программе. Вы можете выбрать:

- Название
- Число файлов
- Общий размер
- Размер блока
- Число блоков
- Трекер ("Полный" и "Только хост")
- Дата создания
- Хэш SHA
- Программа
- Комментарий
- Кодировка
- Приватный
- Многофайловый
- Издатель
- Ошибки (содержит данные, если при загрузке файла произошла ошибка)
- Число пропущенных (число пропущенных неподдерживаемых полей)

В части просмотра вы можете использовать контекстное меню для копирования только данных либо всей строки с форматированием и дополнительной информацией. Работает поиск.

Экспорт позволяет извлекать значки, но для их преобразования нужен установленный 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 в выделенной строке (если есть) в браузере

## Опции

Разъяснение некоторых опций, которые могут быть неочевидны.

Группы расширений — здесь вы можете определить группы расширений. После этого ваша группа появится в списке доступных стилей, где вы можете задать их собственный цвет.

Magnet — Шаблон для отображения — здесь вы можете ввести текст, который будет виден при просмотре (ссылка все равно останется полной). В этом тексте вы можете использовать следующие переменные:

- %HS — Хэш SHA1
- %HB — Хэш BASE32
- %N — имя торрента
- %T — трекер
- %S — размер

Клиент — Пользовательский торрент-клиент — вы можете использовать здесь собственный торрент-клиент (например портабельный). В обоих полях вы можете использовать переменные окружения (например %COMMANDER_PATH%). В поле параметров могут подставляться следующие переменные:

- %P — полный путь к файлу торрента
- %F — родительский каталог файла торрента
- %L — список файлов, выделенных в окне просмотра (ANSI)
- %UL — список файлов, выделенных в окне просмотра (UTF-16)

Также реализована поддержка некоторых специфических возможностей для консольного torrent-клиента aria2 (справка по параметрам командной строки):

- %AI — список индексов файлов в торренте, выделенных в окне просмотра в виде " --bt-remove-unselected-file=true --select-file=<index>" (с пробелом перед ключом). Если список пустой, параметр заменяется пустой строкой, " --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.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 — венгерский перевод

## Лицензия

Copyright (c) 2009-2019 Dmitry Yudin

E-Mail: loopback@darkhost.ru

Плагин распространяется бесплатно.

А лицензии у нас все равно никто не читает :)