.github/workflows | ||
cmd/musala | ||
doc | ||
docker | ||
templates | ||
tmp | ||
.dockerignore | ||
.drone.yml | ||
.gitignore | ||
contrib-trello | ||
docker-compose.example.yml | ||
go.mod | ||
go.sum | ||
LICENSE.txt | ||
Makefile | ||
package-lock.json | ||
package.json | ||
README.md |
Every morning, get the content of your favorite kanban board by email, WhatsApp or SMS.
Note: musala means work, occupation in Lingala
Roadmap
Multiple task sources & destinations:
- ✔️ Trello
- ❌ Nextcloud Deck (not yet) / Wekan (not yet) / Gitea / Forgejo (not yet) / Libreboard (not yet) / Github Projects (not yet)
Board Data selection:
- ✔️ All boards / Favorited boards / Only selected ones
Task actions:
- ✔️ List tasks
- ❌ Create task / Read task / Update task / Remove task
Delivery via:
- ❌ Terminal / Webhook / UnifiedPush / Telegram / Slack / SMS / Whatsapp / IRC
UI for task management:
- ✔️ Simple CLI + environment variables
- ❌ Composable CLI + environment variables / Web UI
Installation
With go
Make sure you have Go installed, then type:
$ go install github.com/glenux/musala/...@master
or
$ go install code.apps.glenux.net/glenux/musala/...@master
It will install Musala Mail binary in $GOPATH/bin
With docker
Make sure you have Docker installed, then type:
$ docker build -t musala -f docker/Dockerfile .
Usage
Creating a developper account
- Create a Trello account on https://trello.com
- Check your mailbox and confirm your email
- Enable developper account on https://trello.com/app-key
- Get an developer API KEY
Getting a Trello TOKEN
Open the following URL in your web browser and authenticate yourself. That will give you the TRELLO_TOKEN that will be needed in the next step.
Using the binary
Prepare your environment with the following variables
EMAIL_FROM: no-reply@example.com
EMAIL_TO: me@example.com
EMAIL_SUBJECT: "Daily mail for YYYYYY"
TRELLO_URL: https://trello.com/b/xxxxx/yyyy
TRELLO_TOKEN: xxxxxxxxxxxxxx
SMTP_HOSTNAME: smtp.example.com
SMTP_USERNAME: foobar@example.com
SMTP_PASSWORD: securefoobar
SMTP_PORT: 587
# SMTP_AUTH_TYPE accepts either "none", "plain" or "login"
SMTP_AUTH_TYPE: plain
# SMTP_SECURITY_TYPE accepts either "none", "tls" or "starttls"
SMTP_SECURITY_TYPE: tls
Then run the program:
$ $GOPATH/bin/musala
Using with docker
$ docker build -f docker/Dockerfile -t musala .
$ docker run \
-e EMAIL_FROM=
-e EMAIL_TO=
-e EMAIL_SUBJECT=
-e EMAIL_FROM=
-e EMAIL_TO=
-e EMAIL_SUBJECT=
-v /var/lib/musala/musala.cron:/app/musala.cron \
-it musala:latest
Contributing
- Fork it ( http://github.com/glenux/musala/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request
Credits
- Glenn Y. ROLLAND - author & maintainer:
- You? Fork the project and become a contributor!
Got questions? Need help? Tweet at @glenux
Thanks
Thanks to Tamim & Stephanie for watching me updating this project.
License
Musala is Copyright © 2018-2021 Glenn ROLLAND. It is free software, and may be redistributed under the terms specified in the LICENSE.txt file.
See also...
Following projects may also inspire you:
- 72nd/deck-cli: a command-line tool for interacting with Nextcloud's Deck Plugin by using it's API
- Nextcloud API Reference
- Wekan API Reference
- Gitea API Usage and Gitea API Reference