Total Commander

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== TCTorrent for Total Commander ======

TCTorrent — is content/lister/packer(file structure view only) plugin for working with .torrent files. This impementation have different approach to visualize torrent file content instead existing plugins. All parts are fully support Unicode.

=====Prerequisites=====

The plugin has been tested on Total Commander since version 8.5. Currently being tested under Windows 10 (x64), but should work fully from at least Windows XP.

=====Installation=====
Just open **wlx_wdx_tctorrent_xxx.zip** in Total Commander, this will install the plugin automatically. 

=====Usage=====
Please refer Total Commander documentation on how to configure columns. You can select:

  * Name
  * Files count
  * Total size
  * Block size
  * Block count
  * Tracker ("Full" or "Host only")
  * Created date
  * SHA hash
  * Program
  * Comment
  * Encoding
  * Private
  * Multifile
  * Publisher
  * Errors (contain the info about errors occured during parsing)  * Skipped Count (count of unsupported torrent file fields)
  * Publisher URL

In Lister part you can use context menu to copy either data only or whole info with formatting. If data have a links, they will appear in the context menu. Also search is working.

Export can have an icons too, but for converting them you need to have GDI+ installed. If you have at least WinXP, you most likely have it. Also, icons in resulting HTML will be visible in the modern browsers only, IE6 is out this list, sorry. 

=====Hotkeys=====

  * Ctrl+A — select all
  * Ctrl+C — copy data (without headers)
  * Shift+Ctrl+C  — copy all data (with headers)
  * Shift+Ctrl+Down — expand all folders
  * Shift+Ctrl+Up — collapse all folders
  * Ctrl+E — export HTML
  * Ctrl+D — open current torrent in associated (or custom) torrent client
  * Ctrl+O — options
  * Ctrl+Z — expand/collapse details section
  * Ctrl+G — run URL if it exists in the selected line

=====Options=====

Explanation of some non self-telling options:

**Styles -> Extension groups** — here you can define the groups of extensions. After you done that, your group will appear in the available styles list, and you can set it's own color.

**Magnet -> Template for magnet** — here you can enter the text that will be shown in the viewer (link itself still will be full). In this text you can use following substitutes:

  * %HS — SHA1 hash
  * %HB — BASE32 hash
  * %N — name
  * %T — tracker
  * %S — size

**Client -> Custom torrent client** — you can place here your own custom torrent client (for example portable one). In both fields you can use environment variables (for example %COMMANDER_PATH%). Paramaters field also accepts the following substitutes: 

  * %P — full path of current torrent file
  * %F — parent folder of current torrent file
  * %L — list with files selected in viewer (ANSI)
  * %UL — list with files selected in viewer (UTF-16)  * %V:PropName — inserts the value of torrent's property. Allowed property names (case-insensitive): Name, TotalSize, FileCount, BlockSize, BlockCount, FirstTracker, Created, Creator, Hash, Comment, Encoding, Webseed, Multifile, PrivateTorrent, Publisher, PublisherURL. For example: %V:TotalSize inserts total size of torrent's files.

