LibreOffice Logo LibreOffice Logo Extensions, Documentation and Templates repository

61380789 OOoLilyPond

Include LilyPond music fragments into Office documents

Download latest

latest release: 2024-03-28 07:25:48

Description

OOoLilyPond

OOoLilyPond (OLy) is a LibreOffice/OpenOffice extension to include LilyPond music fragments in

  • text documents (Writer),
  • spreadsheets (Cald),
  • presentations (Impress) and
  • drawings (Draw).

Installation

  • Being a LibreOffice/OpenOffice extension, you need a version of LibreOffice / OpenOffice installed on your computer, first.
  • Second, the music engraving software LilyPond must be installed on your system.
  • Then just download the latest OLy release from the download page.
  • The extension can be installed either by opening it with LibreOffice or by following these steps in the menu:

Extras > Extension Manager… > Add…

and then choosing the downloaded extension file (.oxt).

Your toolbars in Writer, Calc, Impress and Draw should now have a new "OLy" button which launches the extension.

You can find a detailed documentation in the OOoLilyPond wiki.

Usage

LilyPond is a powerful musical typesetting software that compiles given source code into graphical output, just like LaTeX does with mathematical formulas.

OOoLilyPond enables you to enter LilyPond code from within your Office document.
Both the resulting image and its source code will be embedded within the document.
No need to keep any additional files other than the Writer/Draw/Impress document itself.

To create a new OLy object, just click the "OLy" button and an editor window will open. Enter some LilyPond code and click the "LilyPond" button. After successful compiling, the editor window will close and the resulting image will be visible in your document.

To edit an existing object, select it first and then click the "OLy" button. In the editor window you will have access to your code again.

If you want to get to know LilyPond, a good place to start is the introduction into LilyPond.

Compatibility

OOoLilyPond (OLy) works with recent versions of LibreOffice and OpenOffice. Older versions should work as well. It has even been tested with OpenOffice 2.4 without issues.

Update: Some partial incompatibilities have occured in LibreOffice 6.1.0 to 6.1.4 - see Issue 22.

Any content (LilyPond code, templates, OLy configuration files) created with/for older OLy versions (OLy 0.3.x, OLy 0.4.x, OLy 0.5.x) will work with OLy 1.0.x, but not necessarily vice versa.

Contributors

Urs Liska (infrastructure, GitHub repo)
Joram Berger (infrastructure, feature ideas, improvements, translation)
Hannes E. Schäuble (improvements and fixes)
Ipsilon Fede (feature ideas)
tapanis (error reports)
Valentin Villenave (translation)
Olivier Miakinen (translation)
Fernando Villagran (translation)

Authors

Copyright © 2005 Geoffroy Piroux
Copyright © 2009 Samuel Hartmann
Copyright © 2017 Klaus Blum (current maintainer)

License

This program is free software. It is licensed under the GPL3.

Download

All releases also can be found here: https://github.com/openlilylib/LO-ly/releases

 

Homepage: https://github.com/OOoLilyPond

Repository: https://github.com/OOoLilyPond/OOoLilyPond

Release Description Compatibility Operating Systems License Release notes  
OOoLilyPond 1.1.10 Bugfix 6.2 Linux, Windows, macOS GPL Changes to OOoLilyPond 1.1.10 since 1.1.9 (March 2024):
=======================================================

* Bugfix: When using the 'add missing "pt" unit' feature, certain svg files larger than 32767 bytes
could cause OLy to abort with an "Overflow" runtime error.

* Improvement: An svg file is only re-written if a "pt" unit had to be added.
If nothing has been changed, there are no more unnecessary write operations.
Download
OOoLilyPond 1.1.9 improvement (new feature) 6.2 Linux, Windows, macOS GPL Changes to OOoLilyPond 1.1.9 since 1.1.8 (December 2023):
=================================================

* Improvement: Option to add missing "pt" unit to SVG files
In some cases, SVG images produced by LilyPond (via Cairo library) are incorrectly scaled.
This happens if their height and width statement does not contain any unit.
For details see:
https://github.com/OOoLilyPond/OOoLilyPond/issues/10

OLy now offers an option to pre-scan SVG files before importing
and add "pt" as unit if necessary.
To activate this feature, open the config dialogue and
activate the 'add missing "pt" unit' checkbox.

This release includes some changes to the language files. So, after updating to 1.1.9, please open the config dialog and click the "Restore language files" button.
(Your current language files will be backed up in a new folder. If you like, you can delete that backup folder.)
Download
OOoLilyPond 1.1.8 small improvements 6.2 Linux, Windows, macOS GPL Changes to OOoLilyPond 1.1.8 since 1.1.7 (January 2023):
=========================================================

Small improvements, mainly useful for new users who install OLy for the first time:

 

* In its Config dialogue, OLy now displays the LilyPond version for the specified executable.
* Default graphic format is now svg [cairo].
* "SVG" and "SVG [-dcrop]" templates are now located in a subfolder by default.
Thus they won't clutter up the template list, but OLy still finds them if they are used by a document.
* Backup folders of templates and language files will now be created at the same location, not in a subfolder.

This release includes some changes to the language files. So, after updating to 1.1.8, please open the config dialog and click the "Restore language files" button.
(Your current language files will be backed up in a new folder. If you like, you can delete that backup folder.)
Download
OOoLilyPond 1.1.7 improvements and fixes 4.4 Linux, Windows, macOS GPL Changes to OOoLilyPond 1.1.7 since 1.1.5 (October 2022):

 

* Improvement: Support for cairo backend

LilyPond 2.23.12 has a new option to use the cairo backend.

This allows to get SVG images without external conversion software and without dedicated svg templates (along with their restrictions).

It can be an easier alternative to the "pdf to svg" format.

OLy supports that if you choose the new "svg [cairo]" format option from the config dialog.

If installed for the first time, OLy will choose "svg [cairo]" as default format

instead of "png" if Ly 2.23.12 or later is detected.

 

* Improvement: Insert default "OLy" image if no LilyPond output available

If LilyPond cannot produce an image due to severe errors in the snippet code, a default "OLy" image is inserted into the document.

(In prior versions, no image was inserted and the snippet code was lost when the OLy editor window was closed.)

 

In some cases (pdf-to-svg format or svg [cairo] format and with the use of lilypond-book-preamble) LilyPond produces

very small images (less than 1mm) that would be hard to discover in the document.

Now OLy even tries to recognize these and replace them by the default "OLy" image before inserting.

 

* small bug fixes

 

This release includes some changes to the language files. So, after updating to 1.1.7, please open the config dialog and click the "Restore language files" button.

(Your current language files will be backed up in a subfolder. If you like, you can delete that subfolder.)
Download
OOoLilyPond 1.1.5 improvement 4.4 Linux, Windows, macOS GPL Changes to OOoLilyPond 1.1.5 since 1.1.4 (March 2022):
========================================================

* Improvement: cropping via \include "lilypond-book-preamble.ly" now also works with
Lilypond versions 2.23.5 and later.
(Those need an additional command line option.)
Download
OOoLilyPond 1.1.4 improvements 4.4 Linux, Windows, macOS GPL Changes to OOoLilyPond 1.1.4 since 1.1.2 (March 2022):
========================================================

* Improvement: reading of Ly's --version output adapted to Ly 2.23 behavior
(from OLy 1.1.3 which was only a development pre-release)
* Improvement: hopefully correct default command for LilyPond executable on Mac
* Improvement: When "insert as separate images (system-by-system)" is active,
pdf-to-svg conversion only is executed for the images actually inserted.
Images that are not within the given range ("from" and "to" fields) will not be converted.
Download
OOoLilyPond 1.1.1 improvement: progress window + "abort" button 4.4 Linux, Windows, macOS GPL Changes to OOoLilyPond 1.1.1 since 1.1.0 (April 2021):
==========================================================

* Improvement: During batch processing, there is a small window that displays the progress of the current operation. It also contains a button to abort batch processing.
Download
OOoLilyPond 1.1.0 4.4 Linux, Windows, macOS GPL New feature: Creating and re-editing OLy objects in spreadsheets (LibreOffice Calc)
New feature: Batch processing for Calc, Impress, Draw documents
Automatic toolbar creation ("OLy" button and "Batch" button) in Writer, Calc, Impress, Draw
Option dialog modified: dedicated settings for Writer, Calc, Impress, Draw
"Keep size & crop settings" now is a per-object setting.
In batch processing, it can be kept as-is or overwritten with yes or no.
RESTRICTION:
"Anchor to cell (resize with cell)" in Calc only is only recognized in LibreOffice as of Version 7 and some newer versions of LO 6.
Older versions don't have the ResizeWithCell property, here it results in "Anchor to cell" without resizing.
The actual behavior depends on your LO version.
It seems that some older versions always resized images (for OpenOffice, this is still the case with recent 4.1.8 version today), and that the new anchoring has been introduced to have an option to NOT resize.
P.S.: If your image sizes have been messed up, you can use OLy's Batch function to re-compile all of them in one pass. :-)

