174

Is there a neat way I can view binary files as hex in Vim, and save it back to binary from the hex?

Peter Mortensen
  • 194
  • 6
nos
  • 1,893
  • 2
  • 13
  • 7

2 Answers2

251

You can use the xxd command to transform a file in Vim to hex representation, doing

:%!xxd

: enters command-line mode, % matches whole file as a range, ! filters that range through an external command, xxd is that external shell command

Giving an output like this, this is split into octet count/line (octets per line may be changed with parameter -c on xxd command), hex representation, and text representation:

0000000: 5468 6973 2069 7320 6120 7465 7374 0a41  This is a test.A
0000010: 6e6f 7468 6572 206c 696e 650a 416e 6420  nother line.And 
0000020: 7965 7420 616e 6f74 6865 720a            yet another.

Once you make the changes (in the hex part), you can go back to text with -r command on xxd, so

:%!xxd -r

This is a little rudimentary, though I like it in its simplicity and to keep in mind xxd, which is an interesting command line tool (I don't have to do a lot of work on hex, though). You can use some recipes to handle this transformation in a more automatic way like the one described in Improved hex editing.

And rembember you can also use syntax highlighting for hex editing in vim with that command:

:set ft=xxd
Cpp Forever
  • 103
  • 3
Khelben
  • 3,187
  • 2
  • 14
  • 12
  • 4
    I think it worths mentioning that after you make the changes you must go back to the normal mode before saving the changes. – kaptan Jul 26 '18 at 20:52
  • 1
    Is it possible to specify the byte order? big-endian or little-endian – C-- Apr 30 '19 at 09:23
  • BTW. Where is :h for :%!? I could find only for :!. Using nvim. – Artyom May 18 '20 at 07:55
  • 2
    Info: After changing a hex code in the middle of a file and finally comparing it with "Beyond Compare" I found out that vim added 0A to the end of the file. So it now has a different size (+ 1 Byte). I think a hex editor should not do such things. I used truncate --size=-1 to correct this. – mgutt Oct 16 '20 at 21:59
  • Is there a plugin or other way that shows the connection between the bytes in hex format and decoded to ASCII? For example, when the cursor is at byte 54 it would highlight the T. Similar to how hexedit does it. Edit: this plugin should do it. – Matthias Braun Dec 16 '20 at 20:27
  • @SubinSebastian yes, just look at the -e and -g options of the xxd manual http://man.he.net/?topic=xxd§ion=all – Maarten Derickx Sep 27 '21 at 11:27
  • As this thread was higher in the google search results (compared to the other duplicate thread it suggest), thought I'd highlight something from that other thread, that it's worth performing :set binary prior to doing :%!xdd, to assure (at least in windows) that things like EOL chars aren't altered. E.g. for me, it was switching every 0x0a into 0x0d 0x0a unless I did the :set binary step first.

    Also worth noting that to make it display the more common (to me) byte-fields, do %!xdd -g 1

     – Gurce Oct 30 '22 at 08:27
30

Taken from :h hex-editing:

If one has a particular extension that one uses for binary files (such as exe,
bin, etc), you may find it helpful to automate the process with the following
bit of autocmds for your <.vimrc>.  Change that "*.bin" to whatever
comma-separated list of extension(s) you find yourself wanting to edit:

" vim -b : edit binary using xxd-format!
augroup Binary
  au!
  au BufReadPre  *.bin let &bin=1
  au BufReadPost *.bin if &bin | %!xxd
  au BufReadPost *.bin set ft=xxd | endif
  au BufWritePre *.bin if &bin | %!xxd -r
  au BufWritePre *.bin endif
  au BufWritePost *.bin if &bin | %!xxd
  au BufWritePost *.bin set nomod | endif
augroup END

You may want to look at: How do I navigate to topics in Vim's documentation?

Community
  • 1
Peter Rincker
  • 15,854
  • 1
  • 36
  • 45