Also added a support for some specific features for console torrent-client [[https://github.com/aria2/aria2/releases|aria2]] ([[https://aria2.github.io/manual/en/html/aria2c.html|help for commandline parameters]]):
  * %AI — %%list of indexes of files selected in viewer as " --bt-remove-unselected-file=true --select-file=<index>" (with leading space). If list is empty, parameter is replaced with an empty string, " --bt-remove-unselected-file=true --select-file=" is not in output.%%

Example:
''%%
-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-file only options=====

**MarginLeft** — left margin. Default is 3.

**AdditionalInfoSeparator** — string containing one ore more symbols for separator for additional data, by default "->".

====Domain substitution for links====
For substitute one domain to other when clicking on link, create in the ini-file **[Mirrors]** section with pairs of values DomainName=MirrorName. For example:

<code>
[Mirrors]
domain.com=mirror.com
</code>

In this case when clicking on link **%%http://domain.com/topic123.html%%** will be opened **%%http://mirror.com/topic123.html%%**

=====Version history=====

<code>
Version 2.1.4 (2023--)
+ Added online help, offline help is now generated based on it
- WDX: Parser breaks on files with additional data (ed2k hash, etc.)
+ WLX: %T, %TD parameters added for custom client

Version 2.1.3 (2021-07-27)
+ WLX: For custom client it's possible to insert most torrent properties into commandline
+ WDX: Added "Publisher URL" column
- WLX: Fixed AV when loading some service files created by Transmission
- WLX: Fixed export save dialog parent window
- WLX: Fixed AV when cancelling export save dialog under x64

Version 2.1.2 (2020-09-18)
- WLX: Fixed high CPU load on some torrents

Version 2.1.1a (2019-08-16)
+ Updated Ukrainian translation (thanks YuriPet)

Version 2.1.1 (2019-08-09)
- Small documentation fixes
- WLX: Fixed work with mirrors
* WLX: When running client normal/minimized then lister/TC window not loose focus

Version 2.1.0 (2019-07-24)
* Cnangelog see in he history of beta-versions

Version 2.0.7 (2019-07-19) beta
+ WLX: Option for expanding non-standard info at open
- WLX: Fix for non-standard info displaying when (un)folding
* WLX: For client again changed %AI parameter behaviour

Version 2.0.6 (2019-07-17) beta
* WLX: For client changed %AI parameter behaviour
+ WLX: Client can be executed minimized/maximized/hidden
+ WLX: Language file can be in any common unicode encoding
+ WLX: Support empty environment variables for client

Version 2.0.5 (2019-06-20) beta
+ WLX: Mirrors support for links (ini)
+ WLX: Support client path relative to plugin path
+ WLX: %AI in client params will create list of file indexes (for aria2)
+ WLX: %F in client params for parent path to torrent file
+ WLX: %UL in client params create unicode file list
- WLX: Fixed TC crash when %L exists in the client params

Version 2.0.4 (2019-03-31) beta
+ WDX: Added field with unsupported fields count
+ WLX: Added vieweing of non-standard fields for files
+ WLX: Better viewing of non-standard fields, in theory, almost all fields should be shown
+ Support for more fields with .utf-8 suffix (old BitComet)
+ WLX: Support publisher and publisher-url
+ Parser should be more tolerate to structure damaging
- WLX: Fixed items unfolding when searhing
+ WLX: Ed2k links are detected as link too
- WLX: Fixed wrong encoding in custom fields
- WCX: Fixed size for files > 4Gb

Version 2.0.3 (2019-03-24) beta
* No more separate wdx (now it's have little sense)
* Translation files are unicode now
+ Added simple WCX functionality (file browsing)
- WLX: Fixed sometimes wrongly encoded comments (and maybe other sections too) 
* Default MS Sans Serif font changed to Microsoft Sans Serif (unicode)
+ Search can be performed with "whole words", "backward" and "case sensitive" options
- Fixed search, now it search folder names too
+ WLX: Statusbar now show loaded status (success or error)
+ Parser: Errors are translated
+ Slightly redone error reporting (show in list, no more messageboxes)
+ Parser: Will try to fix some corrupted files to show it's content
- Parser: Handle case, where "announce-list" is not a list actually
- WLX: Almost removed list flickering

Version 2.0.2 (2011-11-29)
+ Added Hungary translation
- fixed bug with some torrents with "url-list" segment

Version 2.0.1 (2011-11-29)
* Updated Ukrainian translation (thanks Maximus)
- Parser: Fixed error on some torrents with large text blocks

Version 2.0.0 (2011-11-11)
* WDX: Merged "Tracker" and "Tracker (host)" fields (with units use)

Version 1.0.22 (beta) (2011-11-10)
+ Parser: Added more informative error handling
- WLX: Fixed wrong thouthands separator on some locales
- WLX: Duplicated text in lines where link was at end of text
- Parser: Fixed error on files with corrupt "announce-list"
- Parser: Fixed error with negative integers reading

Version 1.0.21 (beta) (2011-11-09)
+ WLX: Template for Magnet displaying
+ WLX: Finally (?) fixed wrong text width calculation
* WLX: Removed option to shorten magnet link in viewer (template now)

Version 1.0.20 (beta) (2011-11-08)
+ WLX: Option to shorten magnet link in viewer
+ WLX: Added context menu item "Copy link"
* WLX: Removed Ctrl+Click functionality (just click on link now)
* WLX: Removed "Links" item from context menu
- WDX: Wrong SHA1 displaying
- WLX: Fixed position of link menu appearance
- WLX: Finally fixed wrong text width calculation
- WLX: Fixed size disappearing when "Hide bracket" enabled

Version 1.0.19 (beta) (2011-11-03)
+ WLX: Configurable color for highlited items
+ WLX: Added left margin
* WLX: Updated Ukrainian translation
- WLX: Incorrect painting when window scrolled horizontally
- WLX: Fixed (again) horizontal scrolling extent

Version 1.0.18 (beta) (2011-11-02)
+ WLX: Links highlight directly in list
+ WLX: Brackets around size can be hidden
- WLX: Horizontal scrollbar not appearing when on info widh > files width

Version 1.0.17 (beta) (2011-10-25)
+ WLX: Ctrl+G hotkey to go link in selected line
+ WLX: Added horizontal scrollbar where needed
- WLX: Fixed wrong detect string
* WLX: Slightly improved loading speed

Version 1.0.16 (beta) (2011-10-20)
+ WLX: Configurable Magnet generating
+ WLX: Added custom info displaying
- WLX: Fixed bug when mouse dropping field in config
+ Added X64 version

Version 1.0.15 (beta) (2010-12-27)
+ Parser preferable use ***.utf-8 tags if they found
+ WLX: Added converting some asian encodings, if they are correctly defined in the file
- WLX: Fixed crash on some invalid torrents
- WLX: Fixed copying non-latin text in the clipboard

Version 1.0.14 (beta) (2010-12-25)
+ WDX: Enabled background torrent loading
+ WDX: Added cache to speedup repeating browsing

Version 1.0.13 (beta) (2010-12-25)
- WDX: Not counting total torrent size
- Various Fixes related to UTF-8 processing
- Unicode Support was disabled
* Changed types of Multifile and Private fields to boolean
+ WDX: Added forgotten Multiline field

Version 1.0.12 (beta) (2010-12-24)
+ WDX: Added field that contain tracker host only (http://bt.tracker.org/announce -> bt.tracker.org)
- WLX: New fields are not added in list
+ WLX: Added field with Magnet URI
+ WLX: Added various hotkeys
- WLX: Fixed the problem when plugin block dir renaming, where just viewed torrent was
- WLX: Fixed searching non-latin text
+ WLX: Unicode support, safely work only with really UTF-8 encoded torrents
+ WLX: Added "Webseeds" field
+ Added "Multifile" field
* "Private" flag now is separate field
* Field "Additionally" removed — all possible new parameters will have own fields
* Various speed optimizations
* Written own torrent-file parser, speed increased in ~2 times

Version 1.0.11 (beta) (2010-07-08)
+ Added moving fields in options by keyboard (Ctrl+Arrows)
- Fixed small bugs

Version 1.0.10 (beta) (2010-07-06)
+ Added ability to reorder fields
+ Added setting to select custom torrent client
- Fixed changing list items in option dialog by keyboard

Version 1.0.9 (beta) (2010-06-30)
+ Coloring files by their extension

Version 1.0.2 (2010-06-30)
- Small language fix
- Fixed incorrect "e" char in the "Created" field name. If you use it, you have to fix it in your configuration.

Version 1.0.1 (2010-06-26)
- Fixed wdx crash on files with unicode names without associated short ones (thanks CheeseCake)

Version 1.0.0 (2010-06-24)
- Fixed wrong displaying of size values with "Thouthands separator" enabled (thanks za222)
- Fixed work with keyboard when switching to plugin in Ctrl+Q mode (thanks Den_Klimov)

Version 0.93 (2010-03-14)
+ Spanish translation (thanks Jose Manuel Breto)
- Fixed focus catching in Ctrl+Q mode
- Fixed crash when Esc pressed in Ctrl+Q mode

Version 0.92 (2009-12-16)
+ Ukrainian translation (thanks Maximus)
+ Option to remember or not export path
* "About" dialog info moved to options tab
- Fixed bug when WLX don't show trackers on torrents with missing "announce"

Version 0.91 (2009-11-30)
+ Plugin trying to hide passkey when export html (optionally)
- Fixed incorrect handling of trackers list that lead to duplicate url's

Version 0.90 (2009-11-20)
+ Ctrl+Click opens URL found in data (menu appear if count > 1)
+ Torrent file name suggested for export name
+ Plugin will not show text about client, if client is not installed
* Styles are resets to default independently
* Auto line height now 0 instead -1 (cosmetic)
* No duplicates allowed in the trackers list
- Fixed crash on files with missing "announce" segment
- Fixed copying to clipdoard on systems with non-latin codepage

Version 0.89 (2009-11-07)
- Fixed error when switching to another plugin by pressing "4"
- Fixed view form translation when it's chosen manually

Version 0.88 (2009-11-06)
* Now export output is UTF-8
+ Overwrite prompt for export
+ Added ability for line height manual setting
- Fixed small bug with URL detection
- Fixed size units in export

Version 0.87 (2009-10-29)
+ Added simple HTML export (for icons export needed GDI+)

Version 0.86 (2009-10-29)
+ Dramatically increased loading speed
- Probably fixed bug with crashing when loading certain torrents

Version 0.85 (2009-10-28)
* Increased speed of unicode version of WDX
+ Unicode WDX is now really unicode
+ Reset styles to default button
+ Option to expand all items at startup
+ Files counter (may be wrong on unicode names)
- Fixed accidental crashes in the unicode WDX
- Fixed incorrect calculation of information splitter
- Changed parser to not fail on corrupt "announce-list" segments

Version 0.81 (2009-10-22)
+ Ability for manual language setting in case of wrong detection
- Probably fixed bug with disappearing icons

Version 0.80 (2009-10-21)
* TCTorrent.sample.ini is not needed anymore, ini created automatically
* Some ini keys changed, recommended to delete old ini before use this version
+ Thousands separators for sizes 
+ Options dialog
+ Now multiline comments are actually multiline and expandable
- Fixed language detection method
- Fixed incorrect behaviour of about dialog

Version 0.71 (2009-10-05)
+ Copying sample ini file if no working copy found
- Fixed disappearing of client icon after about calling
- Fixed two bugs with expand/collapse items

Version 0.70 (2009-10-01)
+ Ability to use large icons
+ Added detection when strings in torrent file saved as ANSI 
+ Significally icreased loading speed
+ Menu items for expand/collapse all folders
+ Rounding size values to integer
+ Folding items by pressing return
+ Added unicode support for WDX
* Changed method of showing progressbar
- Fixed search function when multiple lister windows are open
- Flickering when clicking by right mouse button
- Fixed work with files that have unicode in names
- Fixed crash on torrents with huge comments

Version 0.60 (2009-09-29)
+ Progress bar will appear when loading torrents with large files count
+ Optional displaying of associated icons
+ Options for displaying size (auto, or fixed units)
+ Optional state of extra info at startup (folded or not)
+ Setting of custom items colors and fonts
+ Status bar
+ Folding info
+ Added 3 params to WDX: Program name, Encoding and Private flag.
+ Lister window starts focused
+ Aligning of sizes
- Fixed wrong folder size
- Fixed compatibility with Universal Viewer

Version 0.50 (2009-09-23)
  First public release.
</code>

=====Credits=====
Christian Ghisler — for infinitely powerful tool.\\ 
Maximus, YuriPet — Ukrainian translation\\ 
Jose Manuel Breto — Spanish translation\\ 
Bluestar — Hungarian translation


=====License=====
<!-- OFFLINE:Copyright © 2009-%YEAR% %AUTHOR% -->

<!-- OFFLINE:E-Mail: <a href="mailto:%EMAIL%">%EMAIL%</a> -->

This plugin is freeware.

Allowed inclusion of this plugin in any Total Commander packs, personal or publc, in case of information in this section will remain intact.