2020-07-25 20:35:38 +00:00
# Pantalaimon UT
2020-07-14 00:59:16 +00:00
End-to-end encryption aware Matrix reverse proxy daemon for Ubuntu Touch.
2020-08-09 23:20:02 +00:00
[source code ](https://git.sr.ht/~thrrgilag/pantalaimon-ut ) -
[issue tracker ](https://todo.sr.ht/~thrrgilag/pantalaimon-ut ) -
[mailing list ](https://lists.sr.ht/~thrrgilag/pantalaimon-ut ) -
[releases ](https://git.sr.ht/~thrrgilag/pantalaimon-ut/refs )
2020-07-14 00:59:16 +00:00
## TODO
2021-02-17 22:37:28 +00:00
- [x] About page
- [x] App icon
- [x] Fix image fetching (fixed in fluffychat)
2021-03-10 06:27:12 +00:00
- [x] Cross compile python+pantalaimon
2021-09-08 13:59:16 +00:00
- [-] Import/export keys
- [-] Ability to verify, ignore, or blacklist devices
2021-02-17 22:36:07 +00:00
## Known Issues
2021-09-08 13:59:16 +00:00
- Previously encrypted messages may not be decrypted
2020-07-14 00:59:16 +00:00
2021-09-08 13:59:16 +00:00
## panctl
2021-03-13 22:34:51 +00:00
2021-09-08 13:59:16 +00:00
The ability to verify, ignore, or blacklist devices is currently limited to the use of the panctl utility which can be accessed using the Terminal app by running `/opt/click.ubuntu.com/pantalaimon.thrrgilag/current/panctl` . See the [man ](https://github.com/matrix-org/pantalaimon/blob/master/docs/man/panctl.md ) for details on how to use it.
2021-03-13 22:34:51 +00:00
2021-09-08 13:59:16 +00:00
## Build pantalaimon and panctl
2020-07-14 00:59:16 +00:00
2021-09-08 13:59:16 +00:00
The background daemon (pantalaimon) and shell utility (panctl) are built directly on device due to complications with cross compiling dependencies. You'll need a device with sufficient space free on the system partition to install all of the required packages. For the most recent release I utilized a Raspberry Pi 4 to create the binaries for arm64 and armhf.
2020-07-14 03:57:58 +00:00
2021-09-08 13:59:16 +00:00
1. Put the dev-build.sh script in /home/phablet on the target device and execute `./dev-build.sh`
2. Pull the ~/pantalaimon-build/dist/pantalaimon and ~/pantalaimon-build/dist/panctl to your local source tree
3. Rename the files to add -{ARCH} *(e.g. mv pantalaimon pantalaimon-arm64)*
2021-03-10 06:27:12 +00:00
2021-09-08 13:59:16 +00:00
## Build click package
- Install or update [clickable ](https://clickable-ut.dev/en/latest/install.html )
- For ARM64 devices run `clickable --arch=arm64`
- For ARMHF devices run `clickable --arch=armhf`
2020-07-14 00:59:16 +00:00
2020-07-14 03:57:58 +00:00
## Contributing
2022-06-22 13:25:24 +00:00
Report bugs or send patches to the [mailing list].
2020-07-14 03:57:58 +00:00
2022-06-22 13:25:24 +00:00
A tutorial for git send-email can be found at [git-send-email.io]
2020-07-14 03:57:58 +00:00
if you're not familiar with this method.
2022-06-22 13:25:24 +00:00
Join my public chat room for development discussion.
- [#dev:thrrgilag.ems.host]
- [xmpp:dev@groups.clacks.network]
- [#thrrgilag on Libera.Chat]
2020-07-14 03:57:58 +00:00
2020-07-14 00:59:16 +00:00
## License
2021-03-10 06:27:12 +00:00
Copyright (C) 2021 Morgan McMillian
2020-07-14 00:59:16 +00:00
Licensed under the Apache Software License 2.0
2022-06-22 13:25:24 +00:00
[mailing list]: https://lists.sr.ht/~thrrgilag/pantalaimon-ut
[git-send-email.io]: https://git-send-email.io/
[#dev:thrrgilag.ems.host]: https://matrix.to/#/#dev:thrrgilag.ems.host
[xmpp:dev@groups.clacks.network]: xmpp:dev@groups.clacks.network?join
[#thrrgilag on Libera.Chat]: ircs://irc.libera.chat/#thrrgilag
