Skip to content

Tylsew/Titan

 
 

Repository files navigation

Titan

           Version Appveyor Circle CI Dependencies Downloads Discord           

Titan /ˈtaɪtən/ is an advanced Counter-Strike Global Offensive report and commendation bot. Its goal is to maintain a clean Matchmaking system by sending a target forcefully (by 11 reports) into Overwatch. It provides a advanced set of features and high effiency when compared against other report and commendation bots.

Features

  • Support for both a graphical user interface (GUI) and command line.
  • High performance thanks to multi-threaded reporting and commending (when compared to other report bots).
  • Ban checking for both target and bot accounts. (Requires own generated Steam Web API key)
  • Integrated Sharecode parser that automatically parses the Match ID from a CS:GO Demo Share URL.
  • Integrated Match ID resolver that automatically resolves the Match ID from the targets current match.
  • Automatic index timer which outputs when an account has finished its 12 hours cooldown.
  • Cross-platform compatibility, supports both Windows and Linux. Darwin support is coming soon.
  • No installation necessary, every release is provided as binary archive.
  • Tracking of botted victims with automatic notification when a ban occurs.
  • Automatic Steam Guard code generation from Shared Secrets.
  • Steam Guard support.

Installation

Every version of Titan is provided as binary archive. An installation process is not required.

Dependencies

Windows: .NET Framework ≥4.6.1 (and for building Git, Visual Studio 2017 with .NET Desktop Development tools and Visual Studio 2017 Build Tools).
Linux: Mono ≥5.4, Gtk 3, libNotify and libAppindicator 3 (and for building Git and MsBuild ≥15.0).

Option 1: Binary

Download the latest binary from the releases tab. Download the package for your operating system, unpack it and run the Titan.exe file.

Option 2: From Source

$ git clone https://github.com/Marc3842h/Titan.git
$ cd Titan

# Run this in a PowerShell terminal on Windows
PS> Set-ExecutionPolicy Unrestricted
PS> .\build.ps1

# Run this in a terminal on Linux
$ chmod +x build.sh
$ ./build.sh

Option 3: Distro-provided packages

Arch Linux: titan-bot-git

Usage

Start

Run Titan on Windows by simple double clicking the Titan.exe executeable.

On Linux, run Titan from the command line using the following syntax:

$ mono Titan.exe [Verb] [Arguments ...]

You can find a list of command line arguments here.
If no (or not enough) arguments have been supplied, Titan will open the GUI:

GUI

If one of your recently botted players got banned, you'll also receive a notification:

Notification

Please note that Titan is running as service by default. To close Titan completely, please click File > Exit in the menu bar.

About

All screenshots have been taken on Arch Linux using Gnome with the Ark-Dark theme.

Converting existing accounts file

Titan brings a Python3 script that can convert an existing accounts.txt file (in the format of username:password, from for example Askwrite's report bot) to a Titan-compatible accounts.json file that can be used with the Titan report & commend bot.

Use it like this:

python convert.py <original accounts file>

After it ran successfully you can find a accounts.json file in the current directory.

i3wm

If you are using i3 window manager, I suggest enabling floating for Titan in the .config/i3/config:

for_window [class="Titan"] floating enable

Accounts file

Here is the syntax of the accounts.json. You may read more about it on the wiki.

{
    // Per index are maximum 11 accounts allowed. Begin a new index when a new account is required.
    "indexes": [
        {
            "accounts": [
                {
                    "username": "username1",
                    "password": "password1",
                    "enabled": true, // May be omitted if you want set it to default value (true)
                    "sentry": false, // May be omitted if you want set it to default value (false)
                    "secret": "Shared Secret for SteamGuard" // May be omitted if you don't want to use the shared secret generator
                },
                {
                    "username": "username11",
                    "password": "password11",
                    "enabled": false, // May be omitted if you want set it to default value (true)
                    "sentry": false, // May be omitted if you want set it to default value (false)
                    "secret": "Shared Secret for SteamGuard" // May be omitted if you don't want to use the shared secret generator
                }
            ]
        },
        {
            "accounts": [
                {
                    "username": "username12",
                    "password": "password12",
                    "enabled": true, // May be omitted if you want set it to default value (true)
                    "sentry": false, // May be omitted if you want set it to default value (false)
                    "secret": "Shared Secret for SteamGuard" // May be omitted if you don't want to use the shared secret generator
                },
                {
                    "username": "username22",
                    "password": "password22",
                    "enabled": true, // May be omitted if you want set it to default value (true)
                    "sentry": false, // May be omitted if you want set it to default value (false)
                    "secret": "Shared Secret for SteamGuard" // May be omitted if you don't want to use the shared secret generator
                }
            ]
        }
    ]
}

Contributing

All contributions are welcomed and appreciated.

Bug Reports

Please use the issue tracker to report any bugs or file feature requests.

Developing

Pull Requests are welcome. Before being able to load the .sln project using your favorite IDE, please restore the NuGet packages (nuget restore) as they are required for loading the project.

Donations

Donations are appreciated. Feel free to become a Patreon on my Patreon.

License

Titan is licensed under the MIT License. Please visit the LICENSE.txt file in the root directory tree for more informations. All external resources that do not fall unter the MIT license (Images etc.) have been credited in the CREDIT.txt under the Resources directory.

Special

Titan is supporting and is being supported by the TuxCheats community.
Huge thanks to them.

About

A free, advanced CS:GO report and commendation bot built with performance and ease-of-use in mind

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 93.5%
  • PowerShell 3.5%
  • Shell 2.4%
  • Python 0.6%