Downloads

Download basil.js

The basil.js latest stable release: basil.js relase on GitHub

Download the bundle above and follow the steps in our installation guide at our tutorials section.

Cheatsheets and References

The basil.js cheatsheet: basiljs_cheatsheet_v2_02.pdf

The basil.js InDesign Object Model: basiljs-IOM-0.2.pdf

The basil.js b.typo cheatsheet: basiljs_typo_cheatsheet_v2_01.pdf

Source code

Please note that basil.js is provided as open-source under the MIT License.

Designers and developers who are interested in the “bleeding edge” are welcome to use our Git repository at https://github.com/basiljs/basil.js (develop branch)

Deprecated basil.js versions can still be downloaded from Github: https://github.com/basiljs/basil.js/tags

Please contact us on GitHub for pull and feature requests.

Change log

+ new
* changed
- removed

..-  --.- ..- -.... -..-- .-..-. -.-..---.-.-....--.-- -....-.... -..-- .-
basil.js x.x.x DAY MONTH YEAR

+ basil works without the b. prefix now
+ function draw() works without b.go() now, function loop() replaces b.loop()
+ User settings (units, anchor point etc.) are now saved before and restored after script execution
+ Added mode() to set performance modes (VISIBLE, HIDDEN, SILENT) during script execution
+ Added frameRate() to set frame rate during looping scripts
+ Added transform() function to transform page items independent of the current matrix
  and to measure current transforms of page items
+ Added point(), quad() and triangle() to draw the corresponding shapes
+ Added referencePoint() function to set the reference point for transform()
+ Added file() and folder()
  gets files and folders or creates them
+ Added files()
  gets all files of a folder
+ Added selectFile(), selectFiles() and selectFolder()
  opens a selection dialog to select files or folders
+ Added applyParagraphStyle(), applyCharacterStyle(), applyObjectStyle(),
  set the style of a text object/page item.
  see examples/typography/styles.jsx
+ Added applyMasterPage()
  applies a master page to a page
+ Added masterPage()
  activates and returns a master page
+ Added arrange()
  allows to arrange page items or layers in z-space
+ Added property()
  sets a property of an object to a given value
+ Added graphics() to loop over graphics in a given container
+ Added textStyleRanges() to loop over text style ranges in a given container
+ Added swatch()
  returns a color or gradient of a given name
+ Added revert()
  reverts the document to a fresh state
+ Added SCRIPTNAME
  holds the name of the current script
+ Added isInteger()
  checks if a given variable is an integer

* translate(), rotate() and scale() now behave like they do in Processing and change the current matrix
* basil scripts will by default use the user's default units or the current units of the document,
  as well as the transformation reference point set by the user
* text() can be used to place text into shapes or as text paths on graphic lines
* image() now allows to place images into text frames as well
* canvasMode() behaves a lot more reliable now
  FACING_PAGES, FACING_MARGINS, FACING_BLEEDS, fixed for 3+ page spreads
  BLEED, MARGIN, FACING_MARGINS, FACING_BLEEDS, fixed for single page in facing_pages mode
  all modes work now for margins or bleeds of different sizes
  resetMatrix() does not reset the canvas mode anymore
* performance constants are called VISIBLE, HIDDEN and SILENT now and are used together with the new mode() function
* rect() now allows additional parameters to add rounded corners
* paragraphStyle(), characterStyle() and objectStyle() are expanded:
  They can now get an applied style from a text object/page item and can
  make use of an optional object with property name/value pairs to set
  the properties of the style.
* inspect() has been completely reworked:
  Much faster, especially for complex objects.
  Nicer presentation of results (tree style).
  Options to show or hide properties, values and/or methods.
  Option to show only certain properties.
  Lots of minor fixes.
* page(), pageNumber() and removePage() now also accept page name strings as parameters
* pageCount() can now also be used to set the doc's page count
* previousPage() and nextPage() now work as expected
* when drawing closed vertex paths, endShape() instead of beginShape() now takes the
  CLOSE constant as argument
* println() and print() can now print multiple parameters to console
* trimWord() now correctly trims all punctuation from word borders
* text() now respects the currently set rectangle mode
* rectMode() now works with RADIUS
* Improved the speed of clear() considerably
* textFont() does no longer stop the script if a font is missing, but gives a console warning instead
* isText() now correctly identifies collections of multiple text objects as text
  (Characters, Words, Lines etc.)
* size() now can use existing page size presets as a parameter with an optional
  second parameter for page orientation (introducing PORTRAIT and LANDSCAPE)
* duplicate() now duplicates page items reliably in place, even when in FACING canvas modes
* selection() can now be used to set the selection
* label() can now be used to assign a label to a page item
* Updated categories and sub-categories of many functions to better align to Processing/p5.js categories
  or – in case of non-Processing functions – to better reflect the InDesign categories they belong to
* Changed all include/includepath/targetengine statements from # to //@
  This allows linting with eslint of all files
* Linted all the test files
* Changed the location of the basil.js library from `~/Documents/basiljs/bundle/basil.js` to `~/Documents/basiljs/basil.js` in all the example files.
The user is allowed to have his files wherever he wants.
* bounds() now correctly measures bounds in different canvas modes(MARGIN/BLEED etc.)

- b.go() and b.loop() are removed (use function draw() or function loop() instead)
- b.itemX(), b.itemY(), b.itemWidth(), b.itemHeight(), b.itemPosition() and b.itemSize() are removed
  and replaced by the new transform() function
- b.transformImage() is removed as it can be replaced by the new transform function()
- b.storyCount() is removed (use stories(doc()).length instead)
- Array.map() and Array.filter() are removed
- b.Random.nextGaussian() is removed

Special thanks to Hartmut Bohnacker for making the transform functions work in Processing style!

..-  --.- ..- -.... -..-- .-..-. -.-..---.-.-....--.-- -....-.... -..-- .-
basil.js 1.1.0 - 11 November 2016

+ Added b.size() to set and get the document size
+ Added b.gradient() to great colourful gradients
+ Added b.gradientMode() to set gradient type b.LINEAR or b.RADIAL
+ Added b.placeholder() to fill a textFrame with random placeholder text
+ Added b.LOREM constant holding a lorem ipsum string
+ Added npm script for better tooling and development
  npm run watch
  npm run release (insert timestamp + version string in first line of bundle)
  npm run bundle (without timestamp + version string)
+ Added .eslintrc file (linting rules) to reflect current coding style

* The basil.js file is bundled from /src to a single file:
  It is no longer required to have the basil.js file at a certain path.
  Break out with your project folders to any location w/o breaking things!
* Entire source code is linted, wrong line breaks fixed
* Source code reorganised to /src folder
* Readme files updated to acknowledge new contributors

* Bugfix: b.color("colorName") error when using resulting color in b.fill() twice
* Bugfix: b.layer() did not set active layer to given argument
* Bugfix: b.image() error/warning handling if incomplete arguments
* Bugfix: b.isText() did not work for instances of Text
* Bugfix: b.words(), b.lines() etc. were broken
* Bugfix: b.objectStyle(), b.characterStyle() and b.paragraphStyle() were broken

Shout outs to Timo Rychert and Fabian Morón Zirfas!
This release is entirely based on your hard work!
Many thanks for this massive contributions!

..-  --.- ..- -.... -..-- .-..-. -.-..---.-.-....--.-- -....-.... -..-- .-
basil.js 1.0.10 -

+ Added package.json definition
* Changed versioning scheme to npm style

..-  --.- ..- -.... -..-- .-..-. -.-..---.-.-....--.-- -....-.... -..-- .-
basil.js 1.09 -

+ Added installer scripts for OS X and Windows
* Added some better error reporting for null objects
* Minor bug fixes

..-  --.- ..- -.... -..-- .-..-. -.-..---.-.-....--.-- -....-.... -..-- .-
basil.js 1.08 - 11 November 2013

+ Added b.arc() by Ken Frederick, cheers mate!
+ Added b.weekday(), b.timestamp() and b.millisecond()
* Fixed output to progress panel
* Added auto save to MODEHIDDEN
* Added 15s timeout to loadStrings via TCP/IP
* Improved error reporting
* Bugfix to b.addStory()
* Changed default folder for b.download() to data/

..-  --.- ..- -.... -..-- .-..-. -.-..---.-.-....--.-- -....-.... -..-- .-
basil.js 1.07-experimental - 22 October 2013

* Fixed buggy b.noise()
* Urgent bug fix to b.color() and others

..-  --.- ..- -.... -..-- .-..-. -.-..---.-.-....--.-- -....-.... -..-- .-
basil.js 1.06-experimental - 21 October 2013

