steamgifts-bot/README.md

61 lines
2.4 KiB
Markdown
Raw Normal View History

2019-02-28 13:12:42 +01:00
### About
The bot is specially designed for [SteamGifts.com](https://www.steamgifts.com/)
2019-02-28 13:04:41 +01:00
2019-02-28 13:12:42 +01:00
### Features
- Automatically enters giveaways.
- Undetectable.
2022-05-20 22:56:36 +02:00
- Сonfigurable
- Can look at your steam wishlist games or the main page for games to enter
- When evaluating a giveaway
- `max_time_left` - if the time left on giveaway is > max time left, then don't enter it
- `max_entries` - if the entries on a giveaway are > than max entries, then don't enter it
- `minimum_points` - minimum number of points **in your account** needed before considering any giveaway
- `minimum_game_points` - if steamgifts.com point cost (ex. 1P, 5P, etc) is below this, don't enter it
- `blacklist_keywords` - if the giveaway name contains any of these words, don't enter it. this list can be blank.
- Notifications
- A pushover notifications can be sent to you when a win is detected.
- Webserver - A simple, simple, simple webserver than can be enabled (disabled by default) to show the config and logs
- `web.host` - the IP to listen on (ex. localhost, 0.0.0.0, 192.168.1.1, etc)
- `web.port` - the port to listen on
- `web.app_root` - the folder to serve up which can be used for reverse proxying this behind nginx/apache/etc
- `web.ssl` - if the traffic will be encrypted (http or https) using a self-signed cert
- `web.basic_auth` - simple basic auth settings can be enabled
2019-02-28 13:12:42 +01:00
- Sleeps to restock the points.
- Can run 24/7.
2019-02-28 13:04:41 +01:00
2022-04-23 21:20:09 +02:00
## Instructions
2022-05-20 22:56:36 +02:00
1. Sign in on SteamGifts.com by Steam.
2. Find PHPSESSID cookie in your browser.
3. Rename `config/config.ini.example` to `config/config.ini`.
4. Add your PHPSESSION cookie to `cookie` in `config/config.ini`
5. Modifying the other settings is optional as defaults are set.
2022-04-23 21:20:09 +02:00
2020-06-26 22:55:25 +02:00
### Run from sources
2022-04-23 21:20:09 +02:00
2020-06-26 22:55:25 +02:00
```bash
python -m venv env
source env/bin/activate
pip install -r requirements.txt
python main.py
2020-06-26 22:55:25 +02:00
```
2019-02-28 13:12:42 +01:00
2022-04-22 20:32:55 +02:00
### Docker
2022-04-23 21:00:22 +02:00
#### Run it
2022-04-22 20:32:55 +02:00
```bash
# Run the container
# Set TZ based on your timezone: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
2022-04-27 00:00:08 +02:00
docker run --name steamgifts -e TZ=America/New_York -d -v /path/to/the/config/folder:/config mcinj/docker-steamgifts-bot:latest
2022-04-22 20:32:55 +02:00
```
#### Or build it yourself locally
```bash
# Build the image
docker build -t steamgifts:latest .
# Run the container
# Set TZ based on your timezone: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
docker run --name steamgifts -e TZ=America/New_York -d -v /path/to/the/config/folder:/config steamgifts:latest
2022-04-22 20:32:55 +02:00
```