2020-06-08 03:29:51 +03:00
|
|
|
|
# fq
|
|
|
|
|
|
|
2021-08-14 01:11:57 +03:00
|
|
|
|
Tool, language and decoders for exploring binary data.
|
2020-06-08 03:29:51 +03:00
|
|
|
|
|
|
|
|
|
|
<sub>
|
|
|
|
|
|
<pre sh>
|
|
|
|
|
|
<b># Overview of mp3 file</b>
|
|
|
|
|
|
$ fq . file.mp3
|
|
|
|
|
|
|00 01 02 03 04 05 06 07 08 09 0a 0b 0c 0d 0e 0f| |.: {} file.mp3 (mp3)
|
|
|
|
|
|
0x000|49 44 33 04 00 00 00 00 15 39 54 53 53 45 00 00|ID3......9TSSE..| headers: [1]
|
|
|
|
|
|
* |until 0xac2.7 (2755) | |
|
|
|
|
|
|
0xac0| ff fb 40 c0 00 00 00 00 00 00 00 00 00| ..@..........| frames: [3]
|
|
|
|
|
|
0xad0|00 00 00 00 00 00 00 00 49 6e 66 6f 00 00 00 0f|........Info....|
|
|
|
|
|
|
* |until 0xd19.7 (end) (599) | |
|
|
|
|
|
|
| | | footers: [0]
|
|
|
|
|
|
|
|
|
|
|
|
<b># Show ID3v2 APIC frame</b>
|
|
|
|
|
|
$ fq '.headers[].frames[] | select(.id == "APIC")' file.mp3
|
|
|
|
|
|
|00 01 02 03 04 05 06 07 08 09 0a 0b 0c 0d 0e 0f| |.headers[0].frames[1]: {}
|
|
|
|
|
|
0x020| 41 50 49 43 | APIC | id: "APIC" (Attached picture)
|
|
|
|
|
|
0x020| 00 00 15 0c | .... | size: 2700
|
|
|
|
|
|
0x020| 00 00 | .. | flags: {}
|
|
|
|
|
|
0x020| 03 | . | text_encoding: UTF-8 (3)
|
|
|
|
|
|
0x020| 69 6d| im| mime_type: "image/png"
|
|
|
|
|
|
0x030|61 67 65 2f 70 6e 67 00 |age/png. |
|
|
|
|
|
|
0x030| 00 | . | picture_type: 0
|
|
|
|
|
|
0x030| 00 | . | description: ""
|
|
|
|
|
|
0x030| 89 50 4e 47 0d 0a| .PNG..| picture: {} (png)
|
|
|
|
|
|
0x040|1a 0a 00 00 00 0d 49 48 44 52 00 00 01 40 00 00|......IHDR...@..|
|
|
|
|
|
|
* |until 0xab8.7 (2687) | |
|
|
|
|
|
|
|
|
|
|
|
|
<b># Resolution of embedded PNG file</b>
|
|
|
|
|
|
$ fq '.headers[].frames[] | select(.id == "APIC").picture.chunks[] | select(.type == "IHDR") | {width, height}' file.mp3
|
|
|
|
|
|
{
|
|
|
|
|
|
"height": 240,
|
|
|
|
|
|
"width": 320
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
<b># Extract PNG file</b>
|
2021-09-04 12:39:33 +03:00
|
|
|
|
$ fq '.headers[].frames[] | select(.id == "APIC")?.picture | tobits' file.mp3 > file.png
|
2020-06-08 03:29:51 +03:00
|
|
|
|
$ file file.png
|
|
|
|
|
|
file.png: PNG image data, 320 x 240, 8-bit/color RGB, non-interlaced
|
|
|
|
|
|
|
|
|
|
|
|
<b># Codecs in a mp4 file</b>
|
|
|
|
|
|
$ fq '[.. | select(.type == "stsd")?.boxes[].type]' file.mp4
|
|
|
|
|
|
[
|
|
|
|
|
|
"avc1",
|
|
|
|
|
|
"mp4a"
|
|
|
|
|
|
]
|
|
|
|
|
|
</pre>
|
|
|
|
|
|
</sub>
|
|
|
|
|
|
|
|
|
|
|
|
## Install
|
|
|
|
|
|
|
|
|
|
|
|
Download archive from [releases](https://github.com/wader/fq/releases) page for your
|
|
|
|
|
|
platform, unarchive and move the executable to `PATH`.
|
|
|
|
|
|
|
|
|
|
|
|
### Homebrew
|
|
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
|
# install latest release
|
|
|
|
|
|
brew install wader/tap/fq
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
### Build from source
|
|
|
|
|
|
|
2021-08-20 16:10:16 +03:00
|
|
|
|
Make sure you have go 1.17 or later and then do:
|
2020-06-08 03:29:51 +03:00
|
|
|
|
```sh
|
2021-08-20 16:10:16 +03:00
|
|
|
|
# build and install latest master
|
2020-06-08 03:29:51 +03:00
|
|
|
|
go install github.com/wader/fq@latest
|
|
|
|
|
|
```
|
|
|
|
|
|
and the binary should end up at `$GOPATH/bin/fq`.
|
|
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
|
|
Basic usage is:
|
|
|
|
|
|
|
|
|
|
|
|
[fq -h | grep Usage: | sed 's/\(.*\)/<pre>\1<\/pre>/']: sh-start
|
|
|
|
|
|
|
2021-08-12 21:07:34 +03:00
|
|
|
|
<pre>Usage: fq [OPTIONS] [--] [EXPR] [FILE...]</pre>
|
2020-06-08 03:29:51 +03:00
|
|
|
|
|
|
|
|
|
|
[#]: sh-end
|
|
|
|
|
|
|
|
|
|
|
|
For more usage details see [usage.md](doc/usage.md).
|
|
|
|
|
|
|
|
|
|
|
|
## Supported formats
|
|
|
|
|
|
|
|
|
|
|
|
[./formats_list.jq]: sh-start
|
|
|
|
|
|
|
2021-09-02 19:02:04 +03:00
|
|
|
|
aac_frame, adts, adts_frame, apev2, av1_ccr, av1_frame, av1_obu, avc_annexb, avc_au, avc_dcr, avc_nalu, avc_pps, avc_sei, avc_sps, bzip2, dns, elf, exif, flac, flac_frame, flac_metadatablock, flac_picture, gif, gzip, hevc_annexb, hevc_au, hevc_dcr, hevc_nalu, icc_profile, id3v1, id3v11, id3v2, jpeg, json, matroska, mp3, mp3_frame, mp4, mpeg_asc, mpeg_es, mpeg_pes, mpeg_pes_packet, mpeg_spu, mpeg_ts, ogg, ogg_page, opus_packet, png, protobuf, protobuf_widevine, pssh_playready, raw, tar, tiff, vorbis_comment, vorbis_packet, vp8_frame, vp9_cfm, vp9_frame, vpx_ccr, wav, webp, xing
|
2020-06-08 03:29:51 +03:00
|
|
|
|
|
|
|
|
|
|
[#]: sh-end
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
For more format details see [usage.md](doc/usage.md).
|
|
|
|
|
|
|
|
|
|
|
|
## TODO and ideas
|
|
|
|
|
|
|
|
|
|
|
|
See [TODO.md](doc/TODO.md)
|
|
|
|
|
|
|
|
|
|
|
|
## Development
|
|
|
|
|
|
|
|
|
|
|
|
See [dev.md](doc/dev.md)
|
|
|
|
|
|
|
|
|
|
|
|
## Thanks and related projects
|
|
|
|
|
|
|
|
|
|
|
|
This project would not be possible without [itchyny](https://github.com/itchyny)'s
|
|
|
|
|
|
jq implementation [gojq](https://github.com/itchyny/gojq). Also want to thank
|
|
|
|
|
|
[HexFiend](https://github.com/HexFiend/HexFiend) for inspiration and ideas and [stedolan](https://github.com/stedolan)
|
|
|
|
|
|
for inventing the [jq](https://github.com/stedolan/jq) language.
|
|
|
|
|
|
|
|
|
|
|
|
Similar projects:
|
|
|
|
|
|
- https://github.com/HexFiend/HexFiend
|
|
|
|
|
|
- https://github.com/binspector/binspector
|
|
|
|
|
|
- https://kaitai.io
|
