OOoLilyPond
Include LilyPond music fragments into Office documents
Download latest
latest release: 2024-11-19 09:05:05
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/OOoLilyPond/OOoLilyPond/releases
Homepage: https://github.com/OOoLilyPond
Repository: https://github.com/OOoLilyPond/OOoLilyPond
| Release | Description | Compatibility | Operating Systems | License | Release notes | Updated | |
|---|---|---|---|---|---|---|---|
| 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. |
2024-03-27 16:08:34 | 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.) |
2023-12-04 21:55:53 | 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.) |
2023-01-03 00:12:43 | 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.) |
2022-10-28 21:54:58 | 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.) |
2022-04-01 22:27:27 | 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. |
2022-03-27 20:10:12 | 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. |
2021-04-05 17:22:35 | 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.) |
2020-12-16 17:04:51 | 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.) |
2020-10-25 14:04:16 | 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. |
2020-07-24 23:23:42 | Download | |
| 0.5.3 | Small fixes | 4.0 | Linux, Windows, macOS | GPL | 2020-03-05 23:07:35 | Download | |
| 0.5.2 | bug fix + new feature | 4.0 | Linux, Windows, macOS | GPL | 2020-03-05 23:07:34 | Download | |
| 0.5.6 | fixes and improvements | 4.1 | Linux, Windows, macOS | GPL | 2020-03-05 23:07:34 | Download | |
| 0.5.4 | small updates to built-in templates | 4.0 | Linux, Windows, macOS | GPL | Small updates to templates | 2020-03-05 23:07:33 | Download |
| 0.5.8 | fixes and improvements | 4.1 | Linux, Windows, macOS | GPL | 2020-03-05 23:07:33 | 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. |
2020-03-05 23:07:32 | 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 | 2020-03-05 23:07:31 | Download |
| 0.5.11 | New feature and some bugfixes | 4.4 | Linux, Windows, macOS | GPL | New feature and some bugfixes | 2020-03-05 23:07:31 | Download |
| 0.5.10 | bugfixes | 4.0 | Linux, Windows, macOS | GPL | 2020-03-05 23:07:30 | Download | |
| 0.5.9 | Enhancement | 3.3 | Linux, Windows, macOS | GPL | 2020-03-05 23:07:29 | Download | |
| 0.5.5 | minor improvements | 4.0 | Linux, Windows, macOS | GPL | ...some minor improvements | 2020-03-05 23:07:28 | Download |
Show more
☆ ☆ ☆ ☆ ☆
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