Over the last few weeks I have been developing an Action Group to integrate Drafts with Mastodon.
The Action Group should be easy to use and allows you to post or schedule different types of statuses to Mastodon, and includes some helpers for composing posts. You can also reschedule or delete scheduled posts.
You can download the Action Group from the Drafts Directory here: Draftodon Action Group
The code and all Action descriptions and instructions are hosted in the GitHub repository here: Draftodon GitHub repository
Make sure you run the Draftodon Setup/Update Action after downloading the Action Group and install the Draftodon.js file.
To start using it, all you need to do is configure your Mastodon instance and user handle in the Draftodon Settings Action, but I suggest to read through the instructions first
I hope Draftodon is a helpful tool for you and speeds up many of your workflows and processes.
Let me know what you think
Spread the Word and Share Your Feedback
Hopefully this action group is useful for you. I would appreciate if you share it with your network
If you encounter issues, have any feedback or further suggestions please let me know You can open an issue in the GitHub repository, reach out to me on Mastodon (FlohGro@social.lol) or just reply in the thread here.
How to Update to a new version of Draftodon?
temporarily save your settings of the āDraftodon Settingsā, āinsert Mastodon handleā and āinsert hashtagā action in a new Draft
showCharacterLimit issue fixed (the limit indicator was added multiple times) visibility added as optional parameter for publishing functions (defaults to āpublicā)
How to Update:
Update The ActionGroup:
Since I made changes to the Actions themselve, please update the Action Group itself.
Run the āDraftodon Setup / Updateā Action and select āUpdate Draftodon Action Groupā
If you donāt want to reconfigure the Draftodon Settings and e.g. insert Mastodon handle Actions - simply delete the new ones and move the ones from the previous version into the newly installed Action Group.
Update the JavaScript File
Run the āDraftodon Setup / Updateā Action again and select āSetup / Update Draftodon.jsā
You should be ready to go and use the new features If you miss anything in Draftodon please let me know!
Hi @Greg sorry that youāve got issues setting this upā¦
can you do the following steps to cleanup your installation first and then install it again with some confirmation steps:
remove all Action Groups named Draftodon from Drafts (go to Manage Actions and delete all of them) - and ensure that you donāt have any Actions installed from Draftodon (e.g. use the search for āDraftodonā nothing should appear)
go to iCloud Drive/Drafts/Library/Scripts and delete the file āDraftodon.jsā
This should clean your installation - and hopefully its not synced back to your device.
install the latest version of Draftodon from the directory: Draftoton | Drafts Directory
and ensure that it looks like this in your Drafts Installation:
That did it. Thanks!!! It was driving me nuts and except for deleting the .js script, was what I had done in the past. You should have received an @mention from me on masto.
I am using Ventura and downloaded Draftodon. I followed the instruction to run the Action āDraftodon Setup/Updateā and have checked that the Draftodon.js is downloaded. But when I clicked āDraftodon Settingā Action, nothing happened. No prompt or anything. I deleted the Action group and .js file and start over and nothing happened.
I also tried in iOS as well and couldnāt configure the Mastodon instance. Any idea?
Is there some permission I need to give to run .js files?
You need to edit the Draftodon Settings action.
There youāll find a few ādefine templateā steps to e.g. define your mastodon instance.
Donāt change the name of the template tags, change the content. E.g. for the mastodon instance you need to change the āUNDEFINEDā into e.g. āmastodon.socialā
Running the settings action does not display anything - this action is used in many other actions to avoid having to type it into every action again
I donāt see any mention of this in the setup instructions. Where is that explained.
Might it be better to use credentials to store this sort of data?
I wonder if you could also support multiple sets?
Everywhere Iāve seen it mentioned, it has been referred to as āDraftodonā, except for in the directory and subsequently when installed into Drafts, where its actual name shows as āDraftotonā. Is this intentional, or a typo?
added it to the instructions - thanks. Was on my list to improve anyways
I use credentials to store the data but somewhere the user needs to define the instance so Drafts can authenticate and store the corresponding credential.
The mastodon instance and user handle is not sensitive
I have this on my next steps list. It should work already but thatās difficult to set up and I want to improve that.
Thanks for the typo mention Iāll try to fix that
Data stored in credentials does not have to be only for sensitive information.
The other template tags in the settings are defaulted configuration for operation, but the handle & instance seem to be data for the userās account, which are data for use in authentication, and so even fit within the general description for the intended purpose of credentials.
Credentials are service tokens and authentication information stored by Drafts for reuse.
If you included them as credential data, you could then prompt for it on first run. Switching accounts I think (I have not fully worked through the code required) should then come down to having the actions written to reference accessing a particular named set of credentials.
Just a suggestion in the hope that it might save you some future headaches.
Yes I guess youāre right @sylumer - I could just ask for the credentials when running one of the actions the first time⦠could really ease a few things up
What is Mastodon handler? I donāt think itās just my email as thereās no where I have to key in my password nor do I see a prompt from Mastodon to allow a 3rd party app to connect. So, Iām still stuck after editing the Draftodon Settings (sorry for the trouble but Iām not understanding how to proceed)
This is from the action description of the Draftodon settings action:
Mastodon instance & handle
mastodon_instance: your mastodon instance e.g. mastodon.social; Default: UNDEFINED
mastodon_handle: your mastodon user handle on the defined instance e.g. @FlohGro for @FlohGro@mastodon.social; Default: UNDEFINED
So if you are on the instance mastodon.social and your handle there would be ābelgarionā then you would use āmastodon.socialā as mastodon_instance and ā@belgarionā as user handle.
The user handle is not that important right now it just identifies the credential that draft storesā¦
You will see a prompt to authenticate with mastodon when you run the first action that needs them. You can e.g. run the action āshow scheduled postsā and it will ask you to authenticate - nothing will be posted to your account with this action
Thanks. I edit and didnāt work.
I had to delete the Action Group, re-download it (and I see you put examples into the template, instead of UNDEFINED, thanks for that!!). After the re-download, it works like a charm! Thanks.
Donāt have multiple accounts? you wonāt notice any difference
reply to status action
Do you want to write a response in Drafts because you need to think about it for a bit or just to donāt get lost in your timeline?
Simply paste the URL of the status into the first line of the draft, write your response, and run the action. Itās that easy!
and some minor improvements for authentication issues
Download and Installation
temporarily save your settings of the āDraftodon Settingsā action in a draft
run the āDraftodon Setup/Updateā action and select āSetup/Update Draftodon.jsā which will update the JavaScript file in your Scripts folder
Reconfigure your settings and youāre ready to go
Iād also love to hear your feedback and suggestions for future updates. Feel free to open an issue on our GitHub repository, reach out on Mastodon or reply here i n this thread.
Awesome⦠although, the older version of Draftodon works so well for me, I am not sure I want to update it yet, since I donāt have multiple accounts. Thanks for continuing to improve it!
You donāt need to update it yet if you donāt need the reply to post action.
If you donāt have multiple accounts the new version shouldnāt make any difference, I use it mostly with just one account, too. If you only configure one account, in fact you wonāt notice any difference.
But you can just wait for a release that has relevant features for you to update.
public urls are now appended to your published drafts quote post action minor changes, documentation improvements and -fixes
public urls appended to published drafts
If you publish a post / thread with one of the actions of Draftodon the url of the published status will now be added at the bottom of the draft. This allows you to quickly jump to the post on your instance - either immediately after publishing it or weeks later
quote post action
If you also miss a quote feature in Mastodon (which hopefully will be added sooner than later) you can now use the āquote statusā action in Draftodon.
Just copy the url of a post, paste it into the first line of a new draft and add you comment or whatever you want to add in the following lines. The quote status action will search for the linked status and add ā [quoted user] [quoted status url]ā to the bottom of your post
Download and Installation
temporarily save your settings of the āDraftodon Settingsā action in a draft Update your Action Group (or download it the first time) from the Action Directory Draftodon | Drafts Directory run the āDraftodon Setup/Updateā action and select āSetup/Update Draftodon.jsā which will update the JavaScript file in your Scripts folder Reconfigure your settings and youāre ready to go
Spread the Word and Share Your Feedback
Hopefully youāll like this update. I would appreciate if you share it with your network and if you consider to support my work: donate ā FlohGro
If you have any feedback or further suggestions please let me know You can open an issue on GitHub or just reach out here in the forums thread
I just released a new version for Draftodon ā my Drafts Action Group for Mastodon.
TL;DR:
post from prompt action post / schedule with hashtags action import bookmarks action import favorites action import from home timeline action multiple accounts can now have different character limit settings insert hashtag / mention improved
post from prompt action
If you want to quickly post a status to mastodon just run this action. It will display a prompt and ask you for the status text. It will publish the given text and store it in a new draft.
post / schedule with hashtags actions
Do you use the same hashtags over and over again? Use these actions to append configurable hashtags to the current draft and publishes / schedules it afterwards. Duplicate them for use with different hashtags.
import bookmarks action
Itās great that you can bookmark statuses on Mastodon but do you really review them? This action fetches your bookmarks and presents them in a preview. From there you can choose to import one which will create a new draft with the content, some meta information and a link back to the original post
import favorites action
Similar to the import bookmarks action you might want to import recently favorited status? Now you can!
import from home timeline action
Last but not least you can also import a recent status from your home timeline? You donāt even need to import one you can just view them using this action without getting sucked into a rabbit hole.
multiple accounts can now have different character limit settings
In previous versions the character limit was a global setting and you couldnāt set different limits for different accounts. Now you can!
insert hashtag / insert mention improved
These two actions will now activate the editor after the insertion point to stop interrupting your writing flow
If you like this update Iād appreciate if you share it with others by boosting the post on mastodon: