• Stars
    star
    356
  • Rank 119,446 (Top 3 %)
  • Language
    PHP
  • License
    GNU General Publi...
  • Created almost 12 years ago
  • Updated about 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Trello-Backup is a simple script that Backups all your Trello.com boards and cards, one JSON file per board, for total peace of mind. This is a simple php script which uses the Trello.com API to securely fetch all your boards and store them on your computer as raw JSON files.

Trello-Backup

Trello-Backup is a simple script that Backups all your Trello.com boards and cards, one JSON file per board, for total peace of mind. This is a simple php script which uses the Trello.com API to securely fetch all your boards and store them on your computer.

Requirements

This is a simple php script which requires PHP installed on your system: sudo apt-get install php7

Usage

  • Download the code in a 'trello-backup' directory with: git clone https://github.com/mattab/trello-backup.git trello-backup
  • Duplicate the config.example.php file to config.php and fill in your details (as follows)
  • With your browser go to: https://trello.com/1/appKey/generate - It will give you your public 'Key' for Trello API.
  • Edit the file trello-backup/config.php and set $key to your 'Key'.
  • Then Run the script: php trello-backup/trello-backup.php It will output a URL that you can visit with your browser to get the Application Token. Visit this URL. Then click 'Allow' and copy the token string.
  • Edit config.php and paste this token in $application_token.
  • You are ready! Run this script will download your Trello boards: php trello-backup/trello-backup.php It will create a file named trello-org-[OrganizationNameHere]-board-[NameHere].json for each of your board. Also recommended: setup a crontab to automatically backup every day or every week.

Enjoy!

How to backup several accounts

If you want to backup multiple Trello accounts, you can make multiple copies of example-config.php with different file names. Run trello-backup.php once for each account, specifying the path to the config file as an argument. For example, php trello-backup.php account1.php.

Why Trello-Backup?

Trello.com is a really wonderful free tool, but it has one technical issue 'by design': it is not Free Software that we can self host ourselves.

Also the fine weather can turn to rain pretty quickly: We cannot trust the clouds 100%.

Plus I'm pretty sure others would like to backup their Trello data!

Who is Trello-Backup for?

For anyone using Trello.com who wants to ! but especially:

  • if you store a lot of great ideas and tasks,
  • if you carefully plan long checklists full of unique requirements and thoughts,
  • if you have not only one board but several boards all of them containing important data,
  • if you are thinking of going on a No-Internet holiday for a few weeks and wish to access your boards while offline...

What does this do in terms of clouds?

This little script keeps your data out of the clouds!

What is Trello?

Trello is a free web-based project management application made by Fog Creek Software. Trello uses a paradigm for managing projects known as kanban, a method that had originally been popularized by Toyota in the 1980s for supply chain management. Projects are represented by boards, which contain lists (corresponding to task lists). Lists contain cards (corresponding to tasks). Cards are supposed to progress from one list to the next (via drag-and-drop), for instance mirroring the flow of a feature from idea to implementation. Users can be assigned to cards. Users and boards can be grouped into organizations.

Source: Trello on Wikipedia

Revoking your Trello API Token after use

After backuping your Trello boards, you can easily revoke your token if you wish. Go to trello.com/my/account, scroll down to "Applications" and click "Revoke". See this Trello help page for more info.

Common Issues

Fatal error: Maximum execution time of x seconds exceed in (Directory here). The simple fix here is to edit your php.ini file and set the max_execution_time attribute to 0 to allow your script to run as long as you need it to.

Credits

This is my first Github project! ~ Matthieu Aubry

Kuddos to Zander on Github for his help, when I was trying to use his trello-archiver.

This script officially started from this Gist!

The README Is longer than the script - I'm also practising Markdown.