https://github.com/tzerk/bdo-watchdog
A monitoring tool for Black Desert Online with Telegram messaging support
https://github.com/tzerk/bdo-watchdog
afk black-desert-online telegram watchdog
Last synced: about 1 month ago
JSON representation
A monitoring tool for Black Desert Online with Telegram messaging support
- Host: GitHub
- URL: https://github.com/tzerk/bdo-watchdog
- Owner: tzerk
- License: mit
- Created: 2017-02-26T09:50:06.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2022-09-20T09:58:07.000Z (over 2 years ago)
- Last Synced: 2025-03-28T20:37:30.970Z (about 2 months ago)
- Topics: afk, black-desert-online, telegram, watchdog
- Language: Go
- Size: 68.4 KB
- Stars: 20
- Watchers: 4
- Forks: 4
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# BDO Watchdog 
A simple Go program that monitors the BlackDesert64.exe process and its network status. If the process disconnects it sends a custom Telegram message and optionally kills the process or turns off the computer.
## Screenshot
## How it works
1. (optionally) Tries to kill all `CoherentUI_Host.exe` processes (requires admin rights)
2. (optionally) Changes the CPU process priority on startup (requires admin rights)
3. Check if the designated [process is currently running](https://github.com/mitchellh/go-ps)
4. Obtain the process ID (PID)
5. Run `cmd.exe netstat -aon` and find the PID its output
If the process is running, but its PID is no longer found in the output of `netstat` it then does the following:
- Send a Telegram message using a [URL query string](https://core.telegram.org/bots/api#making-requests)
- (optionally) writes the time of disconnect in a log file
- (optionally) tries to kill the process (requires admin rights)
- (optionally) shuts down the computer (`cmd /C shutdown /s`)
## Configuration
On first startup the program creates the `config.yml` file, where you can provide the details of your Telegram bot. It also contains some program specific options.
Option | Description
-------| -----------
token | The token is a string along the lines of `AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw` that is required to authorize the bot
botid | A unique ID of your bot along the lines of `123456789`
chatid | Unique identifier for the target chat or username of the target supergroup or channel
timestamp | Append a timestamp to the Telegram message
message | The message your bot sends in case of a disconnect
stayalive | By default, the program closes if it has detected a disconnect
process | The process to be monitored, defaults to `BlackDesert64.exe`
timebetweenchecksins | Time in seconds to wait between each polling interval
faillimit | Maximum number of failed checks until exit routine is initiated
shutdownondc | Shut down the computer after the client disconnected
killondc | Kill the process after it disconnected (requires the executable to be run with admin rights!)
killcoherentui | Kill all `CoherentUI_Host.exe` processes (requires admin rights)
log | Write a simple log file with timestamps (`log.txt` file)
processpriority | Set the CPU priority of the process (allowed values: `idle, below normal, normal, above normal, high priority, realtime`) (requires admin rights)
## Setting up the Telegram Bot
1. [Download Telegram](https://telegram.org/) for your favorite platform
2. Initiate chat with the [`BotFather`](https://telegram.me/botfather)
3. Enter `/newbot` and follow instructions. If successful, you will receive the **bot id** and **token** (in the form of ``).
4. Initiate a conversation with your bot by entering `telegram.me/` in your browser
5. Retrieve your personal user/chat id by entering `https://api.telegram.org/bot:/getUpdates`. You will see a JSON object that contains `"from":{"id":12345678,[...]"`. The id is the **chat id** you will need.
6. Finally, open `config.yml` and copy the **bot id**, **token** and **chat id** in the corresponding fields. Done!
## Compiling BDO Watchdog from source
If you want to compile this program yourself you will need the following programs/tools:
* [Go](https://golang.org/doc/install)
* (optional) [JetBrains Gogland IDE](https://www.jetbrains.com/go/)
* [Mingw-w64](https://mingw-w64.org/doku.php)
* (optional) [rcedit](https://github.com/electron/rcedit/releases)
If everything is set up correctly and all executables are in `PATH` clone this repository, open a command shell in the root directory and enter `make`. Alternatively, you can also just run `go build`, but then the command shell window will not be hidden and the executable will not have a fancy icon.
## Contributing
This is a free time project as a means to learn the Go language and not some elaborate venture. By that, I cannot promise any updates or bugfixes. Feel free to fork this project and/or to suggest changes via pull requests.
# Licence
MIT