Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

SMS_Web ~ Secret Santa!


Kiosk like service for sending anonymous SMS messages with the goal to surprise your friends with a cocolate santa!

screenshot web

main idea

I'm a volunteer member at our local UNICEF university group. The original intention was to create a kiosk like interface, which students can use to send anonymous messages to a fellow student and inform them, that he or she just received a little present (we got some chocolate form our sponsor). Let's assume you want to suprise your close friend - she's still stuck in a boring class about business administration.

  1. Go to the UNICEF stand in the hallway, say hello to the people in the unicef shirts and type in the kiosk system: - the name of the lucky recipient - the mobile-number or email address - a short message
  2. Check the checkbox if you want to add a personal message pinned to the Chocolate-Santa
  3. Be kind and maybe donate some coins you found in your pocket (because there will always be change for the bar visit the night before and who puts change back in the wallet anyway)
  4. Every message will be logged in a database, but only be marked as 'sent' when we know the message was sent out successfully.
  5. She will receive the message via SMS or email including a pickup code! This message is anonymous and will not contain the name field. Even if you entered your name in the sender-field.
  6. She will pick up her present at the UNICEF stand in the hallway. Therefore she tells the people in the blue UNICEF shirts her pickup ID (It's the last 4 digits of the SMS)
  7. They will then type the ID in the searchfield and set the checkbox 'delivered'. TADAAAA: you just sent an anonymous secret chocolate santa!

Every message sent out contains a 4 digit pickup code (the lenght is configurable btw). overview

This is the Dashboard. It's just a little gimick to show some statistics. I might improve it for further usage. dashboard


In order to send SMS messages, you need a Sipgate account with some credit. Otherwise you might only be able to send out emails.


  1. have a look into You can modify the behaviour in production via setting environment variables.
  2. in - edit DATABASES - edit SECRET_KEY to some unique

test-run on localhost

  • go to working dir.
  • create a venv and install dependencies:
    virtualenv venv
    source venv/bin/activate
    pip install -r requirements.txt
  • setup database: python SMS_Web/ syncd
  • start the development server python SMS_Web/ runserver or python SMS_Web/ runserver to access the development server within your network.
  • go to http://localhost:8000

deploy to heroku

This project is prepared and configured to work on the heroku cloud.


Kiosk like service for sending anonymous SMS messages with the goal to surprise your friends with a cocolate santa!



No releases published


No packages published
You can’t perform that action at this time.