Reddit-Refresh is a program that scans a provided subreddit (or set of subreddits) for one or more search terms, checks for new results on a provided time interval, and notifies the user using the Pushbullet API. Upon first run, it will prompt the user for their API token (located on this site > Access Tokens).
Example use cases: Getting news updates on a certain topic from /r/news, checking for a keycap set on /r/mechmarket, or checking for a certain game on /r/gamedeals.
- Clone the repo into whatever folder you want to use.
- Run
python3 setup.py developto make sure all dependencies are installed. - You're good to go! Just run
./reddit_refresh.pyorpython3 reddit_refresh.py
Upon first run, you will be prompted with options to configure Pushbullet pushes and searches. However, you can manually edit the file, located at ~/.config/reddit-refresh/config (on Linux) or INSTALL_FOLDER/.config/reddit-refresh/config, any time.
[User Info]
token = API_TOKEN #your api token goes here
[Devices]
#this is your device's name and unique id for Pushbullet
#can have as many entries as needed
DEVICE_NAME = DEVICE_ID
[Searches]
#subreddit followed by search terms separated by commas
#can have as many entries as needed
SUBREDDIT = TERM_1,TERM_2
[Program Config]
#how often to check for new search results
refresh interval = TIME_IN_MINUTES- Filter based on flair
- Send to all devices as one push
- Add option to append flair to title
- Add option to append date and time of post to title