aboutsummaryrefslogtreecommitdiff
path: root/README.org
diff options
context:
space:
mode:
authormarty hiatt <martianhiatus@disroot.org>2024-11-01 17:50:35 +0100
committermarty hiatt <martianhiatus@disroot.org>2024-11-01 18:02:00 +0100
commit16779f582042eb721905e7532ca02cbbeaeab24e (patch)
tree3eeedca426dfcf88389d43a9160ba1a8b551f5c6 /README.org
parent94ea642a1a565f0a8c56d1ad541965b905411459 (diff)
readme for some of the new stuff
Diffstat (limited to 'README.org')
-rw-r--r--README.org71
1 files changed, 35 insertions, 36 deletions
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: