Manual: BeSweet Commandline Reference

[Brother John]

Hi @all.

We all know that BeSweet's documentation is not what everyone would like it to be. Especially a complete single volume reference of all switches and their meaning is missing. This is my attempt at writing such a reference.
From the PDF's introduction
This document contains an overview of all of BeSweet's commandline parameters and their interaction. It is a translation of the German "BeSweet-Kommandozeilenreferenz", which I started because of the lack of good German documentation for BeSweet. But even in English there is no single document summarising BeSweet's abilities. That is why I decided to do a translation.
Recent version available here: http://brother-john.net/besweet-reference.html.

Of course any comments are welcome. I'd really be surprised if there wasn't room for improvement.

Disclaimer *g*: My native language is not English and this is my first serious translation task. You definitely WILL find some weird language. When you do, tell me! I guess ROFL about my funny use of the English language is useful to save a grey and rainy day but that's not really the point of the document ... well, at least not the whole point. ;)

Note to German speaking users:
Die deutsche Version gibt es in diesem Thread auf dem Doom9/Gleitz-Board: Handbuch: BeSweet-Kommandozeilenreferenz (http://forum.gleitz.info/showthread.php?t=19670).

[Kurtnoise]

Very good job Brother John...;)


I just noticed a little missing :
-logfilea <Logdatei>

By the way, it will be very useful for BeSweet beginners I think.

[yaz]

vouw ... great worx ... thx a lot !!! but why pdf ? ;)
y

[DSPguru]

Impressive work :o
By a brief look, I found a small errata in page 8 - "if the source file" should obviously be replaced with "if the destination file".
Also, even though "--resample 44.1" (hardwiredly) works, BeSweet's Lame's resample switch should be feeded with "hz" values.

And may i suggest adding a link to BeSweet's FAQ thread ? useful information about channel orderings can be found there.

Cheers,
Dg.

[magicclue]

typo page 15,

channel remapping example:

ol,c,r,sl,sr,lfe

[daphy]

fine work, THX :D

[ursamtl]

Tremendous work! As for the translation, I'm a technical writer by profession and it looks fine to me. Well done!

Steve.

[Brother John]

Thanks for the feedback so far. A corrected version is online (link in the first post). I added a link to the BeSweet FAQ. Good idea, DSPguru.

@yaz
Some prefer PDF, some prefer HTML, some prefer latex source code ...
I had to chose one and was in the mood for PDF this time.

@ursamtl
Good to hear that. Thanks.

Oh, and - though it's almost over - happy Easter!

[daphy]

@ursamtl
what about a french translation of this guide ;)

@Brother John
would like to share these guides on needfulthings - hope this okay!

[Brother John]

Originally posted by daphy
@Brother John
would like to share these guides on needfulthings - hope this okay!
Sure. Go ahead!
When they're up, I'll add a link in the first post.

[daphy]

done :D

[ursamtl]

Originally posted by daphy
@ursamtl
what about a french translation of this guide ;)


I'd be happy to help out. It's gonna take a little time, however, since I'm in the middle of moving my residence over the next two months.

[Brother John]

I second a French translation. That would be really great.

@ursamtl
Look again, it's there: "32 bit floating point waves without a size limit."

Maybe the line got moved to page 4? Though fonts are embedded, so this should not happen.

[ursamtl]

Yes, I missed the bit about 32-bit files on first reading. I'm already working on the French translation.

[bond]

cool stuff, thx Brother John :)

[Brother John]

Originally posted by ursamtl
I'm already working on the French translation. That's great news!
Would it be any help for you to have the OpenOffice document? I temporarily put it up here: http://home.arcor.de/brotherjohn_zeug/bs_clref_sxw.zip.


Sectie.B just pointed out another typo via PM. Page 3, chapter 3.1 "The -core() Section". Right at the beginning in the syntax overview. "-playload" should of course read "-payload".

I won't upload a new version just because of that. Let's wait a little, if more errors pop up.

[KpeX]

I put an open-office converted HTML version up here (http://dhost.info/kpex/guides/bs_clref_html.html) and a link to this thread in the besweet FAQ. Nice work brother john :).

[spyrus]

My bat file i am using is this:
BeSweet.exe -core( -input 714.wav -output 714.mp3 -wavmp3 -logfile 714.log ) -lame( -b 224 )

I have the log file here:

BeSweet v1.5b29 by DSPguru.
--------------------------
Using lame_enc.dll v1.32 (8/8/2003), Engine 3.90 <http://www.mp3dev.org/>.

Logging start : 06/22/05 , 21:10:39.

BeSweet.exe -core( -input 714.wav -output 714.mp3 -wavmp3 -logfile 714.log ) -lame( -b 224 )

[00:00:00:000] +------- BeSweet -----
[00:00:00:000] | Input : 714.wav
[00:00:00:000] | Output: 714.mp3
[00:00:00:000] | RIFF header will be added
[00:00:00:000] | Floating-Point Process: Yes
[00:00:00:000] | Source Sample-Rate: 44.1KHz
[00:00:00:000] +-------- LAME -------
[00:00:00:000] | Bitrate method : CBR
[00:00:00:000] | MP3 bitrate : 224
[00:00:00:000] | Channels Mode : Joint Stereo
[00:00:00:000] | Error Protection: No
[00:00:00:000] +---------------------
[00:21:52:279] Conversion Completed !
[00:21:52:279] Actual Avg. Bitrate : 223kbps
[00:01:06:000] <-- Transcoding Duration

Logging ends : 06/22/05 , 21:11:45.

Is there a switch that i can use in order to have error correction?
There is no comment for that on your pdf :rolleyes:

By the way i am using virtual dub mod to extract wav out of an mpeg file...

Thx in advance,Spyrus

[Brother John]

You can enable error protection with the -p switch:
-lame( -b 224 -p )
However I remember someone (could have been Gabriel Bouvigne himself) stating that error protection is pretty useless. I forgot his arguments, though.

[tebasuna51]

In Lame.html, subfolder Help of BeSweet:

" -p error protection
Turn on CRC error protection.
It will add a cyclic redundancy check (CRC) code in each frame, allowing to detect transmission errors that could occur on the MP3 stream. However, it takes 16 bits per frame that would otherwise be used for encoding, and then will slightly reduce the sound quality. "

[Brother John]

New version. Some minor changes and a new LAME chapter, that now has a section for older lames (using --preset) and one for Lame 3.97+ and its new syntax.

I guess a description of dimzon's plugins couldn't hurt, but I'm too lazy to do it atm.

[jordisound]

Thank you very much Brother John for this. I was in darkness but now I'm feeling the daylight is coming.

If you want, you can help me with this (http://forum.doom9.org/showthread.php?t=109264)

[Brother John]

It’s been a long time, but finally here’s an update to the reference. Hope you like it.

Changes:
New interactive layout. Added lots of bsn.dll stuff: Nero CLI, Aften, Flake, Winamp. Removed old Nero encoder section.

Newest version always available on my website:
English: http://brother-john.net/besweet-reference.html
German: http://brother-john.net/besweet-referenz.html

[F u r u y á]

omg very good...I'm feeling like jordisound.

The pdf looks very professional... I loved the links inside the pdf. Thank you very much.