-
Notifications
You must be signed in to change notification settings - Fork 9
Commandline Usage
The commandline version of NetTally allows you to run a tally from the commandline of any system that has .NET Core 1.1 installed. This includes Linux and OSX systems.
dotnet nettally.dll <options> <url>
Note that the parameter options may be placed before or after the url that's being tallied.
All tally and output options from the main WPF version of NetTally may be accessed via parameter options in the commandline version of the program. The only feature that does not have an equivalent is the Manage Votes
window.
Each parameter has a long form, and some have short forms. The long form requires a double hyphen (eg: --threadmark
), while the short form only uses a single hyphen (eg: -k
).
Any parameter that needs to have a value associated with it (eg: the starting post) should have that value placed after the option flag. If the parameter requires a string value (eg: custom threadmark filters), then the string must be enclosed in quotation marks. (eg: --threadmarkfilters "omake, interlude"
).
The url for the thread being tallied is a required parameter (also, the only required parameter). It may be copied directly from the browser's location bar, and does not need to be edited as long as the program knows how to determine the base thread from the URL (which should be the case for all actively supported forum types).
Syntax: -v
or --verbose
If the verbose flag is set, the program will print the progress output to the stderr channel while it is trying to load the pages from the thread. Because it's being output to the stderr channel, if you pipe the output from running the program as a whole to another tool (eg: the clipboard), the progress data will not interfere with the tally output.
Syntax: -k
or --threadmark
This defaults to on if no starting or ending post numbers are provided. If set, it will attempt to find the starting post number for the tally based on any threadmarks for the given thread.
If starting or ending post numbers are given, and this flag is not set, then it will not search for any threadmarks. If starting or ending post numbers are given, and this flag is set, then it will search for a threadmark, but fall back to the explicit post numbers if no threadmark is found.
See also: Program usage
Syntax: -s <number>
or --start <number>
This defines the first post number that should be tallied within the thread.
See also: Program usage
Syntax: -e <number>
or --end <number>
This defines the last post number that should be tallied within the thread. If it is omitted, or given a value of 0, the tally will run to the end of the thread.
See also: Program usage
Syntax: --partition <partition mode>
Valid partition modes: None
, ByLine
, ByBlock
, ByLineTask
, ByBlockAll
Default if no value given: None
The partition mode values are case-sensitive. (This is a bug in the commandline option parsing library. They should be case-insensitive.)
Use this option to set the partition mode for votes in the tally.
See also: Customizing output
Syntax: --display <display mode>
Valid display modes: SpoilerAll
, Normal
, Compact
, NormalNoVoters
, CompactNoVoters
Default if no value given: SpoilerAll
The display mode values are case-sensitive. (This is a bug in the commandline option parsing library. They should be case-insensitive.)
Use this option to set the display mode for the tally output.
See also: Customizing output
Syntax: --threadmarkfilters "<filters>"
Valid filters: See the wiki section on filters.
Use this to set filters that you want skipped when searching for the last threadmark.
See also: Quest options
Syntax: --usernamefilters "<filters>"
Valid filters: See the wiki section on filters.
Use this to define usernames to be filtered out of (or included in) the tally.
See also: Quest options
Syntax: --taskfilters "<filters>"
Valid filters: See the wiki section on filters.
Use this to define specific tasks to be included in the tally.
See also: Quest options
Syntax: --postsperpage <number>
Use this to define how many posts are on each page of the thread.
The default value for Sufficient Velocity and SpaceBattles (and other XenForo forums) is 25; for Questionable Questing is 30; and for vBulletin forums is 20.
See also: Quest options
Syntax: --whitespace
Set this to indicate that the option to treat whitespace and punctuation as significant within each vote line should be true.
See also: Formatting options
Syntax: --noplanlabels
Set this to indicate that plan labels should not be considered valid for creating plans in the tally.
See also: Formatting options
Syntax: --noproxy
Set this to indicate that user proxy votes will not be allowed.
See also: Formatting options
Syntax: --pinproxy
Set this to indicate that all user proxy votes will be considered 'pinned'.
See also: Formatting options
Syntax: --nospoilers
Set this to indicate that the tally program should ignore spoilers when constructing votes.
See also: Formatting options
Syntax: --trim
Set this to indicate that the program should try to trim long vote lines.
See also: Formatting options
Syntax: --noranks
Set this to disable ranked vote handling in the tally.
See also: General options
Syntax: --debug
Set this to enable debug mode.
See also: Misc options