61380789 OOoLilyPond

use LilyPond musical notation within LibreOffice (requires LilyPond installed on your system)

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).

editor object

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)abcdef

License

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

Download

Current release is OOoLilyPond 1.0.0

Please download the latest release from https://github.com/openlilylib/LO-ly/releases

At the moment it seems to be impossible to add new releases here on extensions.libreoffice.org - therefore the list below is incomplete.

Homepage: https://github.com/OOoLilyPond

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

Release List

Release Description Compatibility Operating Systems License Release notes   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.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.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.9 Enhancement 3.3 Linux, Windows, macOS GPL Download 0.5.8 fixes and improvements 4.1 Linux, Windows, macOS GPL Download 0.5.6 fixes and improvements 4.1 Linux, Windows, macOS GPL Download 0.5.5 minor improvements 4.0 Linux, Windows, macOS GPL

...some minor improvements

Download 0.5.4 small updates to built-in templates 4.0 Linux, Windows, macOS GPL

Small updates to templates

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.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.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.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
Show more

Other Extensions

OOoLilyPond

use LilyPond musical notation within LibreOffice (requires LilyPond installed on your system)

03-2024

662

Not rated yet

Feedback

☆ ☆ ☆ ☆ ☆

Post your review

You cannot post reviews until you have logged in. Se connecter.

Reviews

Il n'y a pas encore de commentaire.

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