APSO - Alternative Script Organizer for Python

16 1

Based on an original script from Hanya, APSO will install a macro organizer dedicated to python scripts.

Project Description

APSO is compatible with OpenOffice

Based on an original script from Hanya, APSO is an extension that will install a macro organizer dedicated to python scripts.


  • localisation (by now EN, DE, FR, IT, HU thanks to Tibor Kovács and NL thanks to Dick Groskamp)
  • embedding scripts in or extracting them from documents
  • binding the extension with one's favorite code editor (thanks to another script from Hanya)
  • quick edition of embedded scripts (but only in the context of the APSO extension)
  • automatic update once installed

How it works

APSO adds a new element Organize python scripts under menu Tools/Macros with default shortcut Alt+Shift+F11:


This new item or shortcut opens a dialog box that lists all python scripts and provides various actions:


The Execute  button launches the selected macro. Actions available under Menu button change according to the selection:

  • create module or library if selection is a container (My Macros, Office Macros or document)
  • Edit, rename, delete a module or library
  • Embed module from application (My Macros or Office Macros) into current document
  • Substitute an embedded module with an external file
  • Export an embedded module


APSO comes with a small library apso_utils that contains some helpers for debugging purpose during macro writing. These helpers are three functions named msgbox, xray and mri and can be imported by a classic import statement like from apso_utils import msgbox

function description

Like the oobasic build-in function msgbox, but simplified as only intended for quick debugging.

Signature: msgbox(message, title='Message', boxtype='message', buttons=1, frame=None)

xray Launches the introspection tool Xray by Bernard Marcelly (must be installed first)
mri Launches the introspection tool MRI by Hanya (must be installed first)


The module apso_utils can't be imported before APSO was first loaded.


All modules, Macro

Homepage of the Project



Current Release

APSO - Alternative Script Organizer for Python - 1.0.0

Released Jun 18, 2017 — tested with:

LibreOffice 5.0, LibreOffice 5.1, LibreOffice 5.2, LibreOffice 5.3,

First official release
More about this release…

All platforms

All Releases









Jun 18, 2017
  • All platforms
  • LibreOffice 5.0
  • LibreOffice 5.1
  • LibreOffice 5.2
  • LibreOffice 5.3
First official release
  • AL-v2 (Apache License Version 2.0)

Legal Disclaimer and Limitations for Downloads

The Document Foundation has not reviewed, and cannot review, all of the material, including computer software, available on or by means of The Document Foundation's
websites, and cannot therefore be responsible for that material's content, use or effects. By operating its websites, The Document Foundation does not represent or imply that it endorses the material there available, or that it believes such material to be accurate, useful or nonharmful. You are responsible for taking precautions as necessary to protect yourself and your computer systems from viruses, worms, Trojan horses and other harmful or destructive content. The Document Foundation's websites may contain content that is offensive, indecent or otherwise objectionable, as well as content containing technical inaccuracies, typographical mistakes and other errors. The Document Foundation's websites may also contain material that violates the privacy or publicity rights, or infringes the proprietary rights, of third parties, or the downloading, copying or use of which is subject to additional terms and conditions, stated or unstated. The Document Foundation disclaims any responsibility for any harm resulting from the use by The Document Foundation's visitors of The Document Foundation's websites, or from any downloading by those visitors of content available on or by means of The Document Foundation's websites.


Content contained on The Document Foundation's websites, including these Legal Disclaimers and Limitations, may be changed at the sole discretion of The Document Foundation and without notice. You are bound by any such updates or changes, and so should periodically review these Legal Disclaimers and Limitations.

If you believe any file is present on the site contrary to any TDF rule or applicable law, please supply full details to info@documentfoundation.org for impartial consideration.