Every morning, get your task lists by email, WhatsApp or SMS.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Glenn Y. Rolland d7784dd071 fix: update dev-dependency for security 1 year ago
.github/workflows CI/CD: change build command 2 years ago
cmd/musala Rename musala-push to musala 2 years ago
doc Add logo 2 years ago
docker Rename musala-push to musala 2 years ago
templates Better handling of template generation 2 years ago
tmp Update email mockup & ignore tmp dir 4 years ago
.dockerignore Prepare docker build 3 years ago
.gitignore Merge branch 'develop' 2 years ago
LICENSE.txt Improve documentation 4 years ago
Makefile Makefile: add bindir creation step 2 years ago
README.md doc: add section 'See also' to README 1 year ago
contrib-trello Update project name in sources 3 years ago
docker-compose.example.yml Update project name in sources 3 years ago
go.mod Update dependencies versions 2 years ago
go.sum Update dependencies versions 2 years ago
package-lock.json Fix dependabot alerts (again) 2 years ago
package.json fix: update dev-dependency for security 1 year ago

README.md

Musala

Build GitHub license Donate on patreon

Every morning, get the content of your favorite kanban board by email, WhatsApp or SMS.

Note: musala means work, occupation in Lingala

Roadmap

Task sources:

  • Trello
  • Nextcloud Deck (not yet) - API Reference
  • Wekan (not yet) - API Reference
  • Libreboard (not yet)
  • Github Projects (not yet)

Source selection

  • All of them
  • Favorited boards
  • Only selected ones

Delivery via:

  • E-mail
  • Telegram
  • Slack
  • SMS
  • Whatsapp
  • IRC

User interface for account configuration

  • Command line + environment variables
  • Web app

Installation

With go

Make sure you have Go installed, then type:

$ go install github.com/glenux/musala/...

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

  1. Create a Trello account on https://trello.com
  2. Check your mailbox and confirm your email
  3. Enable developper account on https://trello.com/app-key
  4. 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.

https://trello.com/1/authorize?expiration=never&scope=read,write,account&response_type=token&name=Musala%20Mail&key=YOUR-API-KEY

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

  1. Fork it ( http://github.com/glenux/musala/fork )
  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

Credits

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

Got questions? Need help? Tweet at @glenux

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