Shard Detail

happy-new-year-with-kdeconnect v0.1.0

Happy-Sending is a tool that makes it easy to send wishes to lots of people through short text messages.

Install & Use

Add the following code to your project's shard.yml under:

dependencies to use in production
- OR -
development_dependencies to use in development

  github: glenux/happy-send


🚨 The project has moved to a self-hosted git instance!
🚨 Please use the new URL for an up-to-date version:


Build GitHub license Donate on patreon

HappySend is a tool that makes it easy to send wishes to lots of people through short text messages.

It simply parses a CSV file and uses KDE Connect command line tool to control your smartphone.


  1. Make sure that a recent version of Crystal (0.35) is installed
  2. Make sure that kdeconnect-cli is installed

Then run the following commands :

$ shards install
$ make build

That should create the binary _build/happy-send


Available options

Happy Send - Mass send short text messages via your smartphone + kdeconnect


  happy-send [options] [arguments]


  -s, --send                       Send message for real (=not dry-run) [type:Bool] [default:false]
  -w, --wait=SECONDS               Wait SECONDS between each message (default: 5) [type:Int32] [default:5]
  -v, --verbose                    Enable debug messages [type:Bool] [default:false]
  -c FILE, --csv=FILE              Use given CSV (mandatory fields: number,message) [type:String] [required]
  --help                           Show this help.

Preparing your file

Fill a CSV file respecting the structure below. Note you can insert variables from other columns within your message.

"MAINTAINER","Glenn","Rolland","+33673983956","Happy new year {{ firstname }} !"
"HEROES","Jon","Snow","+33xxxxxx","Happy new year {{ firstname }} ! Winter is coming."
"HEROES","Harry","Potter","+32xxxxxx","Happy new year {{ firstname }} ! Expecto patronum in 2021 !"
"HEROES","Luke","Skywalker","+33xxxxxx","Happy new year {{ firstname }} ! May the force be with you in 2021"

Verify what will be done with the following command. No message will be sent yet :

$ _build/happy-send --csv config/friends.csv

Sending the messages !

Make sure your that

  1. Your smartphone has the KDE Connect app installed.
  2. Your smartphone is connected on the same wifi network as your computer

Verify that your computer is able to detect your smartphone

$ kdeconnect-cli -a
- Galaxy S8: b4fade0a33cdf703 (paired and reachable)
1 device found

If it is ok for you, launch it for real :

$ _build/happy-send --send --csv config/friends.csv


  1. Fork it ( )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request


  • Glenn Y. ROLLAND - author & maintainer:
  • You? Fork the project and become a contributor!

Got questions? Need help? Tweet at @glenux


Happy Send is Copyright © 2018-2019 Glenn ROLLAND. It is free software, and may be redistributed under the terms specified in the LICENSE.txt file.