From 16779f582042eb721905e7532ca02cbbeaeab24e Mon Sep 17 00:00:00 2001 From: marty hiatt Date: Fri, 1 Nov 2024 17:50:35 +0100 Subject: readme for some of the new stuff --- README.org | 71 +++++++++++++++++++++++++++++++------------------------------- 1 file changed, 35 insertions(+), 36 deletions(-) (limited to 'README.org') diff --git a/README.org b/README.org index 90222c7..b2f4964 100644 --- a/README.org +++ b/README.org @@ -171,6 +171,7 @@ For a full list of commands and variables, see [[file:mastodon-index.org][mastod | =K= | view bookmarked toots | | =X= | view/edit/create/delete lists | | =S= | view your scheduled toots | +| =S-:= | view profile/account settings transient menu | |----------------+---------------------------------------------------------------------------------| | | *Toot actions* | | =t= | Compose a new toot | @@ -192,7 +193,7 @@ For a full list of commands and variables, see [[file:mastodon-index.org][mastod |----------------+---------------------------------------------------------------------------------| | | *Profile view* | | =C-c C-c= | cycle between statuses, statuses without boosts, followers, and following | -| | =mastodon-profile--account-account-to-list= (see lists view) | +| | =mastodon-profile--add-account-to-list= (see lists view) | |----------------+---------------------------------------------------------------------------------| | | *Notifications view* | | =a=, =j= | accept/reject follow request | @@ -244,21 +245,22 @@ value of that hook is as follows: **** Keybindings -|----------+-------------------------------| -| Key | Action | -|----------+-------------------------------| -| =C-c C-c= | Send toot | -| =C-c C-k= | Cancel toot | -| =C-c C-w= | Add content warning | -| =C-c C-v= | Change toot visibility | -| =C-c C-n= | Add sensitive media/nsfw flag | -| =C-c C-a= | Upload attachment(s) | -| =C-c != | Remove all attachments | -| =C-c C-e= | Insert emoji | -| =C-c C-p= | Create a poll | -| =C-c C-l= | Set toot language | -| =-C-c C-s= | Schedule toot | -|----------+-------------------------------| +|---------+-------------------------------| +| Key | Action | +|---------+-------------------------------| +| =C-c C-c= | Send toot | +| =C-c C-k= | Cancel toot | +| =C-c C-w= | Add content warning | +| =C-c C-v= | Change toot visibility | +| =C-c C-n= | Add sensitive media/nsfw flag | +| =C-c C-a= | Upload attachment(s) | +| =C-c != | Remove all attachments | +| =C-c C-e= | Insert emoji | +| =C-c C-p= | Create a poll | +| =C-c C-o= | Cancel poll | +| =C-c C-l= | Set toot language | +| =C-c C-s= | Schedule toot | +|---------+-------------------------------| **** Autocompletion of mentions, tags and emoji @@ -301,7 +303,7 @@ work without first loading a =mastodon.el= buffer: - =mastodon-search--trending-tags=: View a list of trending hashtags on your instance. - =mastodon-search--trending-statuses=: View a list of trending statuses on your instance. - +- =mastodon-search--trending-links=: View a list of trending links on your instance (+ click through to a timeline of posts featuring a given link) - =mastodon-tl--add-toot-account-at-point-to-list=: Add the account of the toot at point to a list. @@ -330,21 +332,11 @@ work without first loading a =mastodon.el= buffer: - =mastodon-tl--remote-tag-timeline=: View a tag timeline on a remote instance. -- =mastodon-profile--update-display-name=: Update the display name for your - account. -- =mastodon-profile--update-user-profile-note=: Update your bio note. -- =mastodon-profile--update-meta-fields=: Update your metadata fields. -- =mastodon-profile--set-default-toot-visibility=: Set the default visibility - for your toots. -- =mastodon-profile--account-locked-toggle=: Toggle the locked status of your - account. Locked accounts have to manually approve follow requests. -- =mastodon-profile--account-discoverable-toggle=: Toggle the discoverable - status of your account. Non-discoverable accounts are not listed in the - profile directory. -- =mastodon-profile--account-bot-toggle=: Toggle whether your account is flagged - as a bot. -- =mastodon-profile--account-sensitive-toggle=: Toggle whether your posts are - marked as sensitive (nsfw) by default. +- =mastodon-user-settings=: Launch a transient menu to update various account settings. + +*** Notifications + +Mastodon from 4.3 supports grouped notifications. These are implemented by =mastodon.el=. If you are on an instance that doesn't implement grouped notifications, set =mastodon-group-notifications= to nil. *** Customization @@ -376,18 +368,24 @@ An index of all user-facing commands and custom variables is available here: [[f You can also hit =?= in any =mastodon.el= buffer to see the available bindings, or run =M-X= (upper-case =X=) to view all commands in the buffer with completion, and call one. -*** Alternative timeline layout +*** Packages related to =mastodon.el= + +**** Alternative timeline layout The incomparable Nicholas Rougier has written an alternative timeline layout for =mastodon.el=. The repo is at [[https://github.com/rougier/mastodon-alt][mastodon-alt]]. -*** mastodon hydra +**** Mastodon hydra -A user made a hydra for handling basic mastodon.el commands. It's available at +A user made a hydra for handling basic =mastodon.el= commands. It's available at https://holgerschurig.github.io/en/emacs-mastodon-hydra/. +**** Narrow to timeline item + +A simple code snippet to enable narrowing to current item in timelines: http://takeonrules.com/2024/10/31/hacking-on-mastodon-emacs-package-to-narrow-viewing/ + *** Live-updating timelines: =mastodon-async-mode= (code taken from [[https://github.com/alexjgriffith/mastodon-future.el][mastodon-future]].) @@ -433,6 +431,7 @@ to your translator function as its text argument. Here's what Hard dependencies (should all install with =mastodon.el=): - =request= (for uploading attachments), [[https://github.com/tkf/emacs-request][emacs-request]] - =persist= for storing some settings across sessions +- =tp.el= for transient menus Optional dependencies (install yourself, =mastodon.el= can use them): - =emojify= to use custom emoji (else we use builtin =emoji.el=) @@ -506,7 +505,7 @@ Some significant contributors are: - https://github.com/hdurer - https://codeberg.org/Red_Starfish -** screenshots +** Screenshots Here's a (federated) timeline: -- cgit v1.2.3