tenzap / kalkun

Open Source Web based SMS Management

Kalkun - Open Source Web-based SMS Manager

Kalkun is an open source web-based SMS (Short Message Service) manager. It uses gammu-smsd (part of gammu family) as SMS gateway engine to deliver and retrieve messages from your phone/modem.

• Homepage : https://kalkun.sourceforge.io/
• Documentation : https://github.com/kalkun-sms/Kalkun/wiki/

Features

• Support for MySQL, PostgreSQL and SQLite3
• Multi user & Multi modem support
• Usual folders: inbox, outbox, sentitems, spam, trash & personal folders.
• Conversation view: SMS are grouped by phone number
• Spam filter based on b8
• Phonebook, contacts, groups
• Various "compose SMS" options:
  • to a number, contact or a group
  • schedule to specific date/time or with a delay
  • reply, forward, resend
  • SMS merge
  • SMS template
• Automatic message signature
• Filter incoming messages
• Keyboard shortcuts
• API access
• Localization
• Kalkun core parameters
  • Conversation grouping
  • Disable all outgoing SMS
  • Alternate gateways (send-out only) if you don't want to use Gammu backend
  • Append ads to your message
  • Send SMS repeatedly with SMS bomber

Requirements

For full details, see the requirements on the wiki.

Briefly, this is what has to be installed & configured prior to installing Kalkun:

• HTTP Server (any of Apache httpd, Lighttpd, NGINX, IIS...)
• Composer (Dependency Manager for PHP)
• PHP >=5.6, >=7, >=8
• PHP-CLI (command line interface)
• PHP extensions (composer should tell you which ones are missing on your system)
• MySQL/MariadDB 5.5.3+ (having full UTF-8 support) or PostgreSQL or SQLite3
• Gammu SMSD (make sure it is already running and configured)

Installation

You can find detailed installation instructions on the wiki.

There are also Debian & derivatives (Ubuntu...) packages produced for releases and snapshots on every commit. Detailed installation instructions to use the Debian package are on the wiki.

Brief installation steps

Find the detailed installation steps on the wiki.

If you are upgrading, check the Release notes.

Steps in brief:

1. Extract to web root folder (eg: /var/www/html => Ubuntu)
2. Run composer install from there to get & check the dependencies.
3. Create the gammu smsd database.
   • Kalkun uses the database that is created by gammu with all the tables created by gammu. Kalkun then adds tables and some columns. So there is no such case where one has a gammu database separate from the kalkun database. Both software share the same database.
4. Import gammu database schema (it's included on gammu sources, eg. gammu/docs/sql/mysql.sql).
5. Configure Kalkun daemon & outbox_queue scripts (to manage inbox and autoreply)
6. Optionally: increase the security of your installation
7. Configure the connection to the database in application/config/database.php
8. Launch the install wizard of Kalkun, preferably by going to http://localhost/kalkun/index.php/install
9. Delete the installation file (the install wizard tell you where it is, if this step is needed)
10. Change the default encryption key in application/config/config.php
11. Launch Kalkun by browsing to http://localhost/kalkun. Default login and password are kalkun.

Contributing

Please check the wiki contribution suggestions.

Documentation

See the documentation on the Wiki

License

Kalkun is licensed under GPL-2.0-or-later.