This release includes some changes to the language files. So, after updating to 1.1.0, please open the config dialog and click the "Restore language files" button.
(Your current language files will be backed up in a subfolder. If you like, you can delete that subfolder.)
Download
OOoLilyPond 1.0.1 4.4 Linux, Windows, macOS GPL Changes to OOoLilyPond 1.0.1 since 1.0.0 (October 2020):New feature: Option to save temporary LY file into LO document folder
Improvement (Linux only): When calling an external editor from within OLy, it is no more necessary to close the external editor prior to continue working in LibreOffice/OpenOffice.
Minor bugfix: wrong helptext for "Import" button (English and Spanish version only)
Updated templates: "School Demo" and "School Piano Demo" now allow font changes again
Location for extension updates now points to new location at github.com/OOoLilyPond
This release includes some changes to templates and language files. So, after updating to 1.0.1, please open the config dialog and click the "Restore templates" and "Restore language files" buttons.
(Your current templates and language files will be backed up in a subfolder. If you like, you can delete that subfolder.)
Download
1.0.0 4.4 Linux, Windows, macOS GPL Changes to OOoLilyPond 1.0.0 since 0.5.12 (April 2020):New feature: Editor fields can auto-change to checkboxes
New feature: "Option" checkboxes
New feature: Two more "Custom" fields
New feature: Batch processing (Writer only)
New feature: Insert as separate images (system-by-system) (Writer only)
New feature: Template can be included in OLy object
New feature: "SVG [-dcrop]" file format allows automatic cropping for SVG images
Improvement: OLy objects now possible in table cells, text frames, headers and footers, footnotes and endnotes
Improvement: "Direct" image insertion should now also work in OpenOffice
Improvement: Confirmation dialog boxes before overwriting or erasing template files
improvement: Label indicates template location other than template folder
improvement: complete Spanish translation
improvement: add Anchor "To character" option
Added template: "School Demo" and "School Piano Demo" (with switchable bar lines, stems, time signature etc.) [updated Aug. 27]
bugfix: Editing "deutsch.ly" or "italiano.ly" templates in Frescobaldi could possibly crash LilyPond
bugfix: Re-opening an OLy object anchored to page (Writer) could crash OLy
bugfix for Linux: now XDG-compliant location for "templates" and "language" folders as default setting
Various small bugfixes
Complete presentation of the new features:
https://github.com/openlilylib/LO-ly/wiki/Whats-new

This release includes some changes to the templates and language files. So, after updating to 1.0.0, please open the config dialog and click the "Restore templates" and "Restore language files" buttons.
(Your current templates and language files will be backed up in a subfolder. If you like, you can delete that subfolder.)

Also it is recommended to choose the "Insert images: Direct" method. It will be more reliable, even with OpenOffice.
Download
0.5.3 Small fixes 4.0 Linux, Windows, macOS GPL Download
0.5.2 bug fix + new feature 4.0 Linux, Windows, macOS GPL Download
0.5.6 fixes and improvements 4.1 Linux, Windows, macOS GPL Download
0.5.4 small updates to built-in templates 4.0 Linux, Windows, macOS GPL Small updates to templates Download
0.5.8 fixes and improvements 4.1 Linux, Windows, macOS GPL Download
0.5.0 New release with several enhancements and some bux fixes 4.0 Linux, Windows, macOS GPL Changes to OOoLilyPond 0.5.0 since 0.4.0/0.4.1:
================================================

* fixed: Runtime error "Variable not defined: line 40 CurserPosition=1"
* additional include paths can be specified
* added button to save the current code into temporary file and open it in external editor
* added button to re-import code from temporary file back to editor window
* added support for the use of SVG graphics format
* fixed: wrong size of vector graphics in Impress/Draw
* size and crop settings of existing graphics can be preserved
* user now can choose between two different ways to import graphic into document
* font name and font size for editor windows can be specified
* user interface can be translated into other languages

Compatibility:
OOoLilyPond (OLy) works with recent versions of LibreOffice (5.3.0.3) and OpenOffice (4.1.3). Older versions should work as well. It has even been tested with OpenOffice 2.4 without issues.
Any content (LilyPond code, templates, OLy configuration files) created with/for OLy 0.4.x will work with OLy 0.5.x - and vice versa. (Fully compatible, forward and backward.)
Older snippets created with OLy 0.3.x will also work with 0.4.x and 0.5.x, but not (necessarily) vice versa.
Download
0.5.1 bug fix 4.0 Linux, Windows, macOS GPL fixed: missing parentheses in source code caused runtime error in LibO 5.3.1.2 Download
0.5.11 New feature and some bugfixes 4.4 Linux, Windows, macOS GPL New feature and some bugfixes Download
0.5.10 bugfixes 4.0 Linux, Windows, macOS GPL Download
0.5.9 Enhancement 3.3 Linux, Windows, macOS GPL Download
0.5.5 minor improvements 4.0 Linux, Windows, macOS GPL ...some minor improvements Download
Show more

Other Extensions

OOoLilyPond

Logo for OOoLilyPond

Include LilyPond music fragments into Office documents

04-2024

867

Not rated yet

Feedback

☆ ☆ ☆ ☆ ☆

Post your review

You cannot post reviews until you have logged in. Login Here.

Reviews

No one has commented on this page yet.

RSS feed for reviews on this page | RSS feed for all reviews