{"id":16282424,"url":"https://github.com/jtpio/trello-full-backup","last_synced_at":"2025-04-09T23:18:03.910Z","repository":{"id":2319727,"uuid":"45110568","full_name":"jtpio/trello-full-backup","owner":"jtpio","description":"Python script to backup everything from Trello: boards, lists, cards and attachments","archived":false,"fork":false,"pushed_at":"2022-08-10T14:24:20.000Z","size":37,"stargazers_count":122,"open_issues_count":28,"forks_count":37,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-04-09T23:17:59.617Z","etag":null,"topics":["automation","backup","python","trello"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jtpio.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-10-28T12:23:59.000Z","updated_at":"2024-12-12T16:39:10.000Z","dependencies_parsed_at":"2022-08-06T12:15:10.485Z","dependency_job_id":null,"html_url":"https://github.com/jtpio/trello-full-backup","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jtpio%2Ftrello-full-backup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jtpio%2Ftrello-full-backup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jtpio%2Ftrello-full-backup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jtpio%2Ftrello-full-backup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jtpio","download_url":"https://codeload.github.com/jtpio/trello-full-backup/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248125593,"owners_count":21051771,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","backup","python","trello"],"created_at":"2024-10-10T19:10:36.823Z","updated_at":"2025-04-09T23:18:03.883Z","avatar_url":"https://github.com/jtpio.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Trello Full Backup\n==================\n\n.. image:: https://img.shields.io/pypi/v/trello-full-backup.svg?style=flat-square\n    :target: https://pypi.python.org/pypi/trello-full-backup\n\n.. image:: https://img.shields.io/pypi/pyversions/trello-full-backup.svg?style=flat-square\n    :target: https://pypi.python.org/pypi/trello-full-backup\n\n.. image:: https://img.shields.io/docker/automated/jtpio/trello-full-backup.svg?style=flat-square\n    :target: https://hub.docker.com/r/jtpio/trello-full-backup/\n\nBackup everything from Trello:\n\n- boards, open and closed, as json files\n- lists, open and archived, as json files\n- cards, open and archived, as json files\n- attachments, downloaded as raw files\n\nThe script also creates a **folder tree structure** corresponding to the\nway data is organized. This is to make it more convenient to navigate\nlocally between folders, as it mimics the flow you have when using the\nweb and mobile apps.\n\nHere is an example of what the tree structure looks like:\n\n::\n\n    2015-11-12_23-28-36_backup/\n    └── me\n        └── A Test Board\n            ├── 0_To Do\n            │   ├── 0_Task3\n            │   │   ├── attachments\n            │   │   │   └── 0_chessboard.png\n            │   │   ├── card.json\n            │   │   └── description.md\n            │   └── 1_Task4\n            │       ├── card.json\n            │       └── description.md\n            ├── 1_In Progress\n            │   └── 0_Task2\n            │       ├── card.json\n            │       └── description.md\n            ├── 2_Done\n            │   └── 0_Task1\n            │       ├── attachments\n            │       ├── card.json\n            │       └── description.md\n            └── A Test Board_full.json\n\n- Lists and cards have their names prefixed by their position to keep\n  the order\n- For each card:\n- The description is saved to a separate Markdown file\n- The attachments are downloaded to a separate folder\n- The rest stays in the json file\n\n\nRun with Docker\n---------------\n\nThe easiest way to execute the script with the default parameters (if you have Docker):\n\n::\n\n    docker run -t -e TRELLO_API_KEY=YOUR_KEY -e TRELLO_TOKEN=YOUR_TOKEN -v /backups:/app jtpio/trello-full-backup\n\nThis will create a new folder on your host system in the `backups` directory. Feel free to adjust it based on your host system (GNU/Linux, Mac OS, Windows...).\n\nTo pass different parameters, for example to avoid downloading attachments:\n\n::\n\n    docker run -t -e TRELLO_API_KEY=YOUR_KEY -e TRELLO_TOKEN=YOUR_TOKEN -v /backups:/app jtpio/trello-full-backup trello-full-backup -a 0\n\n\nInstall\n-------\n\n::\n\n    pip install trello-full-backup\n\n\nUsage\n-----\n\nMake sure the environment variables **TRELLO\\_API\\_KEY** and\n**TRELLO\\_TOKEN** are correctly set.\n\n- To get the API key: https://trello.com/app-key\n- To get the token: https://trello.com/1/authorize?scope=read\u0026expiration=never\u0026name=backup\u0026key=REPLACE_WITH_YOUR_API_KEY\u0026response_type=token\n\nThen you can run the following commands:\n\n::\n\n    export TRELLO_API_KEY=yourapikey\n    export TRELLO_TOKEN=yourtoken\n\n\nAnd execute the script:\n\n::\n\n    trello-full-backup\n\n\nBy default the script creates a folder with the current date as a name.\nExample: *2015-11-12\\_18-57-56\\_backup*\n\nYou can specify your own destination directory, but the script **does\nnot** create the intermediate directories in case they don't exist:\n\n::\n\n    trello-full-backup -d path/to/dir\n\nOptions\n-------\n\n::\n\n    trello-full-backup -h\n\n::\n\n    usage: trello-full-backup [-h] [-d [DEST]] [-i] [-t] [-B] [-L] [-C] [-o]\n                              [-a [ATTACHMENT_SIZE]]\n\n    Trello Full Backup\n\n    optional arguments:\n      -h, --help            show this help message and exit\n      -d [DEST]             Destination folder\n      -i, --incremental     Backup in an already existing folder incrementally\n      -t, --tokenize        Tokenize the names for folders and files. Useful for\n                            scripts\n      -B, --closed-boards   Backup closed board\n      -L, --archived-lists  Backup archived lists\n      -C, --archived-cards  Backup archived cards\n      -m, --my-boards       Backup my personal boards\n      -o, --organizations   Backup organizations\n      -a [ATTACHMENT_SIZE], --attachment-size [ATTACHMENT_SIZE]\n                            Attachment size limit in bytes. Set to -1 to disable\n                            the limit\n\nIf neither the ``-m`` or ``-o`` switches are specified, the script will default to backing up personal boards only.\n\nIncremental mode\n----------------\nThe incremental mode is useful for scripts. It will replace the names of the folders in each board by unique tokens.\nFurthermore, it allows the user to specify the same directory for backup.\nThis will update all the json and description.md files. However it will download the attachment only if they have changed from the last backup.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjtpio%2Ftrello-full-backup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjtpio%2Ftrello-full-backup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjtpio%2Ftrello-full-backup/lists"}