Инструменты пользователя

Инструменты сайта


en:tctorrent:documentation

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

Special hotkey Shift+Ctrl+D, the action is similar to Ctrl+D, but the value of the special variable %D is changed to the path in the target panel. A similar result can be achieved by holding Shift while clicking the corresponding menu item or clicking on a section of the status bar.

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.
  • %D — special variable, returns the source or destination directory depending on the hotkey pressed (see the hotkeys section).

Also added a support for some specific features for console torrent-client aria2 (help for commandline parameters, builds running on XP):

  • %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 «→».

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:

[Mirrors]
domain.com=mirror.com

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

Version history

Version 2.1.4 (2024-06-25)
+ 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.

Credits

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

License

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.

en/tctorrent/documentation.txt · Последнее изменение: 2024/11/22 11:34 — loopback

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki