Note
Update 2: We're not back 😢
Within 5 days of publishing my workaround and it working flawlessly, Twickets suddenly blocked my IP. It seems they have been actively monitoring this repo, and I have other evidence for this.
They also added some new additional checks which I have a solution for, but since my IP is now blocked, I cannot validate it. So it looks like we have reached the end of the road.
Twickets - since I know you'll be reading this: I know these protections are to prevent scalping and doing dodgy stuff - I legitimately appreciate this as it improves the service for all (if anything, I'm glad my work improved this!) - but I built this project for benign notification purposes as your notification system is absolutely terrible. Please fix it.
Update 1: We're back! 💪
After Twickets introduced measures to prevent unofficial access to their data - this project was broken for quite a while.
After a significant amount of time and effort tinkering and hitting my head against a wall (more than I care to admit) I have now found a way to bring this project back to life and get it working again!
Enjoy! 🎟️
A tool to watch for chosen event ticket listings on Twickets that match custom filters and notify you so you can quickly snap them up!
Why twitchets?
I built this tool because the official Twickets app has limitations on the number of events you can watch for tickets, and lacks many features/filters I wanted and needed.
Note: This program does not buy tickets, reserve them automatically, or do anything unethical. It simply notifies you of new ticket listings!
Powered by twigots, a Go package to fetch and filter event ticket listings from Twickets 🎟️
- No limit on the number of events you can watch for!
- Watch for tickets with a certain discount, number of tickets, and location
- Show more details in the notifications, such as event date/time, number of tickets, and discount
- Faster notifications than the official Twickets app
- No need to have the Twickets app or an account
- Choose from various notification services (Telegram, ntfy, Gotify currently supported)
frontend.mp4
To use this tool, you need a set of Twickets API keys, which this application will load from a URL (keysUrl).
These keys are extracted from Android and some rotate regularly. You can read more about what these keys are and how they are obtained in the twigots and twickets-key-extractor repos.
For the URL you have two options:
-
Use the public keys URL: I maintain a public keys file that is regularly updated. Point
keysUrlin your config at:https://gist.githubusercontent.com/ahobsonsayers/773acb763aafc8a39ac260e12a9b39d5/raw/keys.json -
Run
twickets-key-extractoryourself: Clone and run twickets-key-extractor and pointkeysUrlat the URL of the produced key file.
The keys are hot-reloaded automatically, so rotations are picked up without a restart.
The recommended way to run twitchets is using Docker:
docker run -d \
--name twitchets \
-v <path to config>:/twitchets/config.yaml \
--restart unless-stopped \
arranhs/twitchets:latestOr, use Docker Compose:
services:
twitchets:
container_name: twitchets
image: arranhs/twitchets:latest
restart: unless-stopped
volumes:
- <path to config file>:/twitchets/config.yamltwitchets looks for a config.yaml file in your current working directory and fails to start if it's not found.
The configuration file structure can be seen in config.example.yaml or below:
keysUrl: <your twickets keys url> # REQUIRED: See "Getting Keys" above
country: GB # Currently only GB is supported
# Notification service configuration
# Remove/comment out services you don't need
notification:
ntfy:
url: <your ntfy url> # You can use the public instance at https://ntfy.sh
topic: <your ntfy topic> # If using https://ntfy.sh, make sure this is unique to you!
username: <your ntfy username> # Optional: for authenticated instances
password: <your ntfy password> # Optional: for authenticated instances
telegram:
token: <your telegram api token> # Get from @BotFather on Telegram
chatId: <your telegram chat id> # Your chat ID or group chat ID
gotify:
url: <your gotify url> # Your Gotify server URL
token: <your gotify api token> # Application token from Gotify
# Global ticket configuration
# All available settings are outlined below
# These settings apply to all tickets by default
# Individual ticket configuration can override these settings
# Settings can be added and removed as needed
# Any setting not specified will use the default
global:
# Geographic regions to search for tickets
# Default: All regions if not specified
# Full list: https://github.com/ahobsonsayers/twigots/blob/main/location.go#L87-L98
regions:
- GBLO # London only
# Event name similarity matching (0.0 - 1.0)
# Default: 0.9 (allows for minor naming differences)
eventSimilarity: 0.9
# Minimum number of tickets required in listing
# Default: Any number of tickets
numTickets: 2 # Exactly two tickets
# Maximum price per ticket (including fee) in pounds (£)
# Default: Any price
maxTicketPrice: 50 # Maximum ticket price of £50 including fee
# Minimum discount (including fee) on the original price as a percentage
# Default: Any discount (including no discount)
# discount: 10 # At least 10% off original price
# Notification services to use
# Default: All configured services
notification:
- ntfy
# Individual ticket configuration
# Available settings match the global ones
# Settings here override global settings above
# To reset a global setting to its default, use:
# - "" (empty string) for string values
# - [] (empty array) for list values
# - -1 for numeric values
tickets:
- event: Lion King
maxTicketPrice: 30 # Max £30 per ticket
- event: Coldplay
numTickets: 4 # Need exactly 4 tickets
maxTicketPrice: -1 # Reset to default: Any max price
discount: 25 # Must be at least 25% off
- event: Taylor Swift
regions: [] # Reset to default: Search all regions
numTickets: -1 # Reset to default: Any number of tickets
discount: -1 # Reset to default: Any discount (or no discount)
- event: Hamilton
regions:
- GBSO # South only
notification:
- telegram # Only send to Telegram
- event: Oasis
notification: [] # Reset to default: Send to all configured notification servicesYou can see more about how this works in the twigots readme here.
Because I feel like sometimes you need to have twitch-like reactions to snap up tickets on Twickets before someone else gets them - which this tool helps you do. Therefore the mangling together of twitch and Twickets seemed fun and appropriate.
In the age of LLMs and coding agents, code is now cheap - for better or for worse. Your time however, is not ⌛
Therefore this project, like most of my projects, uses a hand written "artisan" README to ensure it is clear, correct and concise. This makes it easy to read and in my opinion encourages reading and engagement - no one likes AI slop!