1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
|
This is mastodon.info, produced by makeinfo version 6.8 from
mastodon.texi.
INFO-DIR-SECTION Emacs
START-INFO-DIR-ENTRY
* Mastodon: (mastodon). Client for Mastodon on ActivityPub networks.
END-INFO-DIR-ENTRY
File: mastodon.info, Node: Top, Next: README, Up: (dir)
* Menu:
* README::
— The Detailed Node Listing —
README
* Installation::
* Usage::
* Dependencies::
* Network compatibility::
* Contributing::
* Supporting ‘mastodon.el’: Supporting mastodonel.
* Contributors::
* screenshots::
Installation
* ELPA::
* MELPA::
* Repo::
* Emoji::
* Discover::
Usage
* Logging in to your instance::
* Timelines::
* Composing toots::
* Other commands and account settings::
* Customization::
* Commands and variables index::
* Alternative timeline layout::
* Live-updating timelines mastodon-async-mode::
* Translating toots::
* Bookmarks and ‘mastodon.el’: Bookmarks and mastodonel.
Contributing
* Bug reports::
* Fixes and features::
* Coding style::
File: mastodon.info, Node: README, Prev: Top, Up: Top
1 README
********
‘mastodon.el’ is an Emacs client for the AcitivityPub social networks
that implement the Mastodon API. For info see joinmastodon.org
(https://joinmastodon.org/).
NB: ‘mastodon.el’ now ships this readme as an .info file, so if you
have it installed you should be able to browse this readme inside emacs.
‘C-h i’ for info, then ‘m masto RET’ should load it for you.
* Menu:
* Installation::
* Usage::
* Dependencies::
* Network compatibility::
* Contributing::
* Supporting ‘mastodon.el’: Supporting mastodonel.
* Contributors::
* screenshots::
File: mastodon.info, Node: Installation, Next: Usage, Up: README
1.1 Installation
================
You can install ‘mastodon.el’ from ELPA, MELPA, or directly from this
repo. It is also available as a GUIX package.
* Menu:
* ELPA::
* MELPA::
* Repo::
* Emoji::
* Discover::
File: mastodon.info, Node: ELPA, Next: MELPA, Up: Installation
1.1.1 ELPA
----------
You should be able to directly install with:
‘M-x package-refresh-contents RET’
‘M-x package-install RET mastodon RET’
File: mastodon.info, Node: MELPA, Next: Repo, Prev: ELPA, Up: Installation
1.1.2 MELPA
-----------
Add ‘MELPA’ to your archives:
(require 'package)
(add-to-list 'package-archives
'("melpa" . "http://melpa.org/packages/") t)
Update and install:
‘M-x package-refresh-contents RET’
‘M-x package-install RET mastodon RET’
File: mastodon.info, Node: Repo, Next: Emoji, Prev: MELPA, Up: Installation
1.1.3 Repo
----------
Clone this repository and add the lisp directory to your load path.
Then, require it and go.
(add-to-list 'load-path "/path/to/mastodon.el/lisp")
(require 'mastodon)
Or, with ‘use-package’:
(use-package mastodon
:ensure t)
The minimum Emacs version is now 27.1. But if you are running an
older version it shouldn’t be very hard to get it working.
File: mastodon.info, Node: Emoji, Next: Discover, Prev: Repo, Up: Installation
1.1.4 Emoji
-----------
Since Emacs 28, it has builtin emoji support with ‘emoji.el’. If you
prefer to use Emojify (https://github.com/iqbalansari/emacs-emojify),
‘require’ it and set ‘mastodon-use-emojify’ to non-nil to display emoji
in timelines and to use it when composing toots. ‘Emoji.el’ is the
better option, but for now only ‘emojify’ supports downloading and using
custom emoji from your instance. From personal experience, ‘emojify’
also tends to result in less TOFU.
File: mastodon.info, Node: Discover, Prev: Emoji, Up: Installation
1.1.5 Discover
--------------
‘mastodon-mode’ can provide a context menu for its keybindings if
Discover (https://github.com/mickeynp/discover.el) is installed. It is
not required.
if you have Discover, add the following to your Emacs init
configuration:
(require 'mastodon-discover)
(with-eval-after-load 'mastodon (mastodon-discover))
Or, with ‘use-package’:
(use-package mastodon
:ensure t
:config
(mastodon-discover))
File: mastodon.info, Node: Usage, Next: Dependencies, Prev: Installation, Up: README
1.2 Usage
=========
* Menu:
* Logging in to your instance::
* Timelines::
* Composing toots::
* Other commands and account settings::
* Customization::
* Commands and variables index::
* Alternative timeline layout::
* Live-updating timelines mastodon-async-mode::
* Translating toots::
* Bookmarks and ‘mastodon.el’: Bookmarks and mastodonel.
File: mastodon.info, Node: Logging in to your instance, Next: Timelines, Up: Usage
1.2.1 Logging in to your instance
---------------------------------
You need to set 2 variables in your init file to get started:
1. ‘mastodon-instance-url’
2. ‘mastodon-active-user’
(see their doc strings for details). For example If you want to post
toots as "example_user@social.instance.org", then put this in your init
file:
(setq mastodon-instance-url "https://social.instance.org"
mastodon-active-user "example_user")
Then *restart* Emacs and run ‘M-x mastodon’. Make sure you are
connected to internet before you do this. If you have multiple mastodon
accounts you can activate one at a time by changing those two variables
and restarting Emacs.
If you were using mastodon.el before 2FA was implemented and the
above steps do not work, delete the old file specified by
‘mastodon-client--token-file’ and restart Emacs and follow the steps
again.
File: mastodon.info, Node: Timelines, Next: Composing toots, Prev: Logging in to your instance, Up: Usage
1.2.2 Timelines
---------------
‘M-x mastodon’
Opens a ‘*mastodon-home*’ buffer in the major mode and displays
toots. If your credentials are not yet saved, you will be prompted for
email and password. The app registration process will take place if
your ‘mastodon-token-file’ does not contain ‘:client_id’ and
‘:client_secret’.
1. Keybindings
For a full list of commands and variables, see mastodon-index.org
(mastodon-index.org).
Key Action
-----------------------------------------------------------------------------------------------------------
*Help*
‘?’ Show discover menu of all bindings, if ‘discover’ is available
*Timeline actions*
‘n’ Go to next item (toot, notification, user)
‘p’ Go to previous item (toot, notification, user)
‘M-n=/=<tab>’ Go to the next interesting thing that has an action
‘M-p=/=<S-tab>’ Go to the previous interesting thing that has an action
‘F’ Open federated timeline (1 prefix arg: hide-replies, 2 prefix args: media only)
‘H’ Open home timeline (1 prefix arg: hide-replies)
‘L’ Open local timeline (1 prefix arg: hide-replies, 2 prefix args: media only)
‘N’ Open notifications timeline
‘@’ Open mentions-only notifications timeline
‘u’ Update current timeline
‘T’ Open thread for toot at point
‘#’ Prompt for tag and open its timeline
‘A’ Open author profile of toot at point
‘P’ Open profile of user attached to toot at point
‘O’ View own profile
‘U’ update your profile bio note
‘;’ view instance description for toot at point
‘:’ view followed tags and load a tag timeline
‘C-:’ view timeline of all followed tags
‘,’ view favouriters of toot at point
‘.’ view boosters of toot at point
‘/’ switch between mastodon buffers
‘\’ prompt for an instance domain and view its local timeline (if poss)
‘Z’ report user/toot at point to instances moderators
*Other views*
‘s’ search (posts, users, tags) (NB: only posts you have interacted with)
‘I’, ‘c’, ‘d’ view, create, and delete filters
‘R’, ‘a’, ‘j’ view/accept/reject follow requests
‘G’ view follow suggestions
‘V’ view your favourited toots
‘K’ view bookmarked toots
‘X’ view/edit/create/delete lists
‘S’ view your scheduled toots
*Toot actions*
‘t’ Compose a new toot
‘c’ Toggle content warning content
‘b’ Boost toot under ‘point’
‘f’ Favourite toot under ‘point’
‘k’ toggle bookmark of toot at point
‘r’ Reply to toot under ‘point’
‘v’ Vote on poll at point
‘C’ copy url of toot at point
‘C-RET’ play video/gif at point (requires ‘mpv’)
‘e’ edit your toot at point
‘E’ view edits of toot at point
‘i’ (un)pin your toot at point
‘d’ delete your toot at point, and reload current timeline
‘D’ delete and redraft toot at point, preserving reply/CW/visibility
‘!’ toggle folding of toot at point
(‘S-C-’) ‘W’, ‘M’, ‘B’ (un)follow, (un)mute, (un)block author of toot at point
*Profile view*
‘C-c C-c’ cycle between statuses, statuses without boosts, followers, and following
‘mastodon-profile--account-account-to-list’ (see lists view)
*Notifications view*
‘a’, ‘j’ accept/reject follow request
‘C-k’ clear notification at point
see ‘mastodon-notifications--get-*’ functions for filtered views
*Quitting*
‘q’ Quit mastodon buffer, leave window open
‘Q’ Quit mastodon buffer and kill window
‘C-M-q’ Quit and kill all mastodon buffers
2. Toot byline legend
Marker Meaning
--------------------------------------------
‘(🔁)’ (or I boosted this toot
‘(B)’)
‘(⭐)’ (or I favourited this toot
‘(F)’)
‘(🔖)’ (or I bookmarked this toot
(‘K’))
File: mastodon.info, Node: Composing toots, Next: Other commands and account settings, Prev: Timelines, Up: Usage
1.2.3 Composing toots
---------------------
‘M-x mastodon-toot’ (or ‘t’ from a mastodon.el buffer) opens a new
buffer/window in ‘text-mode’ and ‘mastodon-toot’ minor mode. Enter the
contents of your toot here. ‘C-c C-c’ sends the toot. ‘C-c C-k’
cancels. Both actions kill the buffer and window. Further keybindings
are displayed in the buffer, and in the following subsection.
Replies preserve visibility status/content warnings, and include
boosters by default. If the region is active when you start a reply, it
will be yanked into the compose buffer prefixed with ‘>’ to form a rough
reply quote.
Server’s max toot length, with running char count, and attachment
previews, are shown.
You can download and use your instance’s custom emoji
(‘mastodon-toot--download-custom-emoji’,
‘mastodon-toot--enable-custom-emoji’).
If you want to view some of the toot being replied to in the compose
buffer, set ‘mastodon-toot-display-orig-in-reply-buffer’ to non-nil.
The compose buffer uses ‘text-mode’ so any configuration you have for
that mode will be enabled. If any of your existing config conflicts
with ‘mastodon-toot’, you can disable it in the
‘mastodon-toot-mode-hook’. For example, the default value of that hook
is as follows:
(add-hook 'mastodon-toot-mode-hook
(lambda ()
(auto-fill-mode -1)))
1. 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
2. Autocompletion of mentions, tags and emoji
Autocompletion of mentions, tags, and emojis is provided by
‘completion-at-point-functions’ (capf) backends.
‘mastodon-toot--enable-completion’ is enabled by default.
To trigger completion, type a prefix followed by a few letters, ‘@’
for mentions, ‘#’ for tags, and ‘:’ for emoji (for now this only
works when using ‘emojify.el’).
If you want to enable ‘company-mode’ in the toot compose buffer,
set ‘mastodon-toot--use-company-for-completion’ to ‘t’.
(‘mastodon.el’ used to run its own native company backends, but
these have been removed in favour of capfs.)
If you don’t run ‘company’ and want immediate, keyless completion,
you’ll need to have another completion engine running that handles
capfs. A common combination is ‘consult’ and ‘corfu’.
3. Draft toots
• Compose buffer text is saved as you type, kept in
‘mastodon-toot-current-toot-text’.
• ‘mastodon-toot--save-draft’: save the current toot as a draft.
• ‘mastodon-toot--open-draft-toot’: Open a compose buffer and
insert one of your draft toots.
• ‘mastodon-toot--delete-draft-toot’: Delete a draft toot.
• ‘mastodon-toot--delete-all-drafts’: Delete all your drafts.
File: mastodon.info, Node: Other commands and account settings, Next: Customization, Prev: Composing toots, Up: Usage
1.2.4 Other commands and account settings:
------------------------------------------
In addition to ‘mastodon’, the following three functions are autoloaded
and should work without first loading a ‘mastodon.el’ buffer:
• ‘mastodon-toot’: Compose new toot
• ‘mastodon-notifications-get’: View all notifications
• ‘mastodon-url-lookup’: Attempt to load a URL in ‘mastodon.el’. URL
may be at point or provided in the minibuffer.
• ‘mastodon-tl--view-instance-description’: View information about
the instance that the author of the toot at point is on.
• ‘mastodon-tl--view-own-instance’: View information about your own
instance.
• ‘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-tl--add-toot-account-at-point-to-list’: Add the account
of the toot at point to a list.
• ‘mastodon-tl--dm-user’: Send a direct message to one of the users
at point.
• ‘mastodon-profile--add-private-note-to-account’: Add a private note
to another user’s account.
• ‘mastodon-profile--view-account-private-note’: View a private note
on a user’s account.
• ‘mastodon-profile--show-familiar-followers’: Show a list of
“familiar followers” for a given account. Familiar followers are
accounts that you follow, and that follow the account.
• ‘mastodon-tl--follow-tag’: Follow a tag (works like following a
user)
• ‘mastodon-tl--unfollow-tag’: Unfollow a tag
• ‘mastodon-tl--list-followed-tags’: View a list of tags you’re
following.
• ‘mastodon-tl--followed-tags-timeline’: View a timeline of all your
followed tags.
• ‘mastodon-tl--some-followed-tags-timleine’: View a timeline of
multiple tags, from your followed tags or any other.
• ‘mastodon-switch-to-buffer’: switch between mastodon buffers.
• ‘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.
File: mastodon.info, Node: Customization, Next: Commands and variables index, Prev: Other commands and account settings, Up: Usage
1.2.5 Customization
-------------------
See ‘M-x customize-group RET mastodon’ to view all customize options.
• Timeline options:
• Use proportional fonts
• Default number of posts displayed
• Timestamp format
• Relative timestamps
• Display user avatars
• Avatar image height
• Enable image caching
• Hide replies in timelines
• Show toot stats in byline
• Compose options:
• Completion style for mentions and tags
• Enable custom emoji
• Display toot being replied to
• Set default reply visibility
• Nofitication options:
• Display user’s profile note in follow requests
File: mastodon.info, Node: Commands and variables index, Next: Alternative timeline layout, Prev: Customization, Up: Usage
1.2.6 Commands and variables index
----------------------------------
An index of all user-facing commands and custom variables is available
here: mastodon-index.org (mastodon-index.org).
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.
File: mastodon.info, Node: Alternative timeline layout, Next: Live-updating timelines mastodon-async-mode, Prev: Commands and variables index, Up: Usage
1.2.7 Alternative timeline layout
---------------------------------
The incomparable Nicholas Rougier has written an alternative timeline
layout for ‘mastodon.el’.
The repo is at mastodon-alt
(https://github.com/rougier/mastodon-alt).
File: mastodon.info, Node: Live-updating timelines mastodon-async-mode, Next: Translating toots, Prev: Alternative timeline layout, Up: Usage
1.2.8 Live-updating timelines: ‘mastodon-async-mode’
----------------------------------------------------
(code taken from mastodon-future
(https://github.com/alexjgriffith/mastodon-future.el).)
Works for federated, local, and home timelines and for notifications.
It’s a little touchy, one thing to avoid is trying to load a timeline
more than once at a time. It can go off the rails a bit, but it’s still
pretty cool. The current maintainer of ‘mastodon.el’ is unable to debug
or improve this feature.
To enable, it, add ‘(require 'mastodon-async)’ to your ‘init.el’.
Then you can view a timeline with one of the commands that begin with
‘mastodon-async--stream-’.
File: mastodon.info, Node: Translating toots, Next: Bookmarks and mastodonel, Prev: Live-updating timelines mastodon-async-mode, Up: Usage
1.2.9 Translating toots
-----------------------
You can translate toots with ‘mastodon-toot--translate-toot-text’ (‘a’
in a timeline). At the moment this requires lingva.el
(https://codeberg.org/martianh/lingva.el), a little interface I wrote to
lingva.ml (https://lingva.ml), to be installed to work.
You could easily modify the simple function to use your Emacs
translator of choice (‘libretrans.el’ , ‘google-translate’, ‘babel’,
‘go-translate’, etc.), you just need to fetch the toot’s content with
‘(mastodon-tl--content toot)’ and pass it to your translator function as
its text argument. Here’s what ‘mastodon-toot--translate-toot-text’
looks like:
(defun mastodon-toot--translate-toot-text ()
"Translate text of toot at point.
Uses `lingva.el'."
(interactive)
(let* ((toot (mastodon-tl--property 'item-json)))
(if toot
(lingva-translate nil (mastodon-tl--content toot))
(message "No toot to translate?"))))
File: mastodon.info, Node: Bookmarks and mastodonel, Prev: Translating toots, Up: Usage
1.2.10 Bookmarks and ‘mastodon.el’
----------------------------------
‘mastodon.el’ implements a basic bookmark record and handler.
Currently, this means that you can bookmark a post item and later load
it in thread view. This could be expanded to any item with an id, but
probably not to things like timeline views. If you want to be able to
bookmark something, open an issue and ask, as it’s trivial to expand the
bookmarking code.
File: mastodon.info, Node: Dependencies, Next: Network compatibility, Prev: Usage, Up: README
1.3 Dependencies
================
Hard dependencies (should all install with ‘mastodon.el’):
• ‘request’ (for uploading attachments), emacs-request
(https://github.com/tkf/emacs-request)
• ‘persist’ for storing some settings across sessions
Optional dependencies (install yourself, ‘mastodon.el’ can use them):
• ‘emojify’ to use custom emoji (else we use builtin ‘emoji.el’)
• ‘mpv’ and ‘mpv.el’ for viewing videos and gifs
• ‘lingva.el’ for translating toots
File: mastodon.info, Node: Network compatibility, Next: Contributing, Prev: Dependencies, Up: README
1.4 Network compatibility
=========================
‘mastodon.el’ should work with ActivityPub servers that implement the
Mastodon API.
Apart from Mastodon itself, it is currently known to work with:
• Pleroma (pleroma.social (https://pleroma.social/))
• Akkoma (akkoma.social (https://akkoma.social/))
• Gotosocial (gotosocial.org (https://gotosocial.org/))
It does not support the non-Mastodon API servers Misskey (misskey.io
(https://misskey.io/)), Firefish (joinfirefish.org
(https://joinfirefish.org/), formerly Calkey) and Friendica, but it
should fully support displaying and interacting with posts and users on
those platforms.
If you attempt to use ‘mastodon.el’ with a server and run into
problems, feel free to open an issue.
File: mastodon.info, Node: Contributing, Next: Supporting mastodonel, Prev: Network compatibility, Up: README
1.5 Contributing
================
PRs, issues, feature requests, and general feedback are very welcome!
If you prefer emailing patches to the process described below, feel
free to send them on. Ideally they’d be patches that can be applied
with ‘git am’, if you want to actually contribute a commit.
* Menu:
* Bug reports::
* Fixes and features::
* Coding style::
File: mastodon.info, Node: Bug reports, Next: Fixes and features, Up: Contributing
1.5.1 Bug reports
-----------------
1. ‘mastodon.el’ has bugs, as well as lots of room for improvement.
2. I receive very little feedback, so if I don’t run into the bug it
often doesn’t get fixed.
3. If you run into something that seems broken, first try running
‘mastodon.el’ in emacs with no init file (i.e. ‘emacs -q’
(instructions and code for doing this are here
(https://codeberg.org/martianh/mastodon.el/issues/300)) to see if
it also happens independently of your own config (it probably
does).
4. Else enable debug on error (‘toggle-debug-on-error’), make the bug
happen again, and copy the backtrace that appears.
5. Open an issue here and explain what is going on. Provide your
emacs version and what kind of server your account is on.
File: mastodon.info, Node: Fixes and features, Next: Coding style, Prev: Bug reports, Up: Contributing
1.5.2 Fixes and features
------------------------
1. Create an issue (https://codeberg.org/martianh/mastodon.el/issues)
detailing what you’d like to do.
2. Fork the repository and create a branch off of ‘develop’.
3. Run the tests and ensure that your code doesn’t break any of them.
4. Create a pull request (to develop) referencing the issue created in
step 1.
File: mastodon.info, Node: Coding style, Prev: Fixes and features, Up: Contributing
1.5.3 Coding style
------------------
• This library uses an unconvential double dash (‘--’) between file
namespaces and function names, which contradicts normal Elisp
style. This needs to be respected until the whole library is
changed.
• Use ‘aggressive-indent-mode’ or similar to keep your code indented.
• Single spaces end sentences in docstrings.
• There’s no need for a blank line after the first docstring line
(one is added automatically when documentation is displayed).
File: mastodon.info, Node: Supporting mastodonel, Next: Contributors, Prev: Contributing, Up: README
1.6 Supporting ‘mastodon.el’
============================
If you’d like to support continued development of ‘mastodon.el’, I
accept donations via paypal: paypal.me/martianh
(https://paypal.me/martianh). If you would prefer a different payment
method, please write to me at <martianhiatus [at] riseup [dot] net> and
I can provide IBAN or other bank account details.
I don’t have a tech worker’s income, so even a small tip would help
out.
File: mastodon.info, Node: Contributors, Next: screenshots, Prev: Supporting mastodonel, Up: README
1.7 Contributors
================
‘mastodon.el’ is the work of a number of people.
Some significant contributors are:
• <https://github.com/jdenen> [original author]
• <http://atomized.org>
• <https://alexjgriffith.itch.io>
• <https://github.com/hdurer>
• <https://codeberg.org/Red_Starfish>
File: mastodon.info, Node: screenshots, Prev: Contributors, Up: README
1.8 screenshots
===============
Here’s a (federated) timeline:
[image src="screenshot-tl.png"
|