TokenTool

TokenTool

a free tool for building digital avatars

A Token creation tool to create PNG images suitable for Virtual Table Top applications.

Quick and versatile, it is the best way to create customised tokens for your game.

Visit the Download page for version information.

TokenTool removes much of the tedium from creating tokens for use with MapTool or your favorite online gaming application. Just drag an image into the background, select a frame, zoom and pan to suit, and drag off a finished token.  The resulting token is transparent around the edges and cropped to the size you wanted.

Rewritten in
JavaFX 10
to bring a modern and updated UI as well as a few new features!

TokenTool 2.2 features the following:

  • Now supports saving both tokens and portrait images to WebP, PNG, JPEG, GIF and TIFF image formats. 
  • Supports PSD format for ‘overlays’ to allow for better masking by supporting ‘layers’.
  • Bulk PDF image extraction in the image format of your choice by page or the whole shebang. 
  • Finer control over image size when zooming and rotating the token image.

This Post Has 48 Comments

  1. Robert February 8, 2025 Reply

    TokenTool is an awesome application for Linux, the PDF extraction feature was a life saver!

  2. Joonas November 13, 2024 Reply

    Where is the link to download?

  3. Strangething July 28, 2024 Reply

    I don’t see a download link anywhere. Did my ad blocker eat it?

    1. RPTools Bard January 1, 2025 Reply

      Heh, you’d think it’d be on this page. I’ll add it soon. In the meantime, at the top of the page, click on Tools > Download, and you’ll find links to all of the RPTools utilities.

  4. Conandy July 20, 2024 Reply

    Wish that TokenTool would recognize when an image has been rotated by Windows. I rotate the image in Windows, but when I drag it into TokenTool, it is still sideways.

    1. RPTools Bard January 1, 2025 Reply

      If I understand correctly what you’re doing in Windows, it doesn’t actually modify the file on disk. Thus dragging that file into TokenTool has does not show the rotation. (You can verify this by looking at the timestamp on the original file — if it didn’t change, then Windows didn’t write the changes back out to the file. My understanding is that Windows says the rotation setting in a hidden desktop file, but doesn’t modify the image itself. But I’m not a Windows user, so I could have it wrong.)

  5. Conandy July 19, 2024 Reply

    After I have used Windows 11 to rotate an image, that rotation is not recognized by Token Tool, which still thinks the image should have the original rotation. Is there a way to fix this?

  6. Lumisa June 22, 2024 Reply

    I love how simple it is to create these cropped Tokens, however the final product seems to have reduced quality. The Token image is noticeably blurrier when compared to the original source image. I’m just using a simple black square frame. Are there any settings to change export quality?

  7. Randy June 8, 2024 Reply

    I want to use a custom overlay, but it doesn’t block out the portrait outside of the ring. it’s a png with transparent outer and inner section. How to?

  8. taw116 May 17, 2024 Reply

    Is there a way to save the token and then reload it incase there are adjustment to me made?

    1. RPTools Bard January 1, 2025 Reply

      Your resulting token is a “flattened” image, meaning that the overlay/underlay is combined with your image to produce the token. There is no practical way to separate them again after the fact.

  9. joseph January 26, 2024 Reply

    Is there anyway to have the tool zoom in on where the mouse is? currently i’m trying to make tokens of images that are all in a massive vertical list and the zoom only goes to the centre of the image which makes zooming in and finding the correct token a nightmare

  10. Drako7222 January 7, 2024 Reply

    should make a top down token maker

    1. RPTools Bard January 1, 2025 Reply

      TokenTool can do top-down tokens assuming you provide the initial top-down image. Just don’t put an overlay on it (although an underlay might still be useful). There are plenty of artists at devianart.com who have top-down images available, and a lot of gamers seem to have taken up Blender so that they can learn to build their own.

  13. JD August 30, 2023 Reply

    when i try to open it it gets half way through caching overlays then closes please help

    1. RPTools Bard January 1, 2025 Reply

      Some of the native libraries that TokenTool uses don’t play nicely with all images. Apparently, some of the “Card” overlays cause issues with some of the graphics libraries on some Linux distributions (yes, I know: that’s a lot of uses of the word “some”). I’ve run MapTool on plenty of Linux systems (and macOS) without any issues, and I don’t recall hearing from Windows folks regarding having this problem. You may want to check out our Discord server, the #tokentool-support channel in particular, for any real-time updates for your particular OS, version, and so on.

  16. GMAN June 10, 2023 Reply

    Sweet!

  17. RuneStar April 21, 2023 Reply

    First off…I love this tool! I do however have one request for a bug fix, and one for an enhancement if they might be considered.
    Bug Fix. If after you have chosen either a portrait image or a background image from a directory, you then close Token tool, it saves that location you got the image from. If then the directory is deleted, next time you open TokenTool it want to open a directory that doesn’t exist. Rather than reset to a default location it just locks the ‘Change Portrait Image’ button (or background one) so you can never change the image again. The setting even survives through uninstalling and re-installing. The only way I have found around this is to try to remember the directory you had and recreate it.
    Enhancement – for future updates could TokenTool ‘remember’ which format you last looked for rather than default to GIF each time? So if the last image I pulled in was jpg, can it default to looking for jpg next time I go to get a new image?

  18. Mike March 23, 2023 Reply

    Feature request: So I have just upgraded to TokenTool from the online Token Stamp 2. A portrait resize option, like a percentage slider in portrait options or corners in the UI I can grab, would be super handy. I screenshot images for tokens from all over, and they are at all sorts of different sizes, so having to run them through a resize in another app first adds a step to the workflow that I didn’t need to do with Token Stamp 2.

  19. Jim Davenport February 15, 2023 Reply

    Great tool… but I have a little trouble with it. When I open the Overlay Options pane, the bottom of it is hidden below the bottom of my screen so I can’t resize anything or reach any controls below “Send to Back”, “Clip Portrait” and Opacity. I’ve maxed the window on a 1920×1080 screen and still cut off. I don’t see any way around it. Suggestions?

  20. John January 25, 2023 Reply

    On DriveThruRPG you state TokenTool comes with 150 different overlays. I only see the default gear. Where can I find the rest?

  21. Filipe November 25, 2022 Reply

    I would love a way to add some text (or at least a number) on the token.

  25. Joao March 7, 2022 Reply

    Does this have an option to upload to imgurl?

  26. Neil Morrison February 7, 2022 Reply

    Wondering if there are any more polygonal shapes I can use for transparent token borders? Got the Hex and Square already but I need a handful of other shapes (triangle, rectangle, pentagon, trapezoid, oblong…) for a game idea we are working on.
    Any information of referral is appreciated. Thank you

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.