Skip to content
This repository has been archived by the owner on Aug 15, 2024. It is now read-only.

Latest commit

 

History

History
55 lines (43 loc) · 2.45 KB

README.md

File metadata and controls

55 lines (43 loc) · 2.45 KB
Raw

Import Trello Boards into Nextcloud Deck App

Simple script that can be used to import Trello boards from exported JSON files into Nextcloud's Deck app using Nextcloud Deck app API.

Requisites:

  • Python v3 (tested with Python 3.7)
  • python-dateutil
  • python-scandir

The python script reads following things from config.json file:

  • API URL, e.g https://nextcloud.url/index.php/apps/deck/api/v1.0/
  • Nextcloud username
  • Nextcloud password (can also be app password!)

Current batch mode implementation tries to parse all json files found from data sub-directory, some make sure the files are what they should be.

Also note that Python script imports archived cards as normal cards.

Known Limitations:

  • Nextcloud Deck cannot handle multiple labels with the same name (will cause the script to fail).
  • Maximum character count allowed for the titles of Deck cards is 255 characters.
  • Card comments are not imported.
  • Editing history is skipped as well (i.e. when the card was last edited).

And yes, the script is slow as molasses, but it does its job (at least for me).

NOTE: Original unfinished Go script is abandoned in favor of more complete Python implementation.

Go script:

  • Export simple example Trello board
  • Parse and print basic board/list/card information
  • Example Deck API requests and JSON response parsing
  • Add data objects for boards/lists/cards that can be marshalled into JSON that Deck API accepts
  • Import board into Deck
  • Import stacks (Trello list) into Deck board
  • Import cards into Deck stack
  • Update card description (combine trello card description and checklists)
  • Set card labels

Python script:

  • Import Trello board with name
  • Import lists as Deck stacks with name
  • Import cards into respective stacks with name and markdown-formatted description
  • Add labels (with colors and descriptions) to the board and assign them to the correct cards
  • Add checklists (supports also multiple checklists in one card)
  • Assign users to cards (abandoned)
  • Add due dates to cards
  • Added batch process of files (place exported .json files to the folder "data")
  • archived Trello lists and cards are skipped (not imported at all)