* Internal refactorings (split basil.js into many includes)
* Changed to FAST_ENTIRE_SCRIPT execution mode

Please note that this release is still experimental.

..-  --.- ..- -.... -..-- .-..-. -.-..---.-.-....--.-- -....-.... -..-- .-
basil.js 1.05 - 9 October 2013

* Bugfix to b.endShape()
* Bugfix to b.loadString() and b.download(),
  now supports more than one GET parameter
* changed default anchor to center for transforms with line()
* internal safety improvements

..-  --.- ..- -.... -..-- .-..-. -.-..---.-.-....--.-- -....-.... -..-- .-
basil.js 1.04 - 23 September 2013
+ added b.addShape() in order to create multi-component shapes with b.vertex();

+ added b.nameOnPage(), get a pageitem on the active page by name.
  see examples/document/nameOnPage.jsx

+ added b.download(). Downloads an URL to a file, currently Mac only.
  see examples/output/download.jsx

+ added b.shellExecute(), currently Mac only.
  see examples/input/shellExecute.jsx

+ added b.group() and b.ungroup()
+ added b.isURL() validator checker function
+ added string helpers b.endsWith() and b.startsWith()
+ added b.projectPath() to get the folder of the active document
+ added b.saveString() to save a singe string to a file

* Extended loadString() and loadStrings() to handle URLs. Happy GET URL!
  see examples/input/loadStringURL.jsx

* all export functions can handle now sub-folders
  e.g. exportPNG("swiss/basel/snap.png")


..-  --.- ..- -.... -..-- .-..-. -.-..---.-.-....--.-- -....-.... -..-- .-
basil.js 1.03 - 3 July 2013
* added missing support for layer and stroke settings to b.image()
+ added b.savePNG()


..-  --.- ..- -.... -..-- .-..-. -.-..---.-.-....--.-- -....-.... -..-- .-
basil.js 1.02 - 3 June 2013

* fixed a bug with b.constrain()
* added constraints for b.color() and b.fill(), where illegal channel
  values would previously produce strange results


..-  --.- ..- -.... -..-- .-..-. -.-..---.-.-....--.-- -....-.... -..-- .-
basil.js 1.01 - 23 May 2013

+ added b.transform() and b.matrix()
+ added b.remove() for the removal of objects
+ added b.duplicate() for duplicating page items and pages
+ added b.label() and b.selection() as single item alternatives
+ added demos to examples folder
* changed default image fit behaviour to FitOptions.FILL_PROPORTIONALLY
* corrected credits for the processing.js team
* Several JSDOC updates and updated reference on website


..-  --.- ..- -.... -..-- .-..-. -.-..---.-.-....--.-- -....-.... -..-- .-
basil.js 1.00 - 28 Feb 2013

First public release!

+ new functions to work conveniently with stories (indesign model of linked
  content or many textframes), e.g. b.addToStory(), b.storyCount() ...
  see: examples/document/story.jsx


..-  --.- ..- -.... -..-- .-..-. -.-..---.-.-....--.-- -....-.... -..-- .-
basil.js 0.22 - 25 Feb 2013

+ new computation modes MODESILENT, MODEHIDDEN, MODEVISIBLE.
  HIDDEN is very handy for working with large files, as the document is
  processed completely in background, performance is a lot better.

* Changes for b.go().
  You can switch between the computation modes via b.go( b.MODESILENT ),
  b.go( b.MODEHIDDEN ) and b.go( b.MODEVISIBLE ). If b.go() is called
  without a paramter, then the default mode MODESILENT is used.

Special thanks to be:screen GmbH for the new computation modes and
performance optimization!

+ new functions for creating shapes. you can create arbitrary lines,
  bezier curves, polygones with beginShape(), endShape() and vertex()


..-  --.- ..- -.... -..-- .-..-. -.-..---.-.-....--.-- -....-.... -..-- .-
basil.js 0.21 - 21 Dec 2012

basil.js goes semi public with a private beta release


..-  --.- ..- -.... -..-- .-..-. -.-..---.-.-....--.-- -....-.... -..-- .-
basil.js pre 0.21 - May to Dec 2012

basil.js is developed over the Summer by Ted Davis, Benedikt Groß,
Stefan Landsbek and Ludwig Zeller.

Special thanks to Stefan Landsbek for the inital code architecture!