<commit_before># TitanPlayed

Played time recording add-on for *World of Warcraft*, with out-of-game visualization script.
It keeps a record of your total playing time for each day, for each of your characters.


## Add-on

The add-on is located in the *TitanPlayed/* folder

### Requirements

This add-on requires [TitanPanel](http://www.titanpanel.org/) .

### What does it do?

The add-on will appear as a right-only icon on the Titan bar of your choice. When the
mouse is over this icon, a tooltip showing the */played* time of all your characters
will be shown.

The */played* time of the current character will be recorded:

* on log in
* on log out
* each time the tooltip is displayed
* each time the */played* command is executed
* before each loading screen

**Note**: Only one */played* time is recorded for each day for each character

### Installation

Copy the folder *TitanPlayed/* into the *Interface/AddOns/* subfolder of your
*World of Warcraft* instance.


## Visualization script

The *scripts/* folder contains the various visualization scripts available.

### File format

The data saved by the TitanPlayed is located at
*WTF/Account/<your_account_name>/SavedVariables/TitanPlayed.lua*

Here is an example of such file (from the file *scripts/example.lua*):

`TitanPlayedTimes = {
        ["Bob"] = {
			["sessions"] = {
				[1348012800] = {
					["money"] = 15000000,
					["played"] = 439874,
				},
				[1348444800] = {
					["money"] = 20000000,
					["played"] = 441001,
				},
			},
            ["last"] = 1348444800,
            ["class"] = "HUNTER",
            ["level"] = 10,
			["levels_history"] = {
				1348012800, -- [1]
				1348012900, -- [2]
				1348013000, -- [3]
				1348013100, -- [4]
				1348013200, -- [5]
				1348013300, -- [6]
				1348013400, -- [7]
				1348013500, -- [8]
				1348013600, -- [9]
				1348013700, -- [10]
			},
        },
        ["John"] = {
			["sessions"] = {
				[1348012800] = {
					["money"] = 8000000,
					["played"] = 339784,
				},
				[1348185600] = {
					["money"] = 16000000,
					["played"] = 345900,
				},
				[1348272000] = {
					["money"] = 33000000,
					["played"] = 349877,
				},
				[1348358400] = {
					["money"] = 50000000,
					["played"] = 353909,
				},
				[1348444800] = {
					["money"] = 100000000,
					["played"] = 355062,
				},
			},
            ["last"] = 1348444800,
            ["class"] = "WARRIOR",
            ["level"] = 5,
			["levels_history"] = {
				1348185650, -- [1]
				1348271000, -- [2]
				1348358600, -- [3]
				1348444800, -- [4]
				1348444890, -- [5]
			},
        },
}`

Here we have two characters (Bob, a hunter, and John, a warrior). Bob played on two
different days (represented by the number of seconds since 0 hours, 0 minutes, 0 seconds,
January 1, 1970, Coordinated Universal Time): 1348012800 (2012/9/19) and 1348444800
(2012/9/24).

On 2012/9/19, the */played* time of Bob was 439874 (seconds) and on 2012/9/24 it was<commit_msg>Fix the display of the README file on Github<commit_after># TitanPlayed

Played time recording add-on for *World of Warcraft*, with out-of-game visualization script.
It keeps a record of your total playing time for each day, for each of your characters.


## Add-on

The add-on is located in the *TitanPlayed/* folder

### Requirements

This add-on requires [TitanPanel](http://www.titanpanel.org/) .

### What does it do?

The add-on will appear as a right-only icon on the Titan bar of your choice. When the
mouse is over this icon, a tooltip showing the */played* time of all your characters
will be shown.

The */played* time of the current character will be recorded:

* on log in
* on log out
* each time the tooltip is displayed
* each time the */played* command is executed
* before each loading screen

**Note**: Only one */played* time is recorded for each day for each character

### Installation

Copy the folder *TitanPlayed/* into the *Interface/AddOns/* subfolder of your
*World of Warcraft* instance.


## Visualization script

The *scripts/* folder contains the various visualization scripts available.

### File format

The data saved by the TitanPlayed is located at
*WTF/Account/<your_account_name>/SavedVariables/TitanPlayed.lua*

Here is an example of such file (from the file *scripts/example.lua*):

```lua
TitanPlayedTimes = {
        ["Bob"] = {
			["sessions"] = {
				[1348012800] = {
					["money"] = 15000000,
					["played"] = 439874,
				},
				[1348444800] = {
					["money"] = 20000000,
					["played"] = 441001,
				},
			},
            ["last"] = 1348444800,
            ["class"] = "HUNTER",
            ["level"] = 10,
			["levels_history"] = {
				1348012800, -- [1]
				1348012900, -- [2]
				1348013000, -- [3]
				1348013100, -- [4]
				1348013200, -- [5]
				1348013300, -- [6]
				1348013400, -- [7]
				1348013500, -- [8]
				1348013600, -- [9]
				1348013700, -- [10]
			},
        },
        ["John"] = {
			["sessions"] = {
				[1348012800] = {
					["money"] = 8000000,
					["played"] = 339784,
				},
				[1348185600] = {
					["money"] = 16000000,
					["played"] = 345900,
				},
				[1348272000] = {
					["money"] = 33000000,
					["played"] = 349877,
				},
				[1348358400] = {
					["money"] = 50000000,
					["played"] = 353909,
				},
				[1348444800] = {
					["money"] = 100000000,
					["played"] = 355062,
				},
			},
            ["last"] = 1348444800,
            ["class"] = "WARRIOR",
            ["level"] = 5,
			["levels_history"] = {
				1348185650, -- [1]
				1348271000, -- [2]
				1348358600, -- [3]
				1348444800, -- [4]
				1348444890, -- [5]
			},
        },
}
```

Here we have two characters (Bob, a hunter, and John, a warrior). Bob played on two
different days (represented by the number of seconds since 0 hours, 0 minutes, 0 seconds,
January 1, 1970, Coordinated Universal Time): 1348012800 (2012/9/19) and 1348444800
(2012/9/24).

On 2012/9/19, the */played* time of Bob was 439874 (seconds) and on 2012/9/24 it was
{'fraction_non_alphanumeric': 0.14558872861455888, 'fraction_numerical': 0.1405568601140557, 'mean_word_length': 2.6073805202661826, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 5, 'https://': 0, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 6, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4273116', 'n_tokens_mistral': 2939, 'n_tokens_neox': 2037, 'n_words': 648}