Differences between revisions 13 and 14
Revision 13 as of 2017-08-06 08:53:00
Size: 7838
Editor: 212-51-157-29
Comment: Bringing the documentation up to date
Revision 14 as of 2017-08-06 08:56:22
Size: 7850
Editor: 212-51-157-29
Comment: fix syntax examples
Deletions are marked like this. Additions are marked like this.
Line 78: Line 78:
Use `del [id]` to delete a status or your last status. Synonyms: `delete`, `undo`. Use `del <id>` to delete a status or your last status. Synonyms: `delete`, `undo`.
Line 82: Line 82:
Use `fav [id|nick]` to favour a status or the last status by a nick. Synonyms: `favourite`, `favorite`, `like`. See [https://github.com/tootsuite/documentation/blob/master/Using-Mastodon/User-guide.md#boosts-and-favourites favorites] in the Mastodon User Guide. Use `fav <id|nick>` to favour a status or the last status by a nick. Synonyms: `favourite`, `favorite`, `like`. See [https://github.com/tootsuite/documentation/blob/master/Using-Mastodon/User-guide.md#boosts-and-favourites favorites] in the Mastodon User Guide.
Line 84: Line 84:
Use `unfav [id|nick]` to unfavour a status or the last status by a nick. Synonyms: `unfavourite`, `unfavorite`, `unlike`, `dislike`. Use `unfav <id|nick>` to unfavour a status or the last status by a nick. Synonyms: `unfavourite`, `unfavorite`, `unlike`, `dislike`.
Line 88: Line 88:
Use `follow [nick|account]` to follow somebody. See [https://github.com/tootsuite/documentation/blob/master/Using-Mastodon/User-guide.md#following-other-users following] in the Mastodon User Guide. This determines the nicks in your channel. Verify the list using `/names`. Use `follow <nick|account>` to follow somebody. See [https://github.com/tootsuite/documentation/blob/master/Using-Mastodon/User-guide.md#following-other-users following] in the Mastodon User Guide. This determines the nicks in your channel. Verify the list using `/names`.
Line 92: Line 92:
Use `unfollow nick` to unfollow a nick. Use `unfollow <nick>` to unfollow a nick.
Line 94: Line 94:
Use `block nick` to block a nick on the server. See [https://github.com/tootsuite/documentation/blob/master/Using-Mastodon/User-guide.md#blocking blocking] in the Mastodon User Guide. This is independent of your IRC client's `/ignore` command, if available. Use `block <nick>` to block a nick on the server. See [https://github.com/tootsuite/documentation/blob/master/Using-Mastodon/User-guide.md#blocking blocking] in the Mastodon User Guide. This is independent of your IRC client's `/ignore` command, if available.
Line 96: Line 96:
Use `unblock nick` to unblock a nick. Use `unblock <nick>` to unblock a nick.
Line 98: Line 98:
Use `mute user nick` to mute a nick on the server. See [https://github.com/tootsuite/documentation/blob/master/Using-Mastodon/User-guide.md#muting muting] in the Mastodon User Guide. Use `mute user <nick>` to mute a nick on the server. See [https://github.com/tootsuite/documentation/blob/master/Using-Mastodon/User-guide.md#muting muting] in the Mastodon User Guide.
Line 100: Line 100:
Use `unmute user nick` to unmute a nick. Use `unmute user <nick>` to unmute a nick.
Line 102: Line 102:
Use `mute [id|nick]` to mute the conversation based on a status or the last status by a nick. Muting a status will prevent replies to it, favourites and replies of it from appearing. See [https://github.com/tootsuite/documentation/blob/master/Using-the-API/API.md#mutingunmuting-a-conversation-of-a-status status muting] in the Mastodon API. Use `mute <id|nick>` to mute the conversation based on a status or the last status by a nick. Muting a status will prevent replies to it, favourites and replies of it from appearing. See [https://github.com/tootsuite/documentation/blob/master/Using-the-API/API.md#mutingunmuting-a-conversation-of-a-status status muting] in the Mastodon API.
Line 104: Line 104:
Use `unmute [id|nick]` to unmute the conversation based on a status or the last status by a nick. Use `unmute <id|nick>` to unmute the conversation based on a status or the last status by a nick.
Line 108: Line 108:
Use `boost [id|nick]` to boost a status or the last status by a nick. See [https://github.com/tootsuite/documentation/blob/master/Using-Mastodon/User-guide.md#boosts-and-favourites boosting] in the Mastodon User Guide. Use `boost <id|nick>` to boost a status or the last status by a nick. See [https://github.com/tootsuite/documentation/blob/master/Using-Mastodon/User-guide.md#boosts-and-favourites boosting] in the Mastodon User Guide.
Line 110: Line 110:
Use `unboost [id|nick]` to unboost a status or the last status by a nick. Use `unboost <id|nick>` to unboost a status or the last status by a nick.
Line 114: Line 114:
Use `url [id|nick]` to get the URL to a status or the last status by a nick. Use `url <id|nick>` to get the URL to a status or the last status by a nick.
Line 118: Line 118:
Use `info user [nick|account]` to get debug information about an account. See [https://github.com/tootsuite/documentation/blob/master/Using-the-API/API.md#account Account] in the Mastodon API. Use `info user <nick|account>` to get debug information about an account. See [https://github.com/tootsuite/documentation/blob/master/Using-the-API/API.md#account Account] in the Mastodon API.
Line 120: Line 120:
Use `info [id|nick]` to get debug information about a status or the last status by a nick. See [https://github.com/tootsuite/documentation/blob/master/Using-the-API/API.md#status Status] in the Mastodon API. Use `info <id|nick>` to get debug information about a status or the last status by a nick. See [https://github.com/tootsuite/documentation/blob/master/Using-the-API/API.md#status Status] in the Mastodon API.
Line 124: Line 124:
Use `report [id|nick] comment` to report a status or the last status by a nick. Synonyms: `spam`. Use `report <id|nick> <comment>` to report a status or the last status by a nick. Synonyms: `spam`.

Setting up a Mastodon account in BitlBee

BitlBee has native support for Mastodon in the works. You can take a look at this fork with its TODO list.

Connecting

In this section, we'll sign in as @kensanata@mastodon.weaponvsac.space. This section assumes an existing account on an instance! Replace username and Mastodon server when trying it. :)

In your &bitlbee channel, add a new account, change it's base_url to point at your instance, then switch it on:

   1 14:43 <kensanata> account add mastodon @kensanata
   2 14:43 <root> Account successfully added with tag mastodon2
   3 14:43 <kensanata> account mastodon2 set base_url https://mastodon.weaponvsac.space/api/v1
   4 14:43 <root> base_url = `https://mastodon.weaponvsac.space/api/v1'
   5 14:44 <kensanata> account mastodon2 on
   6 14:44 <root> mastodon2 - Logging in: Login
   7 14:44 <root> mastodon2 - Logging in: Parsing application registration response
   8 14:44 <root> mastodon2 - Logging in: Starting OAuth authentication

At this point, you'll get contacted by the user mastodon_oauth with a big URL that you need to visit using a browser. Authenticate the client and you'll get back another very long string. Copy and paste this string:

   1 14:44 <mastodon_oauth> Open this URL in your browser to authenticate: https://.......
   2 14:44 <mastodon_oauth> Respond to this message with the returned authorization token.
   3 14:44 <kensanata> ****************************************************************

Once you do that, your login should complete in the &bitlbee channel:

   1 14:44 <root> mastodon2 - Logging in: Requesting OAuth access token
   2 14:44 <root> mastodon2 - Logging in: Connecting
   3 14:44 *** mastodonweaponvsacspace_ JOIN
   4 14:44 *** MODE +v mastodonweaponvsacspace_
   5 14:44 <root> mastodon2 - Logging in: Verifying credentials
   6 14:44 <root> mastodon2 - Logging in: Getting home timeline
   7 14:44 <root> mastodon2 - Logging in: Logged in

You should now have a channel called #mastodon.weaponsvsac.space@localhost where all the status updates and notifications get shown.

Mastodon gives BitlBee a permanent authentication token, which will be saved in your configuration.

You should probably save this configuration.

   1 14:58 <kensanata> save
   2 14:58 <root> Configuration saved

Reading

The default mode setting is chat. This means that each Mastodon account you add will result in a new channel in your IRC client.

Use help set mode in your Bitlbee control channel (&bitlbee) to read up on different modes.

Posting

The default commands setting is true. This means that anything you type is a Toot unless it looks like command, in which case it is handled as such. In addition to that, you can use the post <message> command. If you set the commands setting to strict, using the post command is mandatory.

Use help set commands in your Bitlbee control channel (&bitlbee) to read up on the various commands.

A well behaved Mastodon client will limit your Toots to 500 characters even though the underlying protocols allow for longer messages. By default, Bitlbee does the same. Use help set message_length in your Bitlbee control channel (&bitlbee) to read up on the hairy details. Basically, some aspects of of your message will count for less: URLs, domain names for mentioned user accounts and the like. See help set target_url_length for more information on how URLs are counted.

Replying

If you use the default IRC conventions of starting a message with a nickname and a colon (:) or a comma (,), then your message will be treated as a reply to that nick's last message.

This only works if that nick's last message was sent within the last 3h. For more information about this time window use help set auto_reply_timeout in your Bitlbee control channel (&bitlbee).

You can also reply to an earlier message by referring to its id using the reply <id> <message> command. If you set the commands setting to strict, using the reply command is mandatory.

Deleting Posts

Use del <id> to delete a status or your last status. Synonyms: delete, undo.

Favouriting

Use fav <id|nick> to favour a status or the last status by a nick. Synonyms: favourite, favorite, like. See [https://github.com/tootsuite/documentation/blob/master/Using-Mastodon/User-guide.md#boosts-and-favourites favorites] in the Mastodon User Guide.

Use unfav <id|nick> to unfavour a status or the last status by a nick. Synonyms: unfavourite, unfavorite, unlike, dislike.

Following, Blocking, Muting

Use follow <nick|account> to follow somebody. See [https://github.com/tootsuite/documentation/blob/master/Using-Mastodon/User-guide.md#following-other-users following] in the Mastodon User Guide. This determines the nicks in your channel. Verify the list using /names.

Usually you'll be providing a local or remote account to follow. In the background, Bitlbee will run a search for the account you provided and follow the first match. Sometimes there will be nicks in the channel which you are not following, e.g. a nick is automatically added to the channel when a status of theirs mentioning you is shown.

Use unfollow <nick> to unfollow a nick.

Use block <nick> to block a nick on the server. See [https://github.com/tootsuite/documentation/blob/master/Using-Mastodon/User-guide.md#blocking blocking] in the Mastodon User Guide. This is independent of your IRC client's /ignore command, if available.

Use unblock <nick> to unblock a nick.

Use mute user <nick> to mute a nick on the server. See [https://github.com/tootsuite/documentation/blob/master/Using-Mastodon/User-guide.md#muting muting] in the Mastodon User Guide.

Use unmute user <nick> to unmute a nick.

Use mute <id|nick> to mute the conversation based on a status or the last status by a nick. Muting a status will prevent replies to it, favourites and replies of it from appearing. See [https://github.com/tootsuite/documentation/blob/master/Using-the-API/API.md#mutingunmuting-a-conversation-of-a-status status muting] in the Mastodon API.

Use unmute <id|nick> to unmute the conversation based on a status or the last status by a nick.

Boosting

Use boost <id|nick> to boost a status or the last status by a nick. See [https://github.com/tootsuite/documentation/blob/master/Using-Mastodon/User-guide.md#boosts-and-favourites boosting] in the Mastodon User Guide.

Use unboost <id|nick> to unboost a status or the last status by a nick.

More Information

Use url <id|nick> to get the URL to a status or the last status by a nick.

Use info instance to get debug information about your instance. See [https://github.com/tootsuite/documentation/blob/master/Using-the-API/API.md#instance Instance] in the Mastodon API.

Use info user <nick|account> to get debug information about an account. See [https://github.com/tootsuite/documentation/blob/master/Using-the-API/API.md#account Account] in the Mastodon API.

Use info <id|nick> to get debug information about a status or the last status by a nick. See [https://github.com/tootsuite/documentation/blob/master/Using-the-API/API.md#status Status] in the Mastodon API.

Spam

Use report <id|nick> <comment> to report a status or the last status by a nick. Synonyms: spam.

Note that the comment is mandatory. Explain why the status is being reported. The administrator of your instance will see this report and decide what to do about it, if anything.

What Else

Everything else remains unimplemented.

Working on that. :)

BitlBee Wiki: HowtoMastodon (last edited 2024-03-15 14:23:09 by 86-127-253-29)