`tootgroup.py` - Group accounts on Fediverse services that don't support them natively.
=================================================
Tested to be compatible with:
------------
``Hosting groups:`` Mastodon, Pleroma and GoToSocial - others will probably work too.
``Posting to groups:`` Mastodon, Pleroma GoToSocial and Friendica - others will
very likely work.
What is this?
-------------
Some federated social media platforms allow groups of users to post into a
unified "group" timeline/instance/whatever you want to call it. This is currently
not possible on Mastodon or other services that are styled after it, except by
giving all members full login credentials to a group. `tootgroup.py` is an
attempt to solve this specific use case.
`tootgroup.py` groups can be hosted on a variety of services that are compatible
with the Mastodon API. All tested platforms are listed above, more will very
likely work just as good and all tests are welcome!
How does it work?
-----------------
`tootgroup.py` has to be set up on a computer and run periodically. It reads the
notifications from the Fediverse account it is connected to and filters
them for messages to repost. The group consists of all user accounts the group
account is following. Unfollowing accounts, removes users from the group again.
There are two methods of creating a group post. One or both of them can be
enabled during the setup procedure.
1. Public mentions of group members are boosted if they preceed the group's
name with an Exclamation Mark like "!@mastodon". For for posts originating
from Friendica the correct syntax is "!mastodon".
2. `tootgroup.py` can also look for direct messages from group members. If the
group is @mentioned at the very beginning, The message will be reposted as
a new public toot originating directly from the group account. The status
text as well as media files are included. The originating user will not be
shown publicly. (It can still be seen by all group and instance
administrators tough!)
If both repost methods are disabled, `tootgroup.py` will still run but not repost
anything.
But how to simply use it?
-------------------------
### Mastodon/Pleroma/GoToSocial and others
1. Write a message that should be boosted by the group:
Just include "!@group_name" anywhere in the toot.
EXAMPLE: "OHAI! just found that !@mastodon thingie!"
2. Write a message that should appear as a new post from the group:
Put "@group_name" at the very beginning of a direct/private message.
EXAMPLE: "@mastodon HERE BE THE MESSAGE TEXT"
### Friendica
Because of its history and much more flexible nature, things are a bit different
and maybe even a bit more complicated when posting from Friendica. Nevertheless
this is fully supported, tested and in daily use.
1. Write a message that should be reposted by the group:
Friendica handles the Exclamation Mark in a special way because it is also
used to address the Friendica Forum functionality. Therefore the Asterisk is
used instead of the Exclamation Mark. Just include "*@group_name" anywhere in
the message. - This would also work with other services like Mastodon, just
don't tell them ;-)
EXAMPLE (from Friendica): "OHAI! just found that *@mastodon thingie!"
2. Write a message that should appear as a new post from the group:
You can send a direct message by limiting the visibility of a "normal" post
or by using the personal message menu. The second method does not work with
images though, so creating normal posts with limited visibility is preferred.
You should always leave the Title/Subject field empty, it might not work as
expected otherwise. Put "@group_name" at the very beginning of a
direct/private message.
EXAMPLE: "@mastodon HERE BE THE MESSAGE TEXT"
How to set up?
--------------
The easiest way to install `tootgroup.py` is via PyPI, the Python Package Index.
Use `pip3 install tootgroup.py` to install it as well as all its dependencies.
It is also possible to download the script manually from the GitHub repository at
<https://github.com/oe4dns/tootgroup.py> In that case the necessary dependencies
have to be provided too:
`tootgroup.py` requires <https://github.com/halcy/Mastodon.py> as well as
<https://pypi.org/project/platformdirs> to run. Install them via your
operating system's package manager, pip or even manually.
`tootgroup.py` will guide you through setup by asking all information it needs
when you run it from the commandline for the first time. Being somewhat
comfortable with Python scripting and the commandline in general might help
if difficulties should appear.
1. You need an account on any Fediverse instance that will act as
your group account. Think about if you should mark it as a "Bot".
2. Run `tootgroup.py` from the command line.
3. `tootgroup.py` will ask you for all needed setup data and try to get them
right by connecting to the Fediverse server. If it cannot do so, it
will tell you and you can retry. When successful, `tootgroup.py` will write
the configuration to its tootgroup.conf file and read it from there next
time you run the script.
The place for storing configuration is operating system dependent but will be
shown during the first-run/setup phase. A local tootgroup.conf file placed
next to the `tootgroup.py` script will override these settings though and can
be used for development or testing purposes.
4. If you want to set up `tootgroup.py` for more than one group, you can run it
again while specifying the "--group GROUP_HANDLE" flag. This will then
generate an independent configuration that will be read each time you call
`tootgroup.py` using this name. If you don't specify any group name, the
handle "default" is created and used automatically
5. Test the funcionality by sending direct messages and "!@mentions" to your
group while running `tootgroup.py` manually. See if things work as expected.
The script will print an according message after each successful run.
If everything works, run the script periodically via cron and enjoy
groop-tooting!
Here is an example for a crontab entry that runs `tootgroup.py` every two minutes:
`*/2 * * * * /path/to/tootgroup.py --group default`
6. There is also the "-d" or "--dry-run" commandline flag that prevents any toots.
You can use it to test what would be posted by the script.
Use "-h" or "--help" for more information about all available options
Raw data
{
"_id": null,
"home_page": null,
"name": "tootgroup.py",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "mastodon, pleroma, friendica, gotosocial, toot, group, account, fediverse",
"author": null,
"author_email": "Andreas Schreiner <andreas.schreiner@sonnenmulde.at>",
"download_url": "https://files.pythonhosted.org/packages/9a/2a/704ba18e97b2cd0caa7380942d985eeeeb3cbffbf635caf55961d644ed13/tootgroup_py-1.5.tar.gz",
"platform": null,
"description": "\n`tootgroup.py` - Group accounts on Fediverse services that don't support them natively.\n=================================================\n\nTested to be compatible with:\n------------\n\n``Hosting groups:`` Mastodon, Pleroma and GoToSocial - others will probably work too.\n\n``Posting to groups:`` Mastodon, Pleroma GoToSocial and Friendica - others will\n very likely work.\n\nWhat is this?\n-------------\n\nSome federated social media platforms allow groups of users to post into a\nunified \"group\" timeline/instance/whatever you want to call it. This is currently\nnot possible on Mastodon or other services that are styled after it, except by\ngiving all members full login credentials to a group. `tootgroup.py` is an\nattempt to solve this specific use case.\n\n`tootgroup.py` groups can be hosted on a variety of services that are compatible\nwith the Mastodon API. All tested platforms are listed above, more will very\nlikely work just as good and all tests are welcome!\n\nHow does it work?\n-----------------\n\n`tootgroup.py` has to be set up on a computer and run periodically. It reads the\nnotifications from the Fediverse account it is connected to and filters\nthem for messages to repost. The group consists of all user accounts the group\naccount is following. Unfollowing accounts, removes users from the group again.\n\nThere are two methods of creating a group post. One or both of them can be\nenabled during the setup procedure.\n\n1. Public mentions of group members are boosted if they preceed the group's\n name with an Exclamation Mark like \"!@mastodon\". For for posts originating\n from Friendica the correct syntax is \"!mastodon\".\n\n2. `tootgroup.py` can also look for direct messages from group members. If the\n group is @mentioned at the very beginning, The message will be reposted as\n a new public toot originating directly from the group account. The status\n text as well as media files are included. The originating user will not be\n shown publicly. (It can still be seen by all group and instance\n administrators tough!)\n\nIf both repost methods are disabled, `tootgroup.py` will still run but not repost\nanything.\n\nBut how to simply use it?\n-------------------------\n\n### Mastodon/Pleroma/GoToSocial and others\n\n1. Write a message that should be boosted by the group:\n Just include \"!@group_name\" anywhere in the toot.\n\n EXAMPLE: \"OHAI! just found that !@mastodon thingie!\"\n\n2. Write a message that should appear as a new post from the group:\n Put \"@group_name\" at the very beginning of a direct/private message.\n\n EXAMPLE: \"@mastodon HERE BE THE MESSAGE TEXT\"\n\n### Friendica\n\nBecause of its history and much more flexible nature, things are a bit different\nand maybe even a bit more complicated when posting from Friendica. Nevertheless\nthis is fully supported, tested and in daily use.\n\n1. Write a message that should be reposted by the group:\n Friendica handles the Exclamation Mark in a special way because it is also\n used to address the Friendica Forum functionality. Therefore the Asterisk is\n used instead of the Exclamation Mark. Just include \"*@group_name\" anywhere in\n the message. - This would also work with other services like Mastodon, just\n don't tell them ;-)\n\n EXAMPLE (from Friendica): \"OHAI! just found that *@mastodon thingie!\"\n\n2. Write a message that should appear as a new post from the group:\n You can send a direct message by limiting the visibility of a \"normal\" post\n or by using the personal message menu. The second method does not work with\n images though, so creating normal posts with limited visibility is preferred.\n You should always leave the Title/Subject field empty, it might not work as\n expected otherwise. Put \"@group_name\" at the very beginning of a\n direct/private message.\n\n EXAMPLE: \"@mastodon HERE BE THE MESSAGE TEXT\"\n\nHow to set up?\n--------------\n\nThe easiest way to install `tootgroup.py` is via PyPI, the Python Package Index.\nUse `pip3 install tootgroup.py` to install it as well as all its dependencies.\n\nIt is also possible to download the script manually from the GitHub repository at\n<https://github.com/oe4dns/tootgroup.py> In that case the necessary dependencies\nhave to be provided too:\n\n`tootgroup.py` requires <https://github.com/halcy/Mastodon.py> as well as\n<https://pypi.org/project/platformdirs> to run. Install them via your\noperating system's package manager, pip or even manually.\n\n`tootgroup.py` will guide you through setup by asking all information it needs\nwhen you run it from the commandline for the first time. Being somewhat\ncomfortable with Python scripting and the commandline in general might help\nif difficulties should appear.\n\n1. You need an account on any Fediverse instance that will act as\n your group account. Think about if you should mark it as a \"Bot\".\n\n2. Run `tootgroup.py` from the command line.\n\n3. `tootgroup.py` will ask you for all needed setup data and try to get them\n right by connecting to the Fediverse server. If it cannot do so, it\n will tell you and you can retry. When successful, `tootgroup.py` will write\n the configuration to its tootgroup.conf file and read it from there next\n time you run the script.\n\n The place for storing configuration is operating system dependent but will be\n shown during the first-run/setup phase. A local tootgroup.conf file placed\n next to the `tootgroup.py` script will override these settings though and can\n be used for development or testing purposes.\n\n4. If you want to set up `tootgroup.py` for more than one group, you can run it\n again while specifying the \"--group GROUP_HANDLE\" flag. This will then\n generate an independent configuration that will be read each time you call\n `tootgroup.py` using this name. If you don't specify any group name, the\n handle \"default\" is created and used automatically\n\n5. Test the funcionality by sending direct messages and \"!@mentions\" to your\n group while running `tootgroup.py` manually. See if things work as expected.\n The script will print an according message after each successful run.\n If everything works, run the script periodically via cron and enjoy\n groop-tooting!\n\n Here is an example for a crontab entry that runs `tootgroup.py` every two minutes:\n\n `*/2 * * * * /path/to/tootgroup.py --group default`\n\n6. There is also the \"-d\" or \"--dry-run\" commandline flag that prevents any toots.\n You can use it to test what would be posted by the script.\n\n Use \"-h\" or \"--help\" for more information about all available options\n",
"bugtrack_url": null,
"license": null,
"summary": "Group account features on Mastodon and many other Fediverse platforms",
"version": "1.5",
"project_urls": {
"Homepage": "https://github.com/oe4dns/tootgroup.py"
},
"split_keywords": [
"mastodon",
" pleroma",
" friendica",
" gotosocial",
" toot",
" group",
" account",
" fediverse"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2ae33ba6891f0f8f1fb19c3f121c209b7edc7982a90ab4697252d69c1148c1c7",
"md5": "0e7640317a76a3affeaf2fba03024096",
"sha256": "ddff15b7120e276d7ee571ef3dcdf9850d622fe680031ba56340ac737360b62f"
},
"downloads": -1,
"filename": "tootgroup.py-1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0e7640317a76a3affeaf2fba03024096",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 26812,
"upload_time": "2024-10-11T22:33:47",
"upload_time_iso_8601": "2024-10-11T22:33:47.270318Z",
"url": "https://files.pythonhosted.org/packages/2a/e3/3ba6891f0f8f1fb19c3f121c209b7edc7982a90ab4697252d69c1148c1c7/tootgroup.py-1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9a2a704ba18e97b2cd0caa7380942d985eeeeb3cbffbf635caf55961d644ed13",
"md5": "72330e2cbdd87b207ee9d4f5713842b3",
"sha256": "5e6e171ae722c7eeffbbb5df8bb565cad070695fcecd9d6a96ba3eaf38ff5798"
},
"downloads": -1,
"filename": "tootgroup_py-1.5.tar.gz",
"has_sig": false,
"md5_digest": "72330e2cbdd87b207ee9d4f5713842b3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 25281,
"upload_time": "2024-10-11T22:33:49",
"upload_time_iso_8601": "2024-10-11T22:33:49.091892Z",
"url": "https://files.pythonhosted.org/packages/9a/2a/704ba18e97b2cd0caa7380942d985eeeeb3cbffbf635caf55961d644ed13/tootgroup_py-1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-11 22:33:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "oe4dns",
"github_project": "tootgroup.py",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "tootgroup.py"
}
JSON
