{"id":43507617,"url":"https://github.com/zextras/carbonio-preview-ce","last_synced_at":"2026-02-03T12:39:34.195Z","repository":{"id":38084289,"uuid":"471448618","full_name":"zextras/carbonio-preview-ce","owner":"zextras","description":"Preview backend service for Zextras Carbonio CE","archived":false,"fork":false,"pushed_at":"2026-01-23T03:15:19.000Z","size":347,"stargazers_count":2,"open_issues_count":11,"forks_count":3,"subscribers_count":13,"default_branch":"devel","last_synced_at":"2026-01-23T20:38:32.203Z","etag":null,"topics":["carbonio-component"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zextras.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-03-18T16:55:55.000Z","updated_at":"2025-12-30T07:57:46.000Z","dependencies_parsed_at":"2023-12-18T15:54:59.258Z","dependency_job_id":"eeb034f3-c24d-4740-af60-bd33b1ac17f6","html_url":"https://github.com/zextras/carbonio-preview-ce","commit_stats":null,"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"purl":"pkg:github/zextras/carbonio-preview-ce","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zextras%2Fcarbonio-preview-ce","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zextras%2Fcarbonio-preview-ce/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zextras%2Fcarbonio-preview-ce/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zextras%2Fcarbonio-preview-ce/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zextras","download_url":"https://codeload.github.com/zextras/carbonio-preview-ce/tar.gz/refs/heads/devel","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zextras%2Fcarbonio-preview-ce/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29046179,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-03T10:09:22.136Z","status":"ssl_error","status_checked_at":"2026-02-03T10:09:16.814Z","response_time":96,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["carbonio-component"],"created_at":"2026-02-03T12:39:31.201Z","updated_at":"2026-02-03T12:39:34.188Z","avatar_url":"https://github.com/zextras.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\nSPDX-FileCopyrightText: 2022 Zextras \u003chttps://www.zextras.com\n\nSPDX-License-Identifier: AGPL-3.0-only\n--\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003eCarbonio-Preview-ce 🚀 \u003c/h1\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\nPreview-ce backend service for Zextras Carbonio\n\n[![Contributors][contributors-badge]][contributors]\n[![Activity][activity-badge]][activity]\n[![security: bandit](https://img.shields.io/badge/security-bandit-yellow.svg)](https://github.com/PyCQA/bandit)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n[![License][license-badge]](COPYING)\n[![Project][project-badge]][project]\n[![Twitter][twitter-badge]][twitter]\n\n\u003c/div\u003e\n\nYou can preview the following type of files:\n\n- **images(png/jpeg/gif/svg)**\n- **pdf**\n- **docx, doc, odp, odt, ppt, xls, xlsx**\n\nYou will be able to:\n\n- **Get preview of files**.\n- **Generate thumbnail of files**.\n\nPreview will always try to output the file in its original format,\n while thumbnail will convert it to an image.\nThere is no difference in quality between the two,\n the difference in quality can be achieved only\nby asking for a jpeg format and changing the quality parameter.\nAsking for a GIF output can only be done when the input file is a GIF, otherwise it will raise and error.\n\n## APIs Documentation 📚\n\nOnce the service is up and running, APIs will be found\n[here](https://127.78.0.6:10000/docs)\n\n## Dependencies 🔗\n\nThese are the dependencies that the service has.\nThese dependencies are required to run the service correctly but are not installed by the package.\nThey must be installed if Mandatory otherwise user discretion is advised\n\n| Name                 | Mandatory/Optional |\n|----------------------|--------------------|\n| carbonio-storages-ce | Optional           |\n | carbonio-docs-editor | Optional           |\n\n## Service installation 🏁\n\nInstall `carbonio-preview-ce` via apt:\n\n```bash\nsudo apt install carbonio-preview-ce\n```\n\nor via yum:\n\n```bash\nsudo yum install carbonio-preview-ce\n```\n\n## Daemon setup 📈\n\nAfter the installation you must run `pending-setups` in order to register the service in `service-discover`.\nThis will start the service as a daemon and allow `carbonio-preview-ce` to communicate with the suite using Consul.\n\n## Project setup ⚙️🔧\n\nTo develop this project you will need to configure a proper enviroment.\n\n- download the project from the repository:\n\n```bash\ngit clone 'https://github.com/Zextras/carbonio-preview-ce'\n```\n\n- Go to the project folder\n\n```bash\nvirtualenv --python /usr/bin/python3 venv\nsource venv/bin/activate\n```\n\n- Install python libraries\n\n```bash\npip3 install -r \"dev_requirements.txt\"\n```\n\n## Debug and run 🔎\n\nTo start the application from command line, go to the project folder and type:\n\n```bash\ngunicorn controller:app --config gunicorn.conf.py\n```\n\nThere are others alternatives, you can also start the program from the main class (if you want to debug it).\n\n\n## CI and Tests 🤖\n\nStatic analysis is provided by a few tools:\n\n- Bandit: security analysis;\n- Flake8: code style and indentation analysis;\n- Pre-commit: runs static analysis before every commit;\n- autopep8: called automatically by pre-commit to static errors.\n\nPre-commit needs to be activated in the root directory of the project using:\n\n```bash\npre-commit install\n```\n\nTo activate commit lint (mandatory) then:\n\n```bash\npre-commit install --hook-type commit-msg\n```\n\nTo run unit tests manually, run the following command from the project folder:\n\n```bash\npython -m pytest\n```\n\n## Tech Stack 💾\n\nAll the python libraries used can be found on the \"requirements.txt\" file.\n\n## License\n\nOfficial Preview-ce backend service for Zextras Carbonio.\n\nReleased under the AGPL-3.0-only license as specified here: [COPYING](COPYING).\n\nSee [COPYING](COPYING) file for the project license details\n\nSee [THIRDPARTIES](THIRDPARTIES) file for other licenses details\n\n### Copyright notice\n\nAll non-software material (such as, for example, names, images, logos, sounds) is owned by Zextras\ns.r.l. and is licensed under [CC-BY-NC-SA](https://creativecommons.org/licenses/by-nc-sa/4.0/).\n\nWhere not specified, all source files owned by Zextras s.r.l. are licensed under AGPL-3.0-only\n\n[contributors-badge]: https://img.shields.io/github/contributors/zextras/carbonio-preview-ce \"Contributors\"\n\n[contributors]: https://github.com/zextras/carbonio-preview-ce/graphs/contributors \"Contributors\"\n\n[activity-badge]: https://img.shields.io/github/commit-activity/m/zextras/carbonio-preview-ce \"Activity\"\n\n[activity]: https://github.com/zextras/carbonio-preview-ce/pulse \"Activity\"\n\n[license-badge]: https://img.shields.io/badge/license-AGPL-blue.svg\n\n[project-badge]: https://img.shields.io/badge/project-carbonio-informational \"Project Carbonio\"\n\n[project]: https://www.zextras.com/carbonio/ \"Project Carbonio\"\n\n[twitter-badge]: https://img.shields.io/twitter/follow/zextras?style=social\u0026logo=twitter \"Follow on Twitter\"\n\n[twitter]: https://twitter.com/intent/follow?screen_name=zextras \"Follow Zextras on Twitter\"\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzextras%2Fcarbonio-preview-ce","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzextras%2Fcarbonio-preview-ce","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzextras%2Fcarbonio-preview-ce/lists"}