Sharing, importing, and upgrading sequences with the FarmBot community
Publicly shared sequences are currently in beta
Publishing a sequence will create a public version released under the MIT License. Once published, anyone may find and use the sequence free of charge for tasks including but not limited to:
- Importing the sequence into their FarmBot account to view and use it as they deem fit
- Upgrading their copy to other published versions
- Making changes to their copy
- Publishing, distributing, and even selling their copy
To publish a sequence, click the share icon in the edit sequence panel, enter the name(s) you wish to include as COPYRIGHT HOLDERS, and click.
Once a sequence has been published, you cannot edit the public copy. You can however publish new versions of the sequence, or unpublish it entirely.
Once the sequence has been published, copy the share link (example: my.farm.bot/app/shared/sequence/1) and post it on the forum, in a message to your colleagues, or in your classroom’s content management system!
- You cannot publish sequences with commands or variables that reference account-specific resources such as plants or tools because the account that imports the sequence will not have access to those resources. We understand that this is a big limitation and are brainstorming ways to allow an importer to “fill in the blanks” when necessary. Stay tuned!
- Only approved people can currently publish sequences with Lua code. Over the coming months we will investigate implementing a review process and/or other measures so that anyone may publish Lua in a safe and secure way.
Publishing new versions
If you make edits to the sequence and would like to share those with the community as well, simply click thebutton to publish a new version. Whenever a new version is published, you will get a new shareable link to the latest version. Links to older versions will still work and can be found by clicking the link icon next to each version.
When you publish a new version, other users of the sequence will see that you have published the new version and may optionally upgrade to it.
You may unpublish a sequence and/or delete it from your account at any time to disable the share link. However, these actions will not affect existing imports owned by other user accounts. To unpublish a sequence, click “Unpublish this sequence” at the bottom of the share popup.
When opening up a sequence share link, you will be shown a read-only preview so that you may evaluate if you would like to use it or not with your FarmBot. If you would like to use it, press thebutton to add the sequence to your account. Your FarmBot will sync the sequence just like any other and can run it right away.
Once you have imported a sequence into your account, you can make copies of it, edits, or delete it just like any other sequence. Plus, you can quickly switch between viewing/editing YOUR COPY and viewing the PUBLIC COPY.
If the original author publishes a new version of the sequence, you will see anbutton, allowing you to replace the contents of your copy with the contents of the latest version of the public copy.
Always review the contents of a new version before upgrading to ensure that your FarmBot will continue to operate as expected after the upgrade.
If you would like to revert to using an older version, you can select an older version from the version picker dropdown and then click.