trello-to-deck/README.md
Paul Campbell e7e897db72
Some checks failed
Test / build (map[name:nightly]) (push) Successful in 1m42s
Test / build (map[name:stable]) (push) Successful in 2m41s
Release Please / Release-plz (push) Failing after 15s
docs: add nextcloud credentials instructions
2024-12-13 22:10:38 +00:00

2.4 KiB

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.

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

Development

As part of building the import server, the following commands exercise each operation involved:

  • trello member get - includes list of boards
  • trello board get - includes list of stacks
  • trello stack get - includes list of cards
  • trello card get - includes list of attachments
  • trello attachment get
  • nextcloud deck get (was board list)
  • nextcloud board get (was stack list)
  • nextcloud stack get (was card list)
  • nextcloud card create
  • nextcloud card add-label
  • nextcloud card add-attachment