π
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
10 Dec 01, 2022
17 Nov 12, 2022
6 Aug 25, 2022
66 Dec 07, 2022
7.3k Nov 18, 2022
1 Jan 13, 2022
6 Jan 13, 2022
5 Dec 17, 2021
6 Jan 30, 2022
0 May 13, 2022
0 Dec 08, 2021
2 Sep 06, 2022
37 Oct 29, 2022
5 Aug 28, 2022
6 Sep 30, 2022
173 Nov 10, 2022
1 May 08, 2022
3 Jul 26, 2022
10 Aug 13, 2022
9 Jul 08, 2021