DVBACKUP(1)

πŸ’Ύ DVBACKUP β€” the manual, but make it cute πŸ’Ύ

okay bestie, gather round, because this is the DVBACKUP(1) page from the General Commands Manual and it is so much more unhinged than it has any right to be. no cap. 🫢


✨ NAME ✨

dvbackup β€” converter from arbitrary data to a DV stream. that's the whole vibe. your random files go in, a DV stream comes out. πŸ¦‹


🌸 SYNOPSIS 🌸

dvbackup [--version]  [-n|--ntsc-mode]  [-d|--decode]  [-t|--verify]
[-b|--set-backup-title=TITLE]  [--set-picture=PPM-FILE]  [-v|--verbose]
[-p|--prefix=COUNT]  [--test=COUNT]  [-r|--recover]  [--enable-audio]
[-?|--help]  [--usage]

and here's every single flag, laid out like a lil friendship bracelet so nothing gets lost πŸ’– (heads up: the page itself doesn't spell out what each one does beyond its name, so i'm not gonna invent lore that isn't there):

  • --version β€” version, babe πŸŽ€
  • -n, --ntsc-mode β€” ntsc mode ✨
  • -d, --decode β€” decode 🌸
  • -t, --verify β€” verify πŸ”
  • -b, --set-backup-title=TITLE β€” set the backup title, and it takes a TITLE πŸ’œ
  • --set-picture=PPM-FILE β€” set the picture, and it wants a PPM-FILE πŸ–ΌοΈ
  • -v, --verbose β€” verbose, she talks a lot πŸ’…
  • -p, --prefix=COUNT β€” prefix, takes a COUNT ⭐
  • --test=COUNT β€” test, also takes a COUNT 🧚
  • -r, --recover β€” recover 🫢
  • --enable-audio β€” enable audio πŸ”Š
  • -?, --help β€” help 😭
  • --usage β€” usage 🌈

🌈 DESCRIPTION 🌈

so this manual page documents the dvbackup tool briefly. that's the official energy. ✨

this manual page was written for the Debian distribution because the original program does not have a manual page. so like, we're the manual now. iconic of us honestly. πŸ’…

as you probably know, current digital camcorders can save approximately 13 GB of data on those tiny DV cartridges at a speed of 3.6 MB/second. that's fast. very fast. it's faster than most DAT streamers which only work at 1 MB/sec or less. we can not use all of the data, but 10 GB should be good enough for everyone. πŸ’€

that's nice, but how can we use this to save data on it? and here comes the fun part: if you read the DV documentation carefully, you will notice that the AC DCT coefficients of the video data blocks (8x8 pixels in size) get a fixed amount of space in the DV data stream, but can be terminated earlier with a certain code sequence. so let's have some fun: we terminate the AC coefficients immediately leaving only the DC coefficient for a fancy penguin picture 🐧 and use the rest for our backup data. future implementations could easily add a little picture showing the currently written file or something like that. ate. πŸ”₯

then there is the audio data, which is written uncompressed onto the tape. that means: we tell the camcorder at the beginning of each frame, that we won't use audio at all but fill the space reserved for it with data. easy, but somewhat hacky. in fact, i don't know, if this works on every camcorder and not only on mine (a Sony VX700). your mileage may vary. πŸ™ˆ

to finally bring the data on tape, you have to use an additional utility, called dvconnect, which is (hopefully soon) included into libdv. take a look at the patch manager if it's not in already. and then it's time to rock and roll: 🎸


πŸ‘‘ Advantages of dvbackup over other backup technologies πŸ‘‘

  • relatively cheap (the cheapest camcorder will be enough, but if you have already one...)
  • the tapes are quite cheap
  • open standard: if your streamer, aah camcorder dies you can rescue your data with any other one (except PAL/NTSC need to fit), you are not bound to a special company
  • it's faster than many streamers and it will be more comfortable β€” you can use the search-index function to "jump" to a recording
  • tapes (re)wind faster than many streamers
  • you do not need to rewind the tape to eject it

πŸ’€ Disadvantages of dvbackup πŸ’€

  • you do not get any warranty :-)

πŸŽ€ Usage of the Unix client πŸŽ€

  1. press record on your camcorder. (or use your favorite avc control program for this. for the VX700 this doesn't work and you have to hack something together, that uses LANC. i might publish my "solution" for this soon...) 😭
  2. type find . |cpio -o -H crc |dvbackup --prefix=125 |dvconnect -s to stream directly to your camcorder. this most likely does only work on very fast harddisks and filesystems. you might try something like find . |cpio -o -H crc |dvbackup --prefix=125 |dvconnect -s -b 500. alternatively, you can write the data in several parts on tape. just go experimenting, and mail me the resulting backup scripts... πŸ§ͺ
  3. stop your camcorder and rewind. βͺ
  4. now it's time to verify: press play on tape ;-) ▢️
  5. type dvconnect |dvbackup -t and watch for crc errors. the data corruption bug mentioned for version 0.0.1 seems to be fixed so there is no excuse in not using this little nifty program ;-) βœ…
  6. if you want to restore: do a simple dvconnect |dvbackup -d|cpio -imV. CPIO will also happily tell you about CRC errors. so you might want to check using cpio's archive test mode too. but keep in mind, that cpio's CRC function is not that fast! 🐒
ngl the "press record on your camcorder" step is doing so much heavy lifting here and i respect it deeply.

πŸ’œ AUTHOR πŸ’œ

this manual page was written by Robert Jordens jordens@debian.org for the Debian system (but may be used by others). permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2. on Debian systems, the full text of this license can be found in the file /usr/share/common-licenses/GPL-2. 🫢


and that's the whole thing, bestie β€” you just read the entire DVBACKUP(1) page, straight outta the General Commands Manual, and yeah, the footer is literally just DVBACKUP(1) again because the page said its own name twice and honestly? main character energy. go back up and go make some penguin-flavored backups. periodt. πŸ’…βœ¨