Skip to content
This repository has been archived by the owner on Oct 24, 2021. It is now read-only.

cmitsakis/angaros

Repository files navigation

Angaros

Send email and SMS broadcasts to your contacts.

Angaros is a desktop application, so it does not require a complicated server setup.

Emails are sent via an SMTP service of your choice.

SMS are sent via your Android phone connected to your computer with the help of third party software.

Demo video

Supported platforms

It should work on Linux, Windows 8.1+, macOS 10.13+, although it has only been tested on Linux and macOS 11.

Sending SMS via ADB is supported on Android versions from 5 to 10 but it might not work on some versions since it hasn't been tested. Android 11 is not supported yet.

Warning

This is alpha quality software released for testing purposes. Not recommended for production use. Bug reports are appreciated.

You are responsible for compliance with laws and regulations regarding electronic communications, and your carrier's terms of service.

Installation

Option 1: Download release binary (recommended)

Download the latest release and run it. No installation is required.

macOS

On macOS you have to remove the application from quarantine by running the following command:

xattr -d com.apple.quarantine /path/to/angaros

Option 2: Build from source

If you have installed the compile-time requirements (Go and Fyne prerequisites), you can install Angaros using the following command:

go install go.angaros.io/cmd/angaros@latest

Third-party software

In order to send SMS, you have to install ADB.

ADB might not work on all Android versions. It requires your phone is connected over USB and has USB debugging enabled.

Alternatively you can install KDE Connect but it currently doesn't work. It's included for testing purposes only.

ADB (recommended)

  1. download and install ADB
  2. start ADB
  3. connect your Android phone to your computer via USB
  4. enable developer options and USB debugging on your phone

KDE Connect (for testing only)

  1. download and install KDE Connect. Windows users can also install it from the Microsoft store.
  2. install the KDE Connect app on your Android phone
  3. pair your phone with your computer

KDE Connect does not support macOS.

Contributing

Reporting bugs

Good bug reports are the most valuable contribution, if they include enough information to reproduce the bug.

Please search existing issues before opening a new one. If an issue already exists, you can add more information.

Your bug reports should include:

  1. steps to reproduce the bug (this is very important!)
  2. what you expected to happen
  3. what actually happens
  4. screenshots or logs if possible (make sure to remove any personally identifiable information like emails, phones)
  5. the version you are using (including ADB or KDE Connect version if applicable)
  6. your operating system

Contributing code

  • Create small PRs addressing a single issue
  • Maintain clean commit history with atomic commits
  • Mention the issue number in your commit messages
  • Major changes and new features should be discussed first

Contributions license

Your contributions must be licensed under the terms of the Blue Oak Model License 1.0.0 (see License). Add License: BlueOak-1.0.0 as a trailer at the end of your commit messages to acknowledge this. You can configure Git to add this trailer automatically on all your commits for this repository (whenever you use git commit without -m) by running the following command at the root of this repository:

git config commit.template .gitmessage.txt

License

Copyright (C) 2021 Charalampos Mitsakis

Angaros is licensed under the terms of the PolyForm Internal Use License 1.0.0. This is a source-available license that permits use and modifications for internal business purposes only, while prohibiting distribution, SaaS, and service bureau use.

Third-party contributions are licensed under the terms of the Blue Oak Model License 1.0.0.

As additional permission, you are allowed to contribute your modifications back as pull requests to this repository, provided that your contributions are licensed under the terms of the Blue Oak Model License 1.0.0. By submitting a pull request you certify that you can and do license your contribution under the terms of the Blue Oak Model License 1.0.0. Publicly maintaining an independent fork is not permitted. This additional permission does not allow you to modify the license, the additional permission, or the copyright notice.

About

Desktop app for sending email and SMS broadcasts to your contacts. Renamed to polysender: https://github.com/cmitsakis/polysender

Resources

License

Unknown and 2 other licenses found

Licenses found

Unknown
LICENSE.md
Unknown
LICENSE-BlueOak.md
Unknown
LICENSE-PolyForm-Internal-Use.md

Stars

Watchers

Forks

Packages

No packages published

Languages