RepoMirrors
/
hydrus
mirror of https://github.com/hydrusnetwork/hydrus.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
hydrus/docs/filetypes.md

109 lines
13 KiB
Markdown
Raw Permalink Normal View History

Docs update: new filetype list, search on local help, other corrections (#1430) * Fix typo in running from source * Add new page listing filetypes * Add a return * Enable searching docs when offline * Add last updated date to docs pages and edit buttons when hosted * Add mkdocs-git-revision-date-localized-plugin plugin to gh actions * Correction * Update publish_docs gh actions * Exclude index.md from last update dates * flv files are actually viewable in hydrus * Add note about how Hydrus determines filetypes
2023-08-30 16:28:38 +00:00
---
title: Supported Filetypes
---
This is a list of all filetypes Hydrus can import. Hydrus determines the filetype based on examining the file itself rather than the extension or MIME type.
Add ugoira and cbz to filetypes doc and note about force filetype (#1496)
2024-01-01 21:24:34 +00:00
The filetype for a file can be overridden with `manage -> force filetype` in the context menu for a file.
Docs update: new filetype list, search on local help, other corrections (#1430) * Fix typo in running from source * Add new page listing filetypes * Add a return * Enable searching docs when offline * Add last updated date to docs pages and edit buttons when hosted * Add mkdocs-git-revision-date-localized-plugin plugin to gh actions * Correction * Update publish_docs gh actions * Exclude index.md from last update dates * flv files are actually viewable in hydrus * Add note about how Hydrus determines filetypes
2023-08-30 16:28:38 +00:00
## Images
| Filetype | Extension | MIME type | Thumbnails | Viewable in Hydrus | Notes |
Add epub and djvu to filetype docs
2023-10-12 00:38:46 +00:00
| ---------- | --------- | -------------- | :--------: | :----------------: | ------------------------------------------ |
Docs update: new filetype list, search on local help, other corrections (#1430) * Fix typo in running from source * Add new page listing filetypes * Add a return * Enable searching docs when offline * Add last updated date to docs pages and edit buttons when hosted * Add mkdocs-git-revision-date-localized-plugin plugin to gh actions * Correction * Update publish_docs gh actions * Exclude index.md from last update dates * flv files are actually viewable in hydrus * Add note about how Hydrus determines filetypes
2023-08-30 16:28:38 +00:00
| jpeg | `.jpeg` | `image/jpeg` | ✅ | ✅ | |
| png | `.png` | `image/png` | ✅ | ✅ | |
| static gif | `.gif` | `image/gif` | ✅ | ✅ | |
| webp | `.webp` | `image/webp` | ✅ | ✅ | Animated webp files will display as static |
| tiff | `.tiff` | `image/tiff` | ✅ | ✅ | |
| qoi | `.qoi` | `image/qoi` | ✅ | ✅ | Quite OK Image Format |
| icon | `.ico` | `image/x-icon` | ✅ | ✅ | |
Version 543
2023-09-13 18:26:31 +00:00
| bmp | `.bmp` | `image/bmp` | ✅ | ✅ | |
Docs update: new filetype list, search on local help, other corrections (#1430) * Fix typo in running from source * Add new page listing filetypes * Add a return * Enable searching docs when offline * Add last updated date to docs pages and edit buttons when hosted * Add mkdocs-git-revision-date-localized-plugin plugin to gh actions * Correction * Update publish_docs gh actions * Exclude index.md from last update dates * flv files are actually viewable in hydrus * Add note about how Hydrus determines filetypes
2023-08-30 16:28:38 +00:00
| heif | `.heif` | `image/heif` | ✅ | ✅ | |
| heic | `.heic` | `image/heic` | ✅ | ✅ | |
| avif | `.avif` | `image/avif` | ✅ | ✅ | |
## Animations
Add ugoira and cbz to filetypes doc and note about force filetype (#1496)
2024-01-01 21:24:34 +00:00
| Filetype | Extension | MIME type | Thumbnails | Viewable in Hydrus | Notes |
| ------------- | --------- | --------------------- | :--------: | :----------------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| animated gif | `.gif` | `image/gif` | ✅ | ✅ | |
| apng | `.apng` | `image/apng` | ✅ | ✅ | |
| heif sequence | `.heifs` | `image/heif-sequence` | ✅ | ✅ | |
| heic sequence | `.heics` | `image/heic-sequence` | ✅ | ✅ | |
| avif sequence | `.avifs` | `image/avif-sequence` | ✅ | ✅ | |
| ugoira | `.zip` | `application/zip` | ✅ | ❌ | [Pixiv Ugoira format](https://www.pixiv.help/hc/en-us/articles/235584628-What-are-Ugoira-). A zip file containing images with 6 digit zero-padded filenames will be identified as a Ugoira file. |
Docs update: new filetype list, search on local help, other corrections (#1430) * Fix typo in running from source * Add new page listing filetypes * Add a return * Enable searching docs when offline * Add last updated date to docs pages and edit buttons when hosted * Add mkdocs-git-revision-date-localized-plugin plugin to gh actions * Correction * Update publish_docs gh actions * Exclude index.md from last update dates * flv files are actually viewable in hydrus * Add note about how Hydrus determines filetypes
2023-08-30 16:28:38 +00:00
## Video
| Filetype | Extension | MIME type | Thumbnails | Viewable in Hydrus | Notes |
| --------- | --------- | ------------------------ | :--------: | :----------------: | ----- |
| mp4 | `.mp4` | `video/mp4` | ✅ | ✅ | |
| webm | `.webm` | `video/webm` | ✅ | ✅ | |
| matroska | `.mkv` | `video/x-matroska` | ✅ | ✅ | |
| avi | `.avi` | `video/x-msvideo` | ✅ | ✅ | |
| flv | `.flv` | `video/x-flv` | ✅ | ✅ | |
| quicktime | `.mov` | `video/quicktime` | ✅ | ✅ | |
| mpeg | `.mpeg` | `video/mpeg` | ✅ | ✅ | |
| ogv | `.ogv` | `video/ogg` | ✅ | ✅ | |
| realvideo | `.rm` | `video/vnd.rn-realvideo` | ✅ | ✅ | |
| wmv | `.wmv` | `video/x-ms-wmv` | ✅ | ✅ | |
## Audio
| Filetype | Extension | MIME type | Viewable in Hydrus | Notes |
| -------------- | --------- | ------------------------ | :----------------: | ----- |
| mp3 | `.mp3` | `audio/mp3` | ✅ | |
| ogg | `.ogg` | `audio/ogg` | ✅ | |
| flac | `.flac` | `audio/flac` | ✅ | |
| m4a | `.m4a` | `audio/mp4` | ✅ | |
| matroska audio | `.mkv` | `audio/x-matroska` | ✅ | |
| mp4 audio | `.mp4` | `audio/mp4` | ✅ | |
| realaudio | `.ra` | `audio/vnd.rn-realaudio` | ✅ | |
| tta | `.tta` | `audio/x-tta` | ✅ | |
| wave | `.wav` | `audio/x-wav` | ✅ | |
| wavpack | `.wv` | `audio/wavpack` | ✅ | |
| wma | `.wma` | `audio/x-ms-wma` | ✅ | |
## Applications
Improvements to MS Office filetype support (#1528) * Update icons for MS Office filetypes * Remove unused old PDF word count code * Add more strict office file detection * Remove old HydrusDocumentHandling import * Add word count for docx and pptx and thumbnails for pptx * Update filetypes doc * Update filetype docs with pptx dpi * Remove prints and clean up formatting * Center default thumbnails inside target resolution
2024-03-16 20:35:32 +00:00
| Filetype | Extension | MIME type | Thumbnails | Viewable in Hydrus | Notes |
| -------- | --------- | --------------------------------------------------------------------------- | :--------: | :----------------: | -------------------------------------------------------------------------- |
| flash | `.swf` | `application/x-shockwave-flash` | ✅ | ❌ | |
| pdf | `.pdf` | `application/pdf` | ✅ | ❌ | 300 DPI assumed for resolution. No thumbnails for encrypted PDFs. |
| epub | `.epub` | `application/epub+zip` | ❌ | ❌ | |
| djvu | `.djvu` | `image/vnd.djvu` | ❌ | ❌ | |
| docx | `.docx` | `application/vnd.openxmlformats-officedocument.wordprocessingml.document` | ❌ | ❌ | |
| xlsx | `.xlsx` | `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` | ❌ | ❌ | |
| pptx | `.pptx` | `application/vnd.openxmlformats-officedocument.presentationml.presentation` | ✅ | ❌ | 300 DPI assumed for resolution. Thumbnail only if embedded in the document |
| rtf | `.rtf` | `application/rtf` | ❌ | ❌ | |
Docs update: new filetype list, search on local help, other corrections (#1430) * Fix typo in running from source * Add new page listing filetypes * Add a return * Enable searching docs when offline * Add last updated date to docs pages and edit buttons when hosted * Add mkdocs-git-revision-date-localized-plugin plugin to gh actions * Correction * Update publish_docs gh actions * Exclude index.md from last update dates * flv files are actually viewable in hydrus * Add note about how Hydrus determines filetypes
2023-08-30 16:28:38 +00:00
## Image Project Files
Krita full preview support (#1454) * Krita full preview support Mark krita files as viewable Use same data that's used for thumbnails to generate full preview * Parse maindoc.xml instead of doing regex magic This should fix getting dimensions wrong for some files * Use direct PIL image loading for Krita thumbs * Remove unused HydrusArchiveHandling.ReadSingleFileFromZip * Update Krita in filetype docs --------- Co-authored-by: Paul Friederichsen <floogulinc@gmail.com> Co-authored-by: Hydrus Network Developer <hydrus.admin@gmail.com>
2023-10-14 19:29:49 +00:00
| Filetype | Extension | MIME type | Thumbnails | Viewable in Hydrus | Notes |
| --------- | ------------ | ----------------------------- | :--------: | :----------------: | -------------------------------------------------------------------------------- |
| psd | `.psd` | `image/vnd.adobe.photoshop` | ✅ | ✅ | Adobe Photoshop. Hydrus shows the embedded preview image if present in the file. |
| clip | `.clip` | `application/clip`[^1] | ✅ | ❌ | Clip Studio Paint |
| sai2 | `.sai2` | `application/sai2`[^1] | ❌ | ❌ | PaintTool SAI2 |
| krita | `.kra` | `application/x-krita` | ✅ | ✅ | Krita. Hydrus shows the embedded preview image if present in the file. |
| svg | `.svg` | `image/svg+xml` | ✅ | ❌ | |
| xcf | `.xcf` | `application/x-xcf` | ❌ | ❌ | GIMP |
| procreate | `.procreate` | `application/x-procreate`[^1] | ✅ | ❌ | Procreate app |
Docs update: new filetype list, search on local help, other corrections (#1430) * Fix typo in running from source * Add new page listing filetypes * Add a return * Enable searching docs when offline * Add last updated date to docs pages and edit buttons when hosted * Add mkdocs-git-revision-date-localized-plugin plugin to gh actions * Correction * Update publish_docs gh actions * Exclude index.md from last update dates * flv files are actually viewable in hydrus * Add note about how Hydrus determines filetypes
2023-08-30 16:28:38 +00:00
## Archives
Add ugoira and cbz to filetypes doc and note about force filetype (#1496)
2024-01-01 21:24:34 +00:00
| Filetype | Extension | MIME type | Thumbnails | Notes |
| -------- | --------- | ------------------------------- | :--------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 7z | `.7z` | `application/x-7z-compressed` | ❌ | |
| gzip | `.gz` | `application/gzip` | ❌ | |
| rar | `.rar` | `application/vnd.rar` | ❌ | |
| zip | `.zip` | `application/zip` | ❌ | |
| cbz | `.cbz` | `application/vnd.comicbook+zip` | ✅ | A zip file containing images with incrementing numbers in their filenames will be identified as a cbz file. The code for identifying a cbz file is in [`hydrus/core/HydrusArchiveHandling.py`](https://github.com/hydrusnetwork/hydrus/blob/master/hydrus/core/HydrusArchiveHandling.py) |
Docs update: new filetype list, search on local help, other corrections (#1430) * Fix typo in running from source * Add new page listing filetypes * Add a return * Enable searching docs when offline * Add last updated date to docs pages and edit buttons when hosted * Add mkdocs-git-revision-date-localized-plugin plugin to gh actions * Correction * Update publish_docs gh actions * Exclude index.md from last update dates * flv files are actually viewable in hydrus * Add note about how Hydrus determines filetypes
2023-08-30 16:28:38 +00:00
Version 543
2023-09-13 18:26:31 +00:00
[^1]: This filetype doesn't have an official or de facto media type, the one listed was made up for Hydrus.