| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Lines of code | 117 |
| Technical Name |
oe_attachement_heic_convert |
| License | OPL-1 |
| Website | https://odooerp.ae/ |
| Versions | 15.0 16.0 17.0 18.0 19.0 |
Key Features
Automatic HEIC/HEIF to PNG conversion for Odoo image uploads
Automatic conversion
Converts HEIC/HEIF images to PNG automatically during upload so users can work with a browser-safe format everywhere in Odoo.
Zero extra steps
Works from any image upload using the standard image widget; no extra user action required.
Smart filename update
Preserves filename usability by renaming .heic / .heif uploads to .png after conversion.
Robust HEIF detection
Supports both filename-based detection and MIME/content fallback detection for HEIF files.
Server-side conversion
Backend conversion is done server-side through Pillow + pillow_heif for reliable PNG output.
Web client support
Frontend patch ensures HEIC uploads from the image widget are converted before storing.
Create/write coverage
Handles create and write operations on attachments so converted files remain consistent.
Mimetype consistency
Keeps mimetype synchronized to image/png after conversion.
Lightweight behavior
Lightweight module with no workflow change for end users. Upload and continue.
User guide â HEIC Attachment Convert
Follow these steps to install, configure dependency, and validate automatic HEIC/HEIF conversion to PNG in Odoo 17.
1. Install dependency and module
- Go to Apps, remove the Apps filter, search HEIC Attachment Convert, and click Install (or Activate).
- Install Python package pillow_heif on the Odoo server, then restart Odoo service.
- No extra menu setup is required. The module works directly on attachment/image uploads.
2. Upload HEIC/HEIF image
- Open any form with an image upload widget (for example product, employee, or attachment upload).
- Select a .heic or .heif image file.
- Save the record as usual.
3. Verify converted output
- Open the saved record or attachment.
- Confirm the image is stored as PNG.
- Confirm the filename extension is updated to .png.
4. Check attachment behavior
- The module handles both binary payload styles: datas and raw.
- HEIF-like files are detected via extension, mimetype, or file signature fallback.
- Converted attachments are written with mimetype = image/png.
5. Optional frontend check
- Use web client image widget upload to test the JS patch flow.
- The frontend calls server method and receives converted PNG data.
- Upload continues transparently for users.
6. Error handling
- If conversion fails, Odoo logs the error for debugging.
- Verify server package installation and restart service when needed.
7. Daily usage
- Users keep uploading HEIC files in the same way they already do.
- The system stores PNG output automatically for compatibility.
8. Compatibility notes
- Depends on: base + web and Python package pillow_heif.
- Odoo Version: compatible with Odoo 17.
- Scope: image uploads and attachments only.
Frequently Asked Questions
1. What does HEIC Attachment Convert add that standard Odoo does not?
Automatic conversion of HEIC/HEIF image uploads into PNG so attachments and image fields remain usable across Odoo clients and browsers.
2. Which Odoo apps must be installed?
base and web. Python dependency: pillow_heif (with Pillow). Built for Odoo 17.
3. Which formats are converted?
Files detected as .heic / .heif or HEIF-like MIME/content are converted to PNG.
4. When does conversion run?
Conversion runs during attachment create/write and from patched image uploads in the web client.
5. Do I need new access groups?
No new security group is required. Behavior applies automatically where image uploads are used.
6. What happens if conversion fails?
The module logs an error and keeps the operation safe. Ensure pillow_heif is installed correctly on the server.
7. Is multi-company supported?
Yes. The conversion logic works across companies because it is executed on `ir.attachment`.
Module Support & SLA
For support related to this module, contact apps@odooerp.ae
Standard response time (SLA) for support queries is typically 1 to 2 working days.
Standard response time (SLA) for support queries is typically 1 to 2 working days.
apps@odooerp.ae
Email Us
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module