The BalsamiqMockups.cfg Configuration File

Balsamiq for Desktop allows for some customization via a simple XML file called BalsamiqMockups.cfg. The configuration file allows you to make some software modifications, such as:

• Using another font
• Disabling smart alignment snapping
• Setting your exported PNGs to use transparent backgrounds
• Setting a different selection color for controls
• Setting a different folder than the default Documents/Balsamiq Mockups path

Saving your Config File#

Create the file in a text editor (you can use this sample BalsamiqMockups.cfg file as a starting point) and save it to your Local Store folder. You can find this folder by opening the "About" dialog and clicking on the "Open Local Store Folder" link (or go to this pageto see folder locations for all operating systems).

​

Note: the config file must be saved to plain text format! It will NOT work if you save your config file to RTF, or with the .cfg.txt or .cfg.rtf extensions. If you are using TextEdit.app, to save in plain text format select Format > Make Plain Text from the menu.

Sample File#

The config file might look like this:

<config>

  <fontFace>Architect Small Block</fontFace> 

  <rememberWindowSize>false</rememberWindowSize> 

  <useCookies>false</useCookies> 

  <documentsPath>C:\Documents And Settings\Administrator\Desktop</documentsPath> 

  <snappingEnabled>false</snappingEnabled> 

  <selectionColor>FF0000</selectionColor> 

  <transparentBackground>true</transparentBackground> 

</config>

Options#

• The fontFace tag allows you to specify the name of a font on your computer to use instead of Balsamiq Sans.
• Set the rememberWindowSize tag to false if you'd like Mockups to not try to remember the size and position of the application window (some video card drivers don't play well with Adobe AIR and Mockups won't start unless you set this to false).
• Set useCookies to false if you'd like Mockups to not save any of your preferences on the current computer (preferences include the state of "show UI Library", "Show Graph Paper" and others).
• If you don't want to use the default "My Documents" folder (often because it is on a remote server, not always connected) for the shared data of Mockups, then you can set documentsPath to the path of a folder of your choice. This is also useful to share symbols across projects.
• Set snappingEnabled to false if you'd like to turn off snapping alltogether in the app.
• Set selectionColor if you want to change the color we use for showing selection in the app.
• Set transparentBackground to true if you want your PNGs to be exported with a transparent background instead of the default white one.

Setting up assets for non-typical Documents locations#

A config file is only necessary if you want to set up your documents outside of the typical "Documents/Balsamiq Mockups" folder. Account and Project assets should work without needing a config file in a typical set up.

If your computer username is Bob, for instance, and you want to use a folder in /Users/Bob/Documents/Work/Balsamiq Mockups/ set the documentsPath element like this:<documentsPath>/Users/Bob/Documents/Work</documentsPath>

Mockups is just looking for the parent location, and "Balsamiq Mockups" is assumed.

Please also see the article on sharing symbols across projects for more information about account assets.

Setting up an assets path for cloud drives#

Here are some examples for how to set up your documents path so that account assets will work with cloud drives. This assumes that you will have a folder named "Balsamiq Mockups" under your DropBox or Google Drive. Change your computer name where applicable below.

Mac OS

Dropbox

<documentsPath>/Volumes/Macintosh HD/Users/YOUR COMPUTER NAME/Dropbox</documentsPath>

Google Drive

<documentsPath>/Volumes/Macintosh HD/Users/YOUR COMPUTER NAME/Google Drive</documentsPath>

Windows
The path may vary depending on your version and setup of Windows. Please check Windows Explorer to get the correct path.

Dropbox

<documentsPath>C:\Users\YOUR COMPUTER NAME\Dropbox\</documentsPath>

Google Drive

<documentsPath>C:\Users\YOUR COMPUTER NAME\Google Drive\</documentsPath>

Please also see the article on sharing symbols across projects for more information about account assets.

转载：http://support.balsamiq.com/customer/portal/articles/111759-the-balsamiqmockups-cfg-configuration-file