xournalpp-relative-background/README.md

Relative Xournal++ background paths

Replace absolute paths of Xournal++ PDF backgrounds with relative ones.

Installation

Place relative-xopp-background in ~/.local/share/nautilus/scripts/relative-xopp-background and make it executable.

If missing, install notify2 and (optionally) dbus-python with your package manager or with pip.

Details

Here is an excerpt of a Xournal++ document /home/user/notes/note1/paper.pdf.xopp:

<?xml version="1.0" standalone="no"?>
<xournal creator="Xournal++ 1.1.0" fileversion="4">
    <title>Xournal++ document - see https://github.com/xournalpp/xournalpp</title>
    <!-- ... -->
    <page width="595.27600000" height="841.89000000">
        <background type="pdf" domain="absolute"
                    filename="/home/user/Documents/paper.pdf" pageno="1ll"/>
    <!-- ... -->
    </page>
    <!-- ... -->
</xournal>

If the background PDF file /home/user/Documents/paper.pdf does not exist but /home/user/notes/note1/paper.pdf is accessible (which is in the same folder as the Xournal++ file), then the absolute path will be replaced with a path relative one:

<?xml version="1.0" standalone="no"?>
<xournal creator="Xournal++ 1.1.0" fileversion="4">
    <title>Xournal++ document - see https://github.com/xournalpp/xournalpp</title>
    <!-- ... -->
    <page width="595.27600000" height="841.89000000">
        <background type="pdf" domain="absolute"
                    filename="paper.pdf" pageno="1ll"/>
    <!-- ... -->
    </page>
    <!-- ... -->
</xournal>