π
AutomaticTwitterGiveaways
π
AutomaticTwitterGiveaways automates selecting winners for "Retweet, Comment, Follow" type Twitter giveaways.
Contents
Quick Start
Choose from one of these two options:
1. Download a pre-built Executable
This method does not require installing any dependencies
- Download the Latest Release
- Extract the files.
- Modify
twitter_giveaway_config.inito suit your needs (See Configuration) - Double-click on
Run Twitter Giveaway.exe!
2. Run with Python
This method requires that Python be installed.
- Clone this repo
git clone https://github.com/elsell/AutomaticTwitterGiveaways
- Navigate to project root directory
cd AutomaticTwitterGiveaways
- Install Dependencies
python -m pip install -r requirements.txt
-
Modify
twitter_giveaway_config.inito suit your needs (See Configuration) -
Run the script
python ./automatic_twitter_giveaways.py
Configuration
Important: A file named
twitter_giveaway_config.inimust exist in the same directory as the script.
Below is an example configuration file. Please note that to run AutomaticTwitterGiveaways, you must have a Bearer Token that you can get by registering for a Twitter developer account (free).
;twitter_giveaway_config.ini
[TwitterAuthentication]
; Your Twitter Username
TwitterUsername=elonmusk
; Developer API Bearer Token
; Get one here:
; https://developer.twitter.com/en/portal/petition/essential/basic-info
BearerToken=
[GiveawayDetails]
; The URL of the tweet asking for retweets, comments, follows
GiveawayTweetURL=https://twitter.com/StubzNFT/status/1478720942981500939
; A hashtag required to make a comment valid
; (Omit the #. Ex. #NFT should be entered NFT)
GiveawayTweetHashtag=NFT
; Your timezone. Must be a valid TZ database name.
; A list of valid timezone strings can be found on Wikipedia:
; https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List
GiveawayTimezone=America/Chicago
; Start date/time of the giveaway (usually the time of the first tweet)
; The start date/time must be NO MORE than 7 days prior.
; This is a limitation of the Twitter API, unfortunately.
GiveawayStartYear=2022
GiveawayStartMonth=1
GiveawayStartDay=5
; Specify the hour in 24hr time.
; Ex. 1PM => 13
GiveawayStartHour=16
GiveawayStartMinute=0
; End date/time of the giveaway
GiveawayEndYear=2022
GiveawayEndMonth=1
GiveawayEndDay=10
; Specify the hour in 24hr time.
; Ex. 1PM => 13
GiveawayEndHour=0
GiveawayEndMinute=00
[ListOutput]
; Output a CSV list of name,username for each user that both
; retweeted GiveawayTweetURL and follows TwitterUsername
OutputRetweetsAndFollows=True
; The name of the file to which to write the above-mentioned data.
OutputFileName=followsAndRetweets.csv
[DEBUG]
; Display debug information, such as API request URLs
Debug=False
Developer Notes
First and foremost, I acknowledge that this tool has a pretty narrow use-case. It was designed and built to solve a specific problem for a specific user.
However, I have done my best to design it such that others may find some use in it. If you have a use-case that is slightly different, and have Python experience, please fork this repo and modify as needed!
I will keep a list of all current (functionally-additive) forks and their use-cases in this repo.
Having issues?
Please create an issue! I don't provide any warranty with this software, but I will be happy to give your issue a look. It also helps others who may be looking to use this software determine if it is a good fit for them
If you're a student
There is some messy code in here! Code duplication is through the roof at some points. There are better, more Pythontic ways to do what this does.
So if this bothers you AND you have time to do something about it, please use this repo as an opportunity to delve into the open-source world! Fork, make some changes, and submit a pull-request.
The project is relatively small and would be a great introduction to contributing to the FOSS world :)
8 Nov 18, 2022
1 Jun 1, 2022
27 Oct 1, 2022
7 Apr 11, 2022
215 Dec 23, 2022
10 Apr 28, 2022
10 Feb 23, 2022
16 Oct 25, 2022
1 Feb 17, 2022
71 Nov 18, 2022
2 Feb 03, 2022
12 Nov 12, 2022
9 Dec 14, 2022
26 Aug 05, 2022
121 Jan 01, 2023
13 Jun 20, 2021
1 Nov 21, 2021
20 Dec 27, 2022
138 Dec 15, 2022
2 Nov 05, 2021
5 Nov 24, 2022
27 Dec 30, 2022
3 Jan 22, 2022
66 Nov 18, 2022
20 Dec 27, 2022
3 Jul 15, 2022
1.4k Jan 07, 2023
4 Feb 05, 2022
2 Oct 21, 2022