## tinyoffice
Make your Office files tiny!
`tinyoffice` attemps to compresses and optionally convert the embedded image files in your Office files.
## Installation
You can install `tinyoffice` from PyPi:
```
% pip install tinyoffice
```
NOTE: `tinyoffice` requires `Pillow` (`PIL` Fork) [Pillow](https://pillow.readthedocs.io/en/stable/), which can have installation conflicts. If you experience any issues while installing `tinyoffice`, please follow the `Pillow` installation steps found here: https://pillow.readthedocs.io/en/stable/installation.html.
## Usage
```
usage: tinyoffice [-h] [-r] [-c] [-v]
[-t .docx .pptx .xlsx [.docx .pptx .xlsx ...]] [--overwrite]
[-o OUTPUT] [-exts EXTENSIONS [EXTENSIONS ...]]
path
Make your Office files tiny!
positional arguments:
path File or directory path.
If a file and recurse (-r/--recurse) is not set, only that file will be compressed.
If a directory and recurse is not set, only the top-level files in the directory will be compressed.
If recurse is set, everything at path and below will be compressed.
options:
-h, --help show this help message and exit
-r, --recurse Flag for if tinyoffice should recursively search for files. Default is False
-c, --convert Flag for if TIFF files should be converted to JPEGs. Default is False
-v, --verbose Flag for verbosity levels. Can be set multiple times, e.g., -vv, for increased verbosity
-t .docx .pptx .xlsx [.docx .pptx .xlsx ...], --types .docx .pptx .xlsx [.docx .pptx .xlsx ...]
Filetype extensions to compress.
Default is .docx, .pptx, .xlsx
--overwrite Flag for if an existing file should be overwritten. Default is False
-o OUTPUT, --output OUTPUT
Path for the output location.
-exts EXTENSIONS [EXTENSIONS ...], --extensions EXTENSIONS [EXTENSIONS ...]
Image extensions to compress. Default will be only the extensions that are supported by Pillow on your system.
Should be ignored.
```
Raw data
{
"_id": null,
"home_page": null,
"name": "tinyoffice",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "office, compress, convert, image, Word, Excel, Powerpoint",
"author": null,
"author_email": "Samuel Woodward <sam@woodward.fyi>",
"download_url": "https://files.pythonhosted.org/packages/c2/bd/81b82a5dde8719d074c70c540d7652db99dc73ce6ce34c1d07a792c91610/tinyoffice-0.0.9.tar.gz",
"platform": null,
"description": "## tinyoffice\n\nMake your Office files tiny!\n\n`tinyoffice` attemps to compresses and optionally convert the embedded image files in your Office files.\n\n\n## Installation\n\nYou can install `tinyoffice` from PyPi:\n\n```\n% pip install tinyoffice\n```\n\nNOTE: `tinyoffice` requires `Pillow` (`PIL` Fork) [Pillow](https://pillow.readthedocs.io/en/stable/), which can have installation conflicts. If you experience any issues while installing `tinyoffice`, please follow the `Pillow` installation steps found here: https://pillow.readthedocs.io/en/stable/installation.html.\n\n\n## Usage\n\n```\nusage: tinyoffice [-h] [-r] [-c] [-v]\n [-t .docx .pptx .xlsx [.docx .pptx .xlsx ...]] [--overwrite]\n [-o OUTPUT] [-exts EXTENSIONS [EXTENSIONS ...]]\n path\n\nMake your Office files tiny!\n\npositional arguments:\n path File or directory path.\n If a file and recurse (-r/--recurse) is not set, only that file will be compressed.\n If a directory and recurse is not set, only the top-level files in the directory will be compressed.\n If recurse is set, everything at path and below will be compressed.\n\noptions:\n -h, --help show this help message and exit\n -r, --recurse Flag for if tinyoffice should recursively search for files. Default is False\n -c, --convert Flag for if TIFF files should be converted to JPEGs. Default is False\n -v, --verbose Flag for verbosity levels. Can be set multiple times, e.g., -vv, for increased verbosity\n -t .docx .pptx .xlsx [.docx .pptx .xlsx ...], --types .docx .pptx .xlsx [.docx .pptx .xlsx ...]\n Filetype extensions to compress.\n Default is .docx, .pptx, .xlsx\n --overwrite Flag for if an existing file should be overwritten. Default is False\n -o OUTPUT, --output OUTPUT\n Path for the output location.\n -exts EXTENSIONS [EXTENSIONS ...], --extensions EXTENSIONS [EXTENSIONS ...]\n Image extensions to compress. Default will be only the extensions that are supported by Pillow on your system.\n Should be ignored.\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "Make your Office files tiny!",
"version": "0.0.9",
"project_urls": {
"Homepage": "https://github.com/PyWoody/tinyoffice"
},
"split_keywords": [
"office",
" compress",
" convert",
" image",
" word",
" excel",
" powerpoint"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "cfb3bc1a15da38e42f3032b292b2aa8f5b42e0dff7f1b5ad18f386e005749095",
"md5": "b8a0cd51364ba646be67d18e0e129cf5",
"sha256": "0141c355b93509dbaab55aed1dd375a073d32da80ed0cda0fc473b1e69b6cb61"
},
"downloads": -1,
"filename": "tinyoffice-0.0.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b8a0cd51364ba646be67d18e0e129cf5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 8631,
"upload_time": "2025-08-30T17:50:14",
"upload_time_iso_8601": "2025-08-30T17:50:14.419799Z",
"url": "https://files.pythonhosted.org/packages/cf/b3/bc1a15da38e42f3032b292b2aa8f5b42e0dff7f1b5ad18f386e005749095/tinyoffice-0.0.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c2bd81b82a5dde8719d074c70c540d7652db99dc73ce6ce34c1d07a792c91610",
"md5": "b341f87782029254034279a8febbad4e",
"sha256": "449fa51963f68050759203939992923e9c1869fc66d3c8d81a3616619d27c2d4"
},
"downloads": -1,
"filename": "tinyoffice-0.0.9.tar.gz",
"has_sig": false,
"md5_digest": "b341f87782029254034279a8febbad4e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 9787,
"upload_time": "2025-08-30T17:50:15",
"upload_time_iso_8601": "2025-08-30T17:50:15.544577Z",
"url": "https://files.pythonhosted.org/packages/c2/bd/81b82a5dde8719d074c70c540d7652db99dc73ce6ce34c1d07a792c91610/tinyoffice-0.0.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-30 17:50:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "PyWoody",
"github_project": "tinyoffice",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "tinyoffice"
}
JSON
