The balsamiqmockups. cfg configuration file

Balsamiq for desktop allows for some mizmization via a simple XML file called balsamiqmockups. cfg. The configuration file allows you to make some software modifications, such:

• 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 clients" 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 program SS 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 entsOutsideOf the typical "Documents/balsamiq mockups" folder. Account and project assets shoshould 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 tables SS 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 tables SS projects for more information
About account assets.

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