Supported formats - Zariep-Software/WiPersona GitHub Wiki

Since WiPersona is running on the browser, format support depends purely on the browser, see https://developer.mozilla.org/en-US/docs/Web/Media/Formats/Image_types#common_image_file_types. Therefore, for performance reasons is recommended to use webp (most compatible format) or avif if you are running a modern web browser, those formats also supports animated sequences.

Common image file types

The image file formats that are most commonly used on the web are listed below.

Abbreviation File format MIME type File extension(s) Summary
APNG Animated Portable Network Graphics image/apng .apng, .png Good choice for lossless animation sequences (GIF is less performant). AVIF and WebP have better performance but less broad browser support.
Support: Chrome, Edge, Firefox, Opera, Safari.
AVIF AV1 Image File Format image/avif .avif

Good choice for both images and animated images due to high performance and royalty free image format. It offers much better compression than PNG or JPEG with support for higher color depths, animated frames, transparency, etc. Note that when using AVIF, you should include fallbacks to formats with better browser support (i.e. using the <picture> element).
Support: Chrome, Edge, Firefox, Opera, Safari.

GIF Graphics Interchange Format image/gif .gif Good choice for simple images and animations. Prefer PNG for lossless and indexed still images, and consider WebP, AVIF or APNG for animation sequences.
Support: Chrome, Edge, Firefox, IE, Opera, Safari.
JPEG Joint Photographic Expert Group image image/jpeg .jpg, .jpeg, .jfif, .pjpeg, .pjp

Good choice for lossy compression of still images (currently the most popular). Prefer PNG when more precise reproduction of the image is required, or WebP/AVIF if both better reproduction and higher compression are required.
Support: Chrome, Edge, Firefox, IE, Opera, Safari.

PNG Portable Network Graphics image/png .png

PNG is preferred over JPEG for more precise reproduction of source images, or when transparency is needed. WebP/AVIF provide even better compression and reproduction, but browser support is more limited.
Support: Chrome, Edge, Firefox, IE, Opera, Safari.

SVG Scalable Vector Graphics image/svg+xml .svg Vector image format; ideal for user interface elements, icons, diagrams, etc., that must be drawn accurately at different sizes.
Support: Chrome, Edge, Firefox, IE, Opera, Safari.
WebP Web Picture format image/webp .webp Excellent choice for both images and animated images. WebP offers much better compression than PNG or JPEG with support for higher color depths, animated frames, transparency etc. AVIF offers slightly better compression, but is not quite as well-supported in browsers and does not support progressive rendering.
Support: Chrome, Edge, Firefox, Opera, Safari

Note

The older formats like PNG, JPEG, GIF have poor performance compared to newer formats like WebP and AVIF, but enjoy broader "historical" browser support. The newer image formats are seeing increasing popularity as browsers without support become increasingly irrelevant (i.e. have virtually zero market share).

Image file type and format guide - Web media technologies | MDN. (2024, September 16). MDN Web Docs. https://developer.mozilla.org/en-US/docs/Web/Media/Formats/Image_types#common_image_file_types

Videos?

WiPersona doesn't support videos due to programming logic (it uses CSS backgrounds). This approach offers benefits such as preventing stoping of animation and reducing flickering when changing avatars. Therefore, if the browser supports videos as CSS Backgrounds for some reason, it may work, but it is not recommended.

⚠️ **GitHub.com Fallback** ⚠️