We are continuously improving Truffler and the latest informatiion about the newest features can be found here

Welcome To Truffler

Truffler allows you to easily synchronise physical and electronic backlogs:

Once set up, using Truffler is as easy as:

How  How it Works

Ids

The secret to Truffler is in the special encoded IDs it uses. For each item you want to track, Truffler will generate an image that encodes its ID and surround it with a yellow border. Simply stick these on your normal physical KanBan or Scrum cards, and when you take a photo of the board, Truffler picks out the yellow areas, extracts the IDs, works out what column they are in on your board and then compares this to you backlog tool of choice. Any differences are highlighted, and Truffler can then update your electronic tool so you are confident your board and tool are perfecyly in sync.

Config  Using Truffler

Setting up Truffler is pretty straight-forward and you'll be up and running in no-time.

  1. Create a configuration
  2. Connect to your backlog such as JIRA or Trello
  3. Configure the columns that you have on your board and map them to your backlog - you can also add some aliases
  4. Print columns and cards - see printing tips for trouble free printing
  5. Set up your physical board
  6. Truffle!
  7. Buy a license for unlimited synching, otherwise you can only synch one card per Truffler session

One you are set up and Truffling, you'll be sure to want to explore advanced features such as ranking, using stickers as modifiers, calibration for enhanced accuracy, synching with Excel, using handwriting OCR instead of labels, and check out the hints and tips so you can start Truffling like a pro!

1. Create a Configuration

The first step is to create a new configuration - simply click the "New" button in the configuration box and enter a name:

Back to Set Up

2. Connecting to an Electronic Backlog

The configuration pop-up is shown where you can choose which backlog tool to connect to. The default is JIRA, but this can be changed by clicking the "Connect To" drop down box. Your choices are "JIRA, Trello or Excel"

Connect To

Testing the Connection

Before saving, it is recommended that you test the connection using the "Test Connection" button.

Test Connection

Back to Set Up

3. Configuring Columns

The key to setting up Truffler is to map the columns on your physical board to the appropriate field in your backlog tool.

  1. Click on the "Columns" tab
  2. Select what you want to map the columns to. For JIRA / Trello you have a pre-defined set to choose from:
    JIRA: Status (default), Fix Version(s), Labels, Priority
    Trello: List (default), Labels
    Excel: Free text entry (this needs to match a header in the Excel document being compared to)

Test Connection

You are now ready to create the actual columns which can be done in 2 ways:

  1. Get a list from you backlog tool and select the ones you want
  2. Manually add one at a time

Getting a list from you backlog tool

  1. Click "Add Columns from JIRA/Trello"
  2. Truffler will connect to your backlog tool and get a list of values
  3. Select the values you want and click add

Test Connection

Note: Truffer is not able to get a list of Labels from JIRA as there is no API call exposed by JIRA for this, so you'll have to manually add these

Manually adding a column

  1. Click "Add Column"
  2. Fill in the name
  3. Click add

Manually Add

A Note on Column IDs

Truffler will automatically assign each column a unique ID. If you have more than one configuration then the IDs are unique across all the projects. If you add the same column in more than one configuration, it will be given the same id enabling you to re-use the column across boards.

It also allows you to set up a physical board with more than one configuration mapped to it. For example, if you wanted to have Statuses as columns and Fix Version(s) as rows, you could set up 2 configurations, one mapping to "Status" and one mapping to "Fix Version(s)". You would then print the column labels for each configuration and add them to your physical board. Given that Truffler knows the IDs for all configurations and they are unique, it will safely ignore any IDs that it knows are columns and only use the ones mapped in the current configuration.

Using Aliases

Truffler lets you add aliases for a column. This is useful if you want to use a single column to map more than one status. It is also useful in JIRA if you have different Issue Types with different work flows. For example, you may have a story workflow with an "In Development" status and a defect work flow with a "Fix in Progress" status and want to have them in the same column on your physical board (much like mapping columns in the agile board in JIRA). In this case you can create a "In Development" column and have an alias of "Fix in Progress" or vice-a-versa. You could also add an "In Progress" column and add "In Development" and "Fix in Progress" as aliases.

  1. Click "Edit" icon for a column, or add a new one
  2. Click "Add" alias - a new Alias text field is added at the bottom, just fill the alias in
  3. Click "Save"

Alias

Note: Instead of manually adding you can click the "Add Aliases from JIRA/Trello" and Truffler will get a list of fields associated to the current "Map columns to" setting.

Back to Set Up

4. Printing Columns and Cards

Now you have connected to your backlog tool and mapped the columns, you are ready to print your cards. You will need to print cards for your Columns and your Backlog items

If you have not already saved and closed the "Configuration" pop-up, now is the time to do it!

  1. Click "Print Labels" button on the main toolbar
  2. Choose the Labels you want to print, your choices are:
    • - Columns
    • - JIRA / Trello
    • - Excel
    • - Custom Range
    Select Label Type
  3. Once you have selected the type of labels you want, click "Ok" and you are ready to configure the labels
  4. The next screen allows you to select from some predefined layouts. The default layout is P8 - 8 cards per A4 sheet. Truffler comes with 3 popular templates pre-installed:
    1. P8: 8 labels per A4 sheet, based on Avery L7165 and Rymans P8 templates

      P8 labels are well suited to standard index cards and enable you to print a Truffler ID and the summary of a backlog item on a single label

    2. P65: 65 labels per A4 sheet, based on Avery L7651 and Rymans P65 templates

      Truffler IDs have been designed so they can be printed on Avery L7651 and Rymans P65 templates. This is useful if you just want to add an ID to an existing card

    3. P21: 21 labels per A4 sheet, based on Avery L7160 and Rymans P21 templates
  5. The next screen allows you to select where to start printing the labels from - this is useful if you have a partially used sheet of labels.
    Select Label Template
  6. Clicking OK will generate the lables and allow you to view the generated PDF document that you can now print out
    Select Label Template

Printer

Printer

Back to Set Up

5. Setting up the board

Now you have your columns and cards printed your are ready to set up your board.

Adding Columns and Cards

A typical agile board follows a KanBan approach and this is what Trufller is based on. To set up your columns, all you need to do is to put your column makers that you've printed at the top left of where you want each column - then go ahead and add cards under each column.

Adding cards

Let's Truffle!!

Now you have your board set up you are ready to Truffle! (see Truffling for more details)

As you can see below, Truffler will:

Truffled

Back to Set Up

6. Truffling

Now everything is set up, you are ready to start Truffling. You can then sit back and rleax in the knowledge that your physical and electronic boards will be kept perfectly in sync!

Snap - take a photo of your physical board

The first, and most important step is to take a photo of your electronic board (or multiple photos for big boards). The better the photo, the better the results will be. Follow these hints and tips below and all should be good:

   If you select more than one photo, the photos are stiched together from left to right which is usefull if you have a wide board.

Truffle - use Truffler to compare your photo to your backlog

Fire-up Truffler and:

  1. Ensure the "Use JIRA/Trello" tickbox is checked
  2. Select your photo
  3. Hit "Compare"
  4. Let Truffler do its stuff!

Choosing photo

When Truffler has finished, it will display your board with columns, cards and differences highlighted. If you are lucky then you'll have no differences and all will be in sync!

Choosing photo

More typically, you will have differences and Truffler shows these highlighted in blue where the column does not match. Truffler will append the previous value to the ID:

Choosing photo

When you close the image, the differences are displayed in a table where you can select and synchronise:

Choosing photo

Choosing photo

Choosing photo

Back to Set Up

Further Info

Want to learn more about:

then send an email to alfie_thomas@hotmail.com