{
    "info": {
        "author": "Dag Wieers",
        "author_email": "dag.wieers@gmail.com",
        "bugtrack_url": null,
        "classifiers": [
            "Development Status :: 5 - Production/Stable",
            "Environment :: Console",
            "Intended Audience :: Developers",
            "Intended Audience :: System Administrators",
            "License :: OSI Approved :: GNU General Public License v2 (GPLv2)",
            "Programming Language :: Python",
            "Programming Language :: Python :: 2",
            "Programming Language :: Python :: 2.7",
            "Programming Language :: Python :: 3",
            "Programming Language :: Python :: 3.5",
            "Programming Language :: Python :: 3.6",
            "Topic :: Office/Business :: Office Suites",
            "Topic :: Utilities"
        ],
        "description": "Automated conversion and styling using LibreOffice\n==================================================\n\nDag Wieers <dag@wieers.com>\n\nUniversal Office Converter (unoconv) is a command line tool to convert any\ndocument format that LibreOffice can import to any document format that\nLibreOffice can export. It makes use of the LibreOffice's UNO bindings for\nnon-interactive conversion of documents.\n\n_For practical reasons we mention LibreOffice, but OpenOffice is supported by\nunoconv as well._\n\nInstalling unoconv\n==================\n\nunoconv can be installed using packages coming from your distribution, or\nsimply by copying the unoconv python script to your system.\n\nIf you installed unoconv by hand, make sure you have the required LibreOffice\nor OpenOffice packages installed. A hard requirement is the UNO python bindings\nwhich are often inside a subpackage named +libreoffice-pyuno+ or\n+libobasis4.4-pyuno+.\n\nVarious sub-packages are needed for specific import or export filters, e.g.\nXML-based filters require the xsltfilter subpackage,\ne.g. +libobasis4.4-xsltfilter+.\n\nIMPORTANT: Neglecting these requirements will cause unoconv to fail with\nunhelpful and confusing error messages.\n\nHow does unoconv work ?\n=======================\n\nunoconv starts its own office instance (if it cannot find an existing\nlistener) that it then uses. There are some challenges to do this\ncorrectly, but in general this works fine.\n\nTypically you would convert an ODT document to PDF by running::\n\n        unoconv -f pdf some-file.odt\n\nStart your own unoconv listener\n===============================\n\nHowever, you can always start an instance yourself at the default port 2002\n(or specify another port with -p/--port) and after use you can tear it down::\n\n    unoconv --listener &\n    sleep 20\n    unoconv -f pdf *.odt\n    unoconv -f doc *.odt\n    unoconv -f html *.odt\n    kill -15 %-\n\nIt is also possible to use a listener or LibreOffice instance that accepts\nconnections on another system and use it from unoconv remotely. This\nway the conversion tasks are performed on a dedicated system instead\nof on the client system. This works only if you have a shared filesystem\nmounted at the same location.\n\nPython and pyuno incompatibilities\n==================================\n\nBeware that the pyuno python module needs to be compiled with the exact\nsame version of python that you are using to load it. A lot of people that\nrun into problems loading pyuno are actually using a precompiled LibreOffice\nthat they downloaded somewhere and is incompatible with the python version\non their system.\n\nTo solve this issue, the project's office suite ships with its own python\ninterpreter located in the 'program' directory, this one should work\nflawlessly.\n\nThe most recent unoconv works around this issue by automatically detecting\nincompatibilities, and restarting itself using a compatible python (the same\none that ships with LibreOffice).\n\nYou can influence the automatic detection by setting the +UNO_PATH+ environment\nvariable to point to an alternative LibreOffice installation, e.g.::\n\n        UNO_PATH=/opt/libreoffice4.4 unoconv -f pdf some-file.odt\n\n\nBut you can also force another python by using it to execute unoconv, e.g.::\n\n        /opt/libreoffice4.4/program/python.bin unoconv -f pdf some-file.odt\n\nor on macOS::\n\n        /Applications/LibreOffice.app/Contents/MacOS/python unoconv -f pdf some-file.odt\n\nor on Windows::\n\n        C:\\Program Files (x86)\\LibreOffice 4.4\\program\\python.exe unoconv -f pdf some-file.odt\n\nTIP: If you plan to use unoconv extensively (or in an automated fashion) it\nis more efficient to use the correct python interpreter directly. Or event\nput it directly in the Shebang (the first line) of the unoconv script !\n\nUsing unoconv with no X display\n===============================\n\nSince OpenOffice 2.3 you do not need an X display for starting ooffice.\nHowever you may need the openoffice.org-headless package from your\ndistribution. Since LibreOffice 2.4 nothing special is needed, running\nin headless mode does not require X.\n\nFor any older OpenOffice releases, remember that ooffice requires an X\ndisplay, even when using it in headless mode. One solution is to use Xvfb\nto create a headless X display for ooffice.\n\n - http://www.oooforum.org/forum/viewtopic.phtml?t=11890\n - http://www.wonko.be/2008/01/09/running-openoffice-headless-on-debian\n - http://ward.vandewege.net/writings/200510auto_doc_conv/\n - http://www.artofsolving.com/node/10\n\nUsing unoconv with macOS\n========================\n\nLibreOffice 3.6.0.1 or later is required to use unoconv under macOS.  This\nis the first version distributed with an internal python script that works.\nNo version of OpenOffice for macOS (3.4 is the current version) works because\nthe necessary internal files are not included inside the application.\n\nProblems running unoconv from Nginx/Apache/PHP\n==============================================\n\nSome people have had difficulties using unoconv through webservices. Here\nis a list of probable causes and recommendations:\n\n - Use the latest version of unoconv (or GitHub master branch)\n\n - Use the most recent stable release of LibreOffice (less memory, more stable, fewer crashes)\n\n - Use the native LibreOffice python binary to run unoconv\n\n - Hardcode this native python path in the unoconv script shebang (or ensure PATH is set)\n\n - Ensure that the user running unoconv has write access to its HOME directory (ensure HOME is set)\n\n - Test with SELinux in permissive mode\n\n\nIt is recomended to open the unoconv script and modify the very first line to\npoint directly to your installed LibreOffice python binary, so replace this::\n\n        #!/usr/bin/env python\n\nwith something like this::\n\n        #!/opt/libreoffice4.4/program/python\n\nConversion problems\n===================\n\nIf you encounter problems converting files, it often helps to try again. If\nyou are using a listener, restarting the listener may help as well.\n\nThe reason for conversion failures are unclear, and they are not\ndeterministic. unoconv is not the only project to have noticed problems\nwith import and export filters using PyUNO. We assume these are related\nto internal state or timing issues that under certain conditions fail\nto correctly work.\n\nIf you can reproduce the problem on a specific file, please take the time to\nopen the file in LibreOffice directly and export it to the desired format. If\nthis fails, it needs to be reported to the LibreOffice project directly. If\nthat works, we need to know !\n\nWe are looking into this with the LibreOffice developers to:\n\n - Collaborate closer to find, report and fix unexpected failures\n - Allow end-users to increase debugging and improve reporting to the project\n\nTroubleshooting instructions\n============================\n\nIf you encounter a problem with converting documents using unoconv, please\nconsider that this could be caused by a number of things:\n\n - incomplete LibreOffice installation\n - LibreOffice bug or regression specific to your version/distribution\n - LibreOffice import or export filter issue\n - problem related to stale lock files\n - problem related to the source document\n - problem related to permissions or SELinux\n - problem related to the python UNO bindings\n - problem related to the unoconv python script\n\n\nIt is recommended to follow all of the below steps to pinpoint the problem:\n\n - if this is the first time you are using LibreOffice/OpenOffice, make sure\n   you have all the required sub-packages installed, depending on the\n   distribution this could be the +xsltfilter+, +headless+, +writer+,\n   +calc+, +impress+ or +draw+ sub-packages.\n\n - check if there is no existing LibreOffice process running on the system\n   that could interfere with proper functioning\n\n        # pgrep -l 'office|writer|calc'\n\n - check that there are no stale lock files present, e.g. '.~lock.file.pdf#' or\n\n   '.~lock.index.html#'\n\n - check that the LibreOffice instance handling UNO requests is not handling\n   multiple requests at the same time\n\n - try using the latest unoconv release, or the latest version on Github at::\n       https://github.com/dagwieers/unoconv/downloads\n\n - try the conversion by opening the file in LibreOffice and exporting\n   it through LibreOffice directly\n\n - try unoconv with a different minor or major LibreOffice version to test\n   whether it is a regression in LibreOffice\n\n - try to load the UNO bindings in python manually:\n\n   * do this with the python executable that ships with the LibreOffice\n     package/installer\n\n        # /opt/libreoffice4.4/program/python.bin -c 'import uno, unohelper'\n\n   * or alternatively, run the disribution python (with the distribution\n\n     LibreOffice)\n\n        # python -c 'import uno, unohelper'\n\n - try unoconv with a different python interpreter manually::\n\n\n        # /opt/libreoffice4.4/program/python.bin unoconv -f pdf test-file.odt\n\n\nIf you tried all of the above, and the issue still remains, the issue might\nstill be related to import/export filters, LibreOffice or unoconv, so please\nreport any information to reproduce the problem on the Github issue-tracker\nat: https://github.com/dagwieers/unoconv/issues\n\nAnd do mention that you already tried the above hints to troubleshoot the issue.\n\nInteresting information\n=======================\n\nIf you're interested to help out with development, here are some pointers to\ninteresting sources:\n\n - [Tutorial] Import uno module to a different Python install\n   http://user.services.openoffice.org/en/forum/viewtopic.php?f=45&t=36370&p=166783\n\n - UDK: UNO Development Kit\n   http://udk.openoffice.org/\n\n - Python-UNO bridge\n   http://www.openoffice.org/udk/python/python-bridge.html\n\n - Python and OpenOffice.org\n   http://wiki.services.openoffice.org/wiki/Python\n\n - OpenOffice.org developer manual\n   http://api.openoffice.org/DevelopersGuide/DevelopersGuide.html\n\n - Framework/Article/Filter/FilterList OOo 2 1\n   http://wiki.services.openoffice.org/wiki/Framework/Article/Filter/FilterList_OOo_2_1\n\n - Framework/Article/Filter/FilterList OOo 3 0\n   http://wiki.services.openoffice.org/wiki/Framework/Article/Filter/FilterList_OOo_3_0\n\nOther implementations\n=====================\n\nOther implementations using python and UNO:\n\n - convwatch\n   http://cgit.freedesktop.org/libreoffice/core/tree/bin/convwatch.py\n\n - oooconv\n   https://svn.infrae.com/oooconv/trunk/src/oooconv/filters.py\n\n - officeshots.org\n   http://code.officeshots.org/trac/officeshots/browser/trunk/factory/src/backends/oooserver.py\n\n - cloudooo\n   http://svn.erp5.org/erp5/trunk/utils/cloudooo.handler/ooo/cloudooo/handler/ooo/\n\nRelated tools\n=============\n\nOther tools that are useful or similar in operation:\n\n - Text based document generation::\n       http://www.methods.co.nz/asciidoc/\n\n - DocBook to OpenDocument XSLT::\n       http://open.comsultia.com/docbook2odf/\n\n - Simple (and stupid) converter from OpenDocument Text to plain text::\n       http://stosberg.net/odt2txt/\n\n - Another python tool to aid in converting files using UNO::\n       http://www.artofsolving.com/files/DocumentConverter.py\n       http://www.artofsolving.com/opensource/pyodconverter\n\n\n",
        "description_content_type": "",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/dagwieers/unoconv",
        "keywords": "openoffice uno office conversion",
        "license": "GPLv2",
        "maintainer": "",
        "maintainer_email": "",
        "name": "unoconv",
        "package_url": "https://pypi.org/project/unoconv/",
        "platform": "",
        "project_url": "https://pypi.org/project/unoconv/",
        "project_urls": {
            "Homepage": "https://github.com/dagwieers/unoconv"
        },
        "release_url": "https://pypi.org/project/unoconv/0.9.0/",
        "requires_dist": null,
        "requires_python": "",
        "summary": "Universal Office Converter - Office document conversion",
        "version": "0.9.0",
        "yanked": false,
        "yanked_reason": null
    },
    "last_serial": 6008674,
    "releases": {
        "0.6": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "eb230fb8eb8db29315d830ce7eafd1b0",
                    "sha256": "ae0106f70f7b2c02229b5590072b7d3878b1c7e814f7b6754998eac30b17c464"
                },
                "downloads": -1,
                "filename": "unoconv-0.6.tar.gz",
                "has_sig": false,
                "md5_digest": "eb230fb8eb8db29315d830ce7eafd1b0",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 14554,
                "upload_time": "2015-03-11T02:26:17",
                "upload_time_iso_8601": "2015-03-11T02:26:17.154041Z",
                "url": "https://files.pythonhosted.org/packages/32/18/491ad0af94868fc86c3caedb8a75f4660ac00e538888ec6cac367ce47c27/unoconv-0.6.tar.gz",
                "yanked": false,
                "yanked_reason": null
            }
        ],
        "0.8.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "e7716a365e441905cbf4db80da41c7b4",
                    "sha256": "435b999e41be273e34ecd8369d54a50e9cbbe2a5f78f5ffa3fd287cbd4f863cd"
                },
                "downloads": -1,
                "filename": "unoconv-0.8.2-py2.py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "e7716a365e441905cbf4db80da41c7b4",
                "packagetype": "bdist_wheel",
                "python_version": "2.7",
                "requires_python": null,
                "size": 26631,
                "upload_time": "2017-12-07T11:01:30",
                "upload_time_iso_8601": "2017-12-07T11:01:30.237861Z",
                "url": "https://files.pythonhosted.org/packages/59/0d/ebdf4ee153afcb7c2af4edc03e83c0adb6e3c2952791f5493738fbb19c60/unoconv-0.8.2-py2.py3-none-any.whl",
                "yanked": false,
                "yanked_reason": null
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "84591d929a0e03b651c1a53fccc6149c",
                    "sha256": "c7091a409384c05b3509b18be6c8d7059d26f491dfa78660ecdfbde3e72b03be"
                },
                "downloads": -1,
                "filename": "unoconv-0.8.2.tar.gz",
                "has_sig": false,
                "md5_digest": "84591d929a0e03b651c1a53fccc6149c",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 109650,
                "upload_time": "2017-12-07T11:02:03",
                "upload_time_iso_8601": "2017-12-07T11:02:03.714339Z",
                "url": "https://files.pythonhosted.org/packages/a2/b8/3131d20bfa2065e489edc7ca2dbfd66fd8d4fcbbde3476c76605a7e69269/unoconv-0.8.2.tar.gz",
                "yanked": false,
                "yanked_reason": null
            }
        ],
        "0.9.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "046d35eb6d4eee6c61f01dada973591d",
                    "sha256": "227ecb6d9c98d66318b960dbed6466afc35f886d235ad465f33a7130dd09c80b"
                },
                "downloads": -1,
                "filename": "unoconv-0.9.0-py2.py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "046d35eb6d4eee6c61f01dada973591d",
                "packagetype": "bdist_wheel",
                "python_version": "py2.py3",
                "requires_python": null,
                "size": 29310,
                "upload_time": "2019-10-21T18:32:22",
                "upload_time_iso_8601": "2019-10-21T18:32:22.940309Z",
                "url": "https://files.pythonhosted.org/packages/9d/61/b230690fa3752b8bafa0ada3125ee21ebd2a11d28a86cf1fa7bc0a384fde/unoconv-0.9.0-py2.py3-none-any.whl",
                "yanked": false,
                "yanked_reason": null
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "fe8ca9178eced76fc038109b1e502bb9",
                    "sha256": "308ebfd98e67d898834876348b27caf41470cd853fbe2681cc7dacd8fd5e6031"
                },
                "downloads": -1,
                "filename": "unoconv-0.9.0.tar.gz",
                "has_sig": false,
                "md5_digest": "fe8ca9178eced76fc038109b1e502bb9",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 115903,
                "upload_time": "2019-10-21T18:32:28",
                "upload_time_iso_8601": "2019-10-21T18:32:28.051723Z",
                "url": "https://files.pythonhosted.org/packages/ab/40/b4cab1140087f3f07b2f6d7cb9ca1c14b9bdbb525d2d83a3b29c924fe9ae/unoconv-0.9.0.tar.gz",
                "yanked": false,
                "yanked_reason": null
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "046d35eb6d4eee6c61f01dada973591d",
                "sha256": "227ecb6d9c98d66318b960dbed6466afc35f886d235ad465f33a7130dd09c80b"
            },
            "downloads": -1,
            "filename": "unoconv-0.9.0-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "046d35eb6d4eee6c61f01dada973591d",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": null,
            "size": 29310,
            "upload_time": "2019-10-21T18:32:22",
            "upload_time_iso_8601": "2019-10-21T18:32:22.940309Z",
            "url": "https://files.pythonhosted.org/packages/9d/61/b230690fa3752b8bafa0ada3125ee21ebd2a11d28a86cf1fa7bc0a384fde/unoconv-0.9.0-py2.py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "fe8ca9178eced76fc038109b1e502bb9",
                "sha256": "308ebfd98e67d898834876348b27caf41470cd853fbe2681cc7dacd8fd5e6031"
            },
            "downloads": -1,
            "filename": "unoconv-0.9.0.tar.gz",
            "has_sig": false,
            "md5_digest": "fe8ca9178eced76fc038109b1e502bb9",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 115903,
            "upload_time": "2019-10-21T18:32:28",
            "upload_time_iso_8601": "2019-10-21T18:32:28.051723Z",
            "url": "https://files.pythonhosted.org/packages/ab/40/b4cab1140087f3f07b2f6d7cb9ca1c14b9bdbb525d2d83a3b29c924fe9ae/unoconv-0.9.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "vulnerabilities": []
}