`fedigroup.py` - emulate group accounts on Mastodon
=================================================
What is this?
-------------
Some 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 without giving all members full login credentials to a group.
`fedigroup.py` is an attempt to solve this specific use case.
How does it work?
-----------------
`fedigroup.py` has to be set up on a computer and run as a service. It reads the
notifications from the Mastodon account it is connected to and filters them for
messages to repost. 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 mention the group's
name in the first post.
2. `fedigroup.py` can also look for direct messages from following 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!)
But how to simply use it?
-------------------------
1. Subscribe to group account and write a message that should be boosted by the group:
EXAMPLE: "OHAI! just found that @mastodon thingie!"
2. Make sure if group account is following you and 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"
How to set up?
--------------
The easiest way to install `fedigroup.py` is via PyPI, the Python Package Index.
Use `pip3 install fedigroup.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/uanet-exception/fedigroup.py"> In that case the necessary dependencies
have to be provided too:
`fedigroup.py` requires <https://github.com/halcy/Mastodon.py> to run. Install it via your
operating system's package manager, pip or even manually.
`fedigroup.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 Mastodon instance/server that will act as your
group account. Think about if you should mark it as a "Bot".
2. Run `fedigroup.py create <your-bots-name-here>` from the command line.
3. `fedigroup.py` will ask you for all needed setup data and try to get them
right by connecting to the Mastodon server. If it cannot do so, it will
tell you and you can retry. When successful, `fedigroup.py` will write the
configuration to its fedigroups.ini file and read it from there next time
you run the script.
The place for storing configuration by default is next to `fedigroup.py` and
will be shown during the first-run/setup phase. You can specify your own path
to config file using argument -c/--config.
4. If you want to set up `fedigroup.py` for more than one group, you can run it
again while specifying the group bot name.
5. Test the funcionality by sending direct messages and "@mentions" to your
group while running `fedigroup.py run <your-bots-name-here>` manually.
See if things work as expected.
If everything works, run the script via supervisor or systemd unit.
6. Use "-h" or "--help" for more information about all available options
Raw data
{
"_id": null,
"home_page": "https://github.com/uanet-exception/fedigroup.py",
"name": "fedigroup.py",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3",
"maintainer_email": "",
"keywords": "mastodon pleroma toot group fediverse",
"author": "Dmytro Poltavchenko",
"author_email": "dmytro.poltavchenko@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/09/70/c368d06e34e5541aa56f2c1f593e2cc78d82f870faebf0ac7815119fb9e8/fedigroup.py-1.0.8.tar.gz",
"platform": null,
"description": "`fedigroup.py` - emulate group accounts on Mastodon\n=================================================\n\nWhat is this?\n-------------\n\nSome social media platforms allow groups of users to post into a unified \"group\"\ntimeline/instance/whatever you want to call it. This is currently not possible\non Mastodon without giving all members full login credentials to a group.\n`fedigroup.py` is an attempt to solve this specific use case.\n\nHow does it work?\n-----------------\n\n`fedigroup.py` has to be set up on a computer and run as a service. It reads the\nnotifications from the Mastodon account it is connected to and filters them for\nmessages to repost. There are two methods of creating a group post. One or both\nof them can be enabled during the setup procedure.\n\n1. Public mentions of group members are boosted if they mention the group's\n name in the first post.\n\n2. `fedigroup.py` can also look for direct messages from following 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\nBut how to simply use it?\n-------------------------\n\n1. Subscribe to group account and write a message that should be boosted by the group:\n EXAMPLE: \"OHAI! just found that @mastodon thingie!\"\n\n2. Make sure if group account is following you and 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 EXAMPLE: \"@mastodon HERE BE THE MESSAGE TEXT\"\n\nHow to set up?\n--------------\n\nThe easiest way to install `fedigroup.py` is via PyPI, the Python Package Index.\nUse `pip3 install fedigroup.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/uanet-exception/fedigroup.py\"> In that case the necessary dependencies\nhave to be provided too:\n\n`fedigroup.py` requires <https://github.com/halcy/Mastodon.py> to run. Install it via your\noperating system's package manager, pip or even manually.\n\n`fedigroup.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 Mastodon instance/server that will act as your\n group account. Think about if you should mark it as a \"Bot\".\n\n2. Run `fedigroup.py create <your-bots-name-here>` from the command line.\n\n3. `fedigroup.py` will ask you for all needed setup data and try to get them\n right by connecting to the Mastodon server. If it cannot do so, it will\n tell you and you can retry. When successful, `fedigroup.py` will write the\n configuration to its fedigroups.ini file and read it from there next time\n you run the script.\n\n The place for storing configuration by default is next to `fedigroup.py` and\n will be shown during the first-run/setup phase. You can specify your own path\n to config file using argument -c/--config.\n\n4. If you want to set up `fedigroup.py` for more than one group, you can run it\n again while specifying the group bot name.\n\n5. Test the funcionality by sending direct messages and \"@mentions\" to your\n group while running `fedigroup.py run <your-bots-name-here>` manually.\n See if things work as expected.\n If everything works, run the script via supervisor or systemd unit.\n\n6. Use \"-h\" or \"--help\" for more information about all available options\n\n\n",
"bugtrack_url": null,
"license": "",
"summary": "Emulate group accounts on Mastodon/Pleroma",
"version": "1.0.8",
"split_keywords": [
"mastodon",
"pleroma",
"toot",
"group",
"fediverse"
],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "c0852dbf66aad4416d75f872bfde8e74",
"sha256": "24cb4f0b320d192ca11f290ab00d07bec9499384df3baebc3e1d000050d9c602"
},
"downloads": -1,
"filename": "fedigroup.py-1.0.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c0852dbf66aad4416d75f872bfde8e74",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3",
"size": 18190,
"upload_time": "2022-12-13T15:44:19",
"upload_time_iso_8601": "2022-12-13T15:44:19.184048Z",
"url": "https://files.pythonhosted.org/packages/c6/79/ccbe2c8fc878b8e49eaa9ce552c7920bf874608e37e94beae438ed82235a/fedigroup.py-1.0.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "a7ffa9b008d192c91b3bb6195c710b16",
"sha256": "6d27f2bd66e066661f1d21d19b3676c3ba09977801f309e2fa6f531cbbe01a0d"
},
"downloads": -1,
"filename": "fedigroup.py-1.0.8.tar.gz",
"has_sig": false,
"md5_digest": "a7ffa9b008d192c91b3bb6195c710b16",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3",
"size": 17918,
"upload_time": "2022-12-13T15:44:22",
"upload_time_iso_8601": "2022-12-13T15:44:22.269676Z",
"url": "https://files.pythonhosted.org/packages/09/70/c368d06e34e5541aa56f2c1f593e2cc78d82f870faebf0ac7815119fb9e8/fedigroup.py-1.0.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-13 15:44:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "uanet-exception",
"github_project": "fedigroup.py",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "fedigroup.py"
}
JSON
