Metadata-Version: 2.1
Name: Demomgr
Version: 1.9.0
Summary: TF2 demo file management tool written in Python and Tcl, using tkinter.
Home-page: https://www.github.com/Square789/Demomgr
Author: Square789
License: UNKNOWN
Platform: UNKNOWN
Classifier: Topic :: Desktop Environment :: File Managers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Tcl
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: End Users/Desktop
Description-Content-Type: text/markdown
Requires-Dist: multiframe-list (==4.0.0)
Requires-Dist: regex
Requires-Dist: schema
Requires-Dist: vdf

# Demomgr
Demomgr is a python program designed to keep track of, cleanup and play demo files from the Source video game Team Fortress 2, released by Valve Corporation in 2007.

> ![Main program window](https://github.com/Square789/Demomgr/blob/master/img0.PNG)  
> _Main program view, directory filtered to only demos taking place on payload maps, sorted by creation time._

### Current features:
* List Demos, their filesize, creation date and the amount of Killstreaks/Bookmarks
  * Sort them by these criteria
* Read Killstreak/Bookmark information from both .json files and the \_events.txt file
* View and edit bookmark information of individual demos
* View header information of individual demos
* Filter and select demos by multiple criteria
* Cleanup folders by filter criteria
* Copy/Move demos and their info to other directories
* Launch TF2 with a playdemo command attached
  * Optionally with HLAE
* Play a demo into an already running instance of TF2 using [RCON](https://developer.valvesoftware.com/wiki/Source_RCON_Protocol)

### Installation Instructions (Pure python):
If you don't have python, get it from [the official website](https://www.python.org).

Demomgr is in python's package index (PyPI), you can install it using `pip install demomgr`.
This should create an entry point script in your python installations's `Scripts` directory.
If that is on your system's path, you should now be able to run `demomgr` pretty much anywhere.

If that does not work out for you, try `py -m demomgr`, or in a very extravagant case create a
python script that runs  
`from demomgr.main_app import MainApp; MainApp()`.

### Installation instructions (exe):
There is an experimental [nuitka](https://nuitka.net/) build of Demomgr available in the "Releases" section, only for 64bit Windows.  
Extract it to a good place for programs to be and run the contained `demomgr.exe`.

### Getting started:
After accepting the disclaimer (Look, I have no idea how to set up tests for deletion/file management logic
intertwined with a UI, and even though I spend hours testing proper functionality there is a risk of something sneaking by),
you will be presented an empty UI. In order to view your demos, click "Add demo path" and select the directory containing your demos.  
You can switch between directories using the selection box at the top of the window.  

### Filter instructions:
The filter criteria must be entered as follows:  
`<keyname>:<parameter>`, seperated by commas.  
**You can negate all key-parameter pairs by prefixing the key with **`!`**.**  
**Do not use the same filtering key (Even if negated) in a filter request, as one will replace the other.**  
**You can enter multiple criteria by seperating them with **`,`**.**

You can currently filter the directory you are in by the following keys:
 * map : _Substring of the map name a demo is playing on._ (String)
 * name : _Substring of a demo's filename._ (String)
 * killstreaks : _Amount of a demo's killstreaks._ (Range/Integer)
 * bookmarks : _Amount of bookmarks recorded._ (Range/Integer)
 * beststreak : _Value of the best streak recorded in a demo._ (Range/Integer)
   * May produce erratic results at values out of normal ranges
 * bookmark_contains : _Substring of any of a demo's bookmarks._ (String)
 * hostname : _Substring of the server name a demo took place on._ (String) (Usually a IPv4)
 * clientid : _Substring of the Steam community name of the player._ (String)
 * moddate : _A demo's last modification time._ (Range/Integer) (Direct UNIX Timestamp)
 * filesize : _Filesize in bytes._ (Range/Integer)

Possible parameters are:
 * Quoteless string: `foo`
   * Quoteless strings may consist out of `A-Z`, `a-z`, `_`, `-`
 * Quoteless string tuple: `(foo, bar, baz)`
 * String: `"foo"`, `'b\u0061r'`
 * String tuple: `("foo", 'b\u0061r', "b\u0061z", )`
 * Range: `1..2`, `10..`, `..50`  

Example: `!map:(mvm_,plr_,tr_), killstreaks:2.., beststreak:5..`  
This will display all demos where: The user has gotten at least two killstreaks, at least one of those streaks was 5 or more
and the game does not take place on maps containing the substrings `mvm_`, `plr_` or `tr_`.  

Thanks, and have fun.


