blob: a41c954061b83f66a642055c3d23c8c6daebf6ce (
plain) (
blame)
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
|
# mastodon.el
Emacs client for [Mastodon](https://github.com/tootsuite/mastodon)
[](http://spacemacs.org)
## Installation
Clone this repository and add the lisp directory to your load path. Then, require it and go.
```elisp
(add-to-list 'load-path "/path/to/mastodon.el/lisp")
(require 'mastodon)
```
I'll make mastdon.el available on MELPA when I feel like it's reached a stable state.
## Usage
### Instance
Set `mastodon-instance-url` in your `.emacs` or `customize`. Defaults to the [flagship](https://mastodon.social).
```elisp
(setq mastodon-instance-url "https://my.instance.url")
```
### App registration
`M-x mastodon-register`
Retrieves `client_id` and `client_secret` tokens. They're stored in the `mastdon-token-file`.
This value can be customized too, and defaults to `${EMACS_HOME_DIRECTORY}/mastodon.plstore`.
### Toot toot
`M-x mastodon-toot`
Pops a new buffer/window with a `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.
If you have not previously authenticated, you will be prompted for your account email and password. **NOTE**: Email and
password are NOT stored by mastodon.el.
Authentication stores your access token in the `mastodon--api-token-string` variable. It is not stored on your filesystem, so
you will have to re-authenticate when you close/reopen Emacs.
## Roadmap
TODOs for the `1.0.0` release are as far as I plan to roadmap. Repo issues track the roadmap via a label.
Click [here](https://github.com/jdenen/mastodon.el/issues?q=is%3Aopen+is%3Aissue+label%3A%22road+to+1.0.0%22).
Issues labeled as bugs should also be fixed before 1.0.0, but delievered is better than perfect, so I don't consider them blocking.
Issues labeled as enhancements can happen whenever.
## Contributing
PRs, issues, and feature requests are very welcome!
### Features
1. Create an [issue](https://github.com/jdenen/mastodon.el/issues) detailing the feature you'd like to add.
2. I'll give you a thumbs up and assign you the issue.
3. Fork the repository and create a branch.
4. Create a pull request referencing the issue created in step 1.
### Fixes
1. In an [issue](https://github.com/jdenen/mastodon.el/issues), let me know that you're working to fix it.
2. I'll assign you the issue.
3. Fork the repository and create a branch.
4. Create a pull request referencing the issue from step 1.
## Connect
If you want to get in touch with me, give me a [toot](https://mastodon.social/@johnson) or leave an [issue](https://github.com/jdenen/mastodon.el/issues).
|
