"Are you tired of having to manually write and send christmas texts to everyone on christmas to mantain a good relationship with them? Do you want to be the annoying person who is the first one to send "Happy new year" messages to everyone on your contact list exactly at midnight? Do you want to be a bad boy this christmas season? I got you covered."
Strongly inspired by my other project RomanceBreaker, introducing Christmas Spirit Breaker, a python script which automatically sends a custom christmas/new year's greeting message, from a custom messages list, to your selected contacts you want to mantain good relationships with, at given time range on Facebook Messenger, WhatsApp, Telegram or via SMS. Time to be bad boys this christmas. Work smarter, not Harder.
- More time spent with the new body pillow you just received for christmas.
- More time spent stealing new year's champagne from people who are busy texting their friends.
- Mantain those relationships with friends (if you don't send greetings on such events they will know you are not a true friend)
- Magic
Santa relies on reindeers for delivery, and so does Christmas Spirit Breaker rely on a few things, here is what to do to get them:
- Python3 is needed get it from here
Run these commands in your preferred terminal application
sudo apt-get install python3-pip
pip3 install fbchat bs4
git clone https://github.com/lorcalhost/ChristmasSpiritBreaker-andNewYearsToo.git
- Also install git from here
- Make sure you run all the commands from git
pip install fbchat bs4
git clone https://github.com/lorcalhost/ChristmasSpiritBreaker-andNewYearsToo.git
From Android you will only be able to run the Facebook Messenger version, here are the instructions:
- First download and install Termux from the Google Play Store
- Then run the following commands:
termux-setup-storage
and allow storage access
cd storage/downloads
pkg install python3 git
pip3 install fbchat requests bs4 enum
git clone https://github.com/lorcalhost/ChristmasSpiritBreaker-andNewYearsToo.git
Please note that every time you restart your device, you will have to re run the commands in the How to run section
Santa relies on reindeers for delivery, and so does Christmas Spirit Breaker rely on a few things, here is what to do to get them:
- Python3 is needed get it from here
Run these commands in your preferred terminal application
sudo apt-get install python3-pip
pip3 install telethon bs4
git clone https://github.com/lorcalhost/ChristmasSpiritBreaker-andNewYearsToo.git
- Also install git from here
- Make sure you run all the commands from git
pip install telethon bs4
git clone https://github.com/lorcalhost/ChristmasSpiritBreaker-andNewYearsToo.git
From Android you will only be able to run the Facebook Messenger version, here are the instructions:
- First download and install Termux from the Google Play Store
- Then run the following commands:
termux-setup-storage
and allow storage access
cd storage/downloads
pkg install python3 git
pip install fbchat requests bs4 enum
git clone https://github.com/lorcalhost/ChristmasSpiritBreaker-andNewYearsToo.git
Please note that every time you restart your device, you will have to re run the commands in the How to run section
Santa relies on reindeers for delivery, and so does Christmas Spirit Breaker rely on a few things, here is what to do to get them:
- Python3 is needed get it from here
- Chrome Driver get it from here and unzip in the
ChristmasSpiritBreaker-andNewYearsToo
folder - If you want to setup SMS you will need to have Google messages on your Android phone
Run these commands in your preferred terminal application
sudo apt-get install python3-pip xclip
sudo pip3 install selenium bs4 pyperclip
git clone https://github.com/lorcalhost/ChristmasSpiritBreaker-andNewYearsToo.git
- Also install git from here
- Make sure you run all the commands from git
pip install selenium bs4 pyperclip
git clone https://github.com/lorcalhost/ChristmasSpiritBreaker-andNewYearsToo.git
First go to the program directory by typing in the terminal:
- From PC:
cd ChristmasSpiritBreaker-andNewYearsToo
- From Android:
cd storage/downloads/ChristmasSpiritBreaker-andNewYearsToo
Then run the script with the according argument:
- For WhatsApp version:
python3 christmasSpiritBreaker.py -w
orpython3 christmasSpiritBreaker.py whatsapp
- For Messenger version:
python3 christmasSpiritBreaker.py -m
orpython3 christmasSpiritBreaker.py messenger
- For SMS version:
python3 christmasSpiritBreaker.py -s
orpython3 christmasSpiritBreaker.py sms
- For Telegram version:
python3 christmasSpiritBreaker.py -t
orpython3 christmasSpiritBreaker.py telegram
Also other arguments exist like:
- To open user guide:
python3 christmasSpiritBreaker.py -h
orpython3 christmasSpiritBreaker.py help
orpython3 christmasSpiritBreaker.py man
- To update the script:
python3 christmasSpiritBreaker.py update
For Android users: you will also need to press "ACQUIRE WAKELOCK"
in the Termux notification to enable the script to run in the background withoutthe process being killed
Android right now only supports Facebook Messenger mode
Android users may want to edit the config.py
file with their preferred text editing app as the file will be in the Downloads folder of their devices
Simply open the config.py
file with your preferred text editing app and follow the instructions there, I think I made them clear enough
If you don't want to use the bot for both christmas and new years you can disable the fatures individually by setting to False
the lines
christmasModeEnabled = True # Change to False to disable Christmas mode
newYearsModeEnabled = True # Change to False to disable New Year's mode
Replace the messages in between " "
with your own custom messages, you can also add more custom messages by adding after the "
of the last message a comma and a new message, always in between " "
s.
If we want to add New custom message
to the list below
christmas_messages = ["Merry christmas!"]
We just need to edit it like this:
christmas_messages = ["Merry christmas!", "New custom message"]
Important:
- Make sure that if you are setting up WhatsApp contatcs or SMS contacts you are writing their names as they appear in your phone's conatct list
- If you are using Messenger use your contact's messenger username
Replace the contact names in between " "
with your own custom contact names, you can also add more custom contacts by adding after the "
of the last contact a comma and a new contacts, always in between " "
s.
If we want to add Santa Claus
to the list below
christmas_contact_names = ["John McAfee"]
We just need to edit it like this:
christmas_contact_names = ["John McAfee", "Santa Claus"]
The christmas messages will be sent on December 25th
The new years messages will be sent on January 1st
If we want to change the christmas time range we have to edit this line:
christmas_time_interval = ["08:00", "23:59"]
If we want to change the new year's time range we have to edit this line:
newYears_time_interval = ["00:00", "00:15"]
Make sure the hour is always two digits
- Log in to your Telegram core: https://my.telegram.org.
- Go to ‘API development tools’ and fill out the form.
- Create an app
- You will get the
api_id
andapi_hash
parameters required for user authorization (to put in the config.py file).
If you have any trouble with your setup feel free to message me on Telegram @lorcalhost