Can embed any file in a PNG/WebM/GIF/JPEG and upload it to a third-party host through 4chan
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

57 lines
1.9 KiB

2 years ago
PNG Extra Embedder (PEE)
========================
Can embed any file in a PNG/WebM/GIF and upload it through 4chanX.
2 years ago
Requires 4chanX and violentmonkey.
2 years ago
How to Build
============
npm i and npm run build
2 years ago
then install the generated main.users.js
2 years ago
How to Install
==============
2 years ago
Or use the prebuilt main.user.js at the root of this repo.
2 years ago
How to use
==========
Posts with an embedded image/video will have an eye icon next to it.
Clicking the icon reveal the content.
2 years ago
![eye](eye.png)
2 years ago
In the quick reply form, a magnet icon will appear.
You need to select a png file to upload first, as you would normally (this is what the file will appear as), then click on the magnet to select a file to embed.
![qr](screen.png)
Format
======
This works by appending the file in the last IDAT chunk.
Metadata information is stored in a tEXt chunk, placed near the header so that a parser looking for that embedded information can bail out without having to parse the whole file.
Metadata in the tEXt has the following meaning:
2 years ago
CUM[null]0 -> The last IDAT chunk is formatted as [filename length[LE 4 bytes], filename, filedata]
CUM[null]X is reserved for future extensions
Possible workaround for 4chan jannies would be to assoome IDAT chunks don't go over a certain size, slightly harder workaround would be to check if the deflate stream yields enough pixels to fit the described dimensions of the image.
Other formats
=============
The format used by Zip anon won't be supported because:
- it isn't extensible (if change were to the storage format, an extension update wouldn't be backcompatible)
- requires parsing the whole file to know if it has an embedded file
2 years ago
- and includes a private chunk type that is functionally defective (stores the length of the last IDAT chunk as a mean to identify it, instead of assooming it's simply the last one)
Bugs
====
- fails to find files in new posts after a thread update
- more to come