Migrate a Trello Board to a Nextcloud Deck
Find a file
Paul Campbell 9b931e315f
All checks were successful
Test / build (map[name:nightly]) (push) Successful in 4m16s
Test / build (map[name:stable]) (push) Successful in 4m33s
Release Please / Release-plz (push) Successful in 1m24s
docs: add Import section to readme
Remove development notes
2024-12-31 19:20:04 +00:00
.forgejo/workflows build: disable mutation testing in new tests are in place 2024-12-13 20:48:23 +00:00
src chore: update gitignore and add Cargo.lock 2024-12-31 15:32:25 +00:00
.gitignore chore: update gitignore and add Cargo.lock 2024-12-31 15:32:25 +00:00
Cargo.lock chore: update gitignore and add Cargo.lock 2024-12-31 15:32:25 +00:00
Cargo.toml chore: update gitignore and add Cargo.lock 2024-12-31 15:32:25 +00:00
CHANGELOG.md docs: add CHANGELOG.md 2024-12-31 19:13:46 +00:00
justfile chore: code coverage configuration 2024-12-14 15:25:13 +00:00
LICENSE build: initial ci setup 2024-12-12 07:55:23 +00:00
mise.toml feat: add support for tokio-console 2024-12-22 22:52:17 +00:00
README.md docs: add Import section to readme 2024-12-31 19:20:04 +00:00
renovate.json build: initial ci setup 2024-12-12 07:55:23 +00:00

Trello to Deck

Migrate your Trello Board to Nextcloud Deck.

Getting Started

  • Install trello-to-deck:

e.g.

cargo install trello-to-deck
  • Create a starter configuration file
trello-to-deck init

This will create a trello-to-deck.toml file in the current directory.

Edit this file to add your Trello and Nextcloud credentials.

Import

To import your Trello Board into Nextcloud Deck, use the command:

trello-2-deck import

This will read the credentials from the trello-2-deck.toml file in the current directory. You will prompted to select a Trello Board, then some or all of the Lists from that Board. To begin your import, select the Nextcloud Deck Board to add the lists and cards to.

It is recommended to create a test board to confirm importing is working as you expect.

Trello Credentials

To autheniticate to Trello and be able to download the attachements for each card, you need to register a Power Up as a Developer. This is free and easy, following these instructions;

  • Login to https://trello.com/
  • Visit: https://trello.com/power-ups/admin
  • Click New to create a new Power-Up/Integration
  • Complete the New Power-Up or Integration form:
    • Power-Up or Integrtation Name: Trello to Deck
    • Workspace: select the workspace you went to export your boards from
    • IFrame: (ignore)
    • Email: your email
    • Support: your email
    • Author: your name
    • Click Create
  • API Key: click Generate a new API key (twice)
  • Copy your API key into your trello-to-deck.toml file
  • To the right of the API Key, click on the Token link at the end of the paragraph.
  • On the 'Would you like to give the following application access to your account?' page, scroll down and click Allow
  • Copy the token into you trello-to-deck.toml file

Nextcloud Credentials

To authenticate with Nextcloud Deck, you'll need to obtain the necessary credentials:

  1. Log in to your Nextcloud instance
  2. Go to Settings > Security
  3. Under the "App passwords / devices" section, create a new app password
  4. Enter a name for the device (e.g., "Trello to Deck")
  5. Click "Create new app password"
  6. Copy the generated username and password
  7. Add these credentials to your trello-to-deck.toml file

Verify configuration

Run the check command to validate your configuration:

trello-to-deck check

Support Features

Feature Supported
Stacks/Lists y
Cards y
Card Title y
Card Description y
Card Labels y
Card Attachments (files) y
Card Attachments (links) n
Card Due Date y
Card Assignment n