yEnc FAQ

alt.binaries.sounds.music.classical

january 31 2002 (updated May 26 2002)

Back to absmc home page 

Introduction to downloading and uploading binaries with the new, fast encoding convention "yEncoding"

Contents

1
What is yEnc?
2
How can I download yEncoded files?
3
Which newsreaders support yEnc (12 February 2002)
4
Does Agent handle yEnc?
5
What if my newsreader does not support yEnc?
6
My Newsreader supports yEnc, but nothing is dowloaded
7
How do I get and install yDec?
8
How do I use yDec to decode yEncoded files manually?
9
Can I use drag and drop with yDec?
10
Is there no smarter way to use yDec?
11
Can I post using yEnc?
12
Why are yEnc file headersnot not joined in Agent?
13
Where can I find more information on yDec and yEnc?

1. What is yEnc

You are a mp3 downloader. You download mp3's from a binary newsgroup, like alt.binaries.sounds.music.classical, and they appear on your hard disc as mp3 files. Perfect: good quality, small files, flexibility, fine.

So, why the hell are people just now changing to a new type of music, called "yEnc" or "yEncoding"? Good question. The answer is: they are nót. Mp3 stays mp3. What then is yEnc?? yEnc is an efficient way of transmitting any type of binary file over newsnet, whether it is mp3, mpg, exe, wav or whatever. Mp3 stays mp3, but with yEnc it's transmitted 40% faster!

If this puzzles or amazes you, this might help: Probably you are not aware that you are downloading UUE files instead of mp3 files.Your favourite newsreader automatically decodes the UUE file, actually a text file, into a mp3 binary. With yEnc, it's exactly the same. You are unaware of the fact that you are downloading yEnc files but who cares, your favourite newsreader translates it automatically into mp3!

The difference between UUE and yEnc? To put it simple: UUE uses only 7 bits in a Byte for the encoding, and yEnc uses 8 bits. Brilliant, but why are we so stupid late with this good idea? That's because the old "internet-wiring" transmitted only 7 of the 8 bits in a Byte as information. Recently the "internet-wiring" has been upgraded to 8-bit information compatibility.

A few more words to make you comfortable: there is no copyright for the yEncoding - it is completely released into public domain. No Microsoft torpedo. Credits go to Jürgen Helbing: he does a great job in creating yEnc and making it available to everyone and on every platform.


2. How can I download yEncoded files?

Files that are encoded with yEnc instead of UUE can be downloaded with any binary newsreader. The problem is that these newsreaders are not able to decode yEnc into the final binary output form, i.e. mp3. To be able to decode yEnc, these newsreaders must be updated with a little module that will decode yEnc into binary, just as there is a little module that decodes UUE into binary. Lucky for us, many newsreaders have been updated recently to handle yEnc. Among these is the popular and free XNews newsreader, but many others as well.

Is your newsreader updated? Check at http://www.yenc.org/yenc/tools.htm. They maintain a list of links to updated newsreaders. You should fetch the new patch and install it over your old copy.

If your newsreader is updated, you are a lucky guy, because from now on things go automatically. You won't even see the difference between yEnc-encoded files and UUE-encoded files. At this moment, most posters will add "yEnc" somewhere in the message header. But in a year time, when yEnc is accepted, this custom will most likely disappear.


3. Which newsreaders support yEnc (12 February 2002)

Apple Computers

Linux Computers

Windows Computers

Providers with web interfaces for usenet

Recent list

A more up to date list can be found here: http://www.yenc.org/yenc/tools.htm.


4. Does Agent handle yEnc?

Yes, the newest version (1.91) does. You can download it here: <http://www.forteinc.com/agent/download.php>.


5. What if my newsreader does not support yEnc?

Some popular newsreaders, like Agent, have not yet been updated and are not able to decode yEnc automatically. No problem, you can still download the yEnc files, save them as text files, and decode them manually. There is a small decoding utility, called "yDec". This program is for windows. Utilities also exist for other platforms. Again, check http://www.yenc.org/yenc/index.htm, since new programs appear almost daily at the moment.

Of course, it is not appealing to start doing things manually that were done automatically before. Stop! It's far easier than you think. Below I'll take you step by step to this procedure. And don't forget: downloading the same mp3 file becomes 40% faster!

Recently, a new front end for decoding and encoding has been released, Yenc32. I didn't try it yet. You can find it here: http://www.yenc32.com/download.php.

So you need yDec. This is how:


6. My newsreader supports yEnc, but nothing is downloaded

yEnc is still evolving. This might cause problems. For instance, files that are posted with the newest version of XNews (version 5.x) use yEnc v1.3. These files are not correctly handled by the older version of XNews (version 4.12.x). If you have problems downloading yEnc encoded files, download the latest software. Check the XNews site.


7. How do I get and install yDec?

yDec is a utility to manually decode yEnc files. You need this utility if your newsreader does not automatically decode yEnc files.

  1. Download the yDec.zip (http://www.easynews.com/yenc/ydec.htm)
  2. Extract the yDec.exe to any working directory. (Example: c:\ydec, d:\Program files\Ydec)

8. How do I use yDec to decode yEncoded files manually?

First step is to retrieve the messages with your newsreader and save them to your hard disc. The saving of messages can be done in ONE BIG textfile (thanks to MOL). Joint or split segments? that does not matter. The split segments can be in any order; yDec will sort them. In fact, you may save all (and I mean *all*) yenc messages together in one big file, and decode it to get all the mp3s, regardless whether they are for the same work, from the same poster, or whatever, as long as they are complete. Step by step ...

  1. Retrieve all the messages you want without saving the bodies. The messages can have split or joint segments, that does not make any difference. Nor does the message order make any difference
  2. Block all headers for the pieces you 've downloaded
  3. Go to (Agent) File | Save messages as... In other newsreaders this will work essentially the same
  4. Make sure (Agent again) the following options are checked - left side b. UNIX message file -- right side a. Save raw (unformatted) message
  5. Save them to one single(!) file. Give this file the extension ".ync", for instance "file.ync". The reason why this extension is used, will be explained later. The name of the file does not matter, since yDec will reassemble the original file names from the saved message.

Your newsreader did not decode the messages. You only saved the unencoded yEnc file. This file you saved with the "ync" extension. Now, it's time to use yDec for decoding the saved file. Here is a straightforward way to use yDec. This is described it at www.yenc.org. However, there is a smarter way to use yDec, and this will be described later (8).

  1. Open a command-line window (or DOS-Window)
  2. Change to the temporary directory: (Example: cd c:\ydec)
  3. Start the decoder: ydec file.ync
  4. You can also store ten messages (msg1.ync, msg2.ync, ... msg10.ync) and use a wildcard as parameter: ydec *.ync
  5. yDec writes the extracted files into the same directory
  6. Remove the stored message-files (Or keep them as backup)
  7. Store the decoded binaries to another directory.

9. Can I use drag and drop with yDec?

Yes, yDec can also be used with 'Drag and Drop' on Windows: You can simply click ONE stored message file and drag it to the yEnc.exe. You can also create a shortcut for yDec on your desktop and drag a message file to that icon. The decoded binaries will still be stored at the location where the message file comes from! Dont try to drag multiple messages to yDec. It does not work.


10. Is there no smarter way to use yDec?

Yes there is, and I will describe it now. Initially, this requires some extra work. Eventually, it makes life very very easy.

The first step is to create a "file type association" (with thanks to BillyBob). This has to be done only once!

  1. Open the Windows Explorer
  2. Select (Win2000 Tools) Folder Options | File Types, or (Win98) View | Map Options | File Types select "New" or "Create New"
  3. In the description entry put "yDecoder"
  4. In the extension entry put ".ync" (the official yEnc suffix)
  5. Keep the Mime type entry clear
  6. In Windows 2000: in the program box or browse to the directory you created for the attached file (good idea to make it read only) and select the "ydec.exe" file. (I'm not sure whether you should provide arguments like in Windows '98 below; try out)
  7. In Windows 98 and older: in the Action window click "new". In the action entry, type "open". In the program entry, browse to the directory you created for the attached file and select the "ydec.exe" file. Add the argument "%1". Be careful that a file name cannot be more than 8+3 characters long. This means you should enter
              D:\Progra~1\yDec\ydec.exe "%1"
    instead of
              D:\Program Files\yDec\ydec.exe "%1"
  8. Click "OK" and "Close" untill all explorer windows are closed.

The second step is to retrieve and save the messages. This is already described in (6) above.

The third step is to decode the messages.

  1. Once saved, go to the directory to which the file was saved and double click it. All mp3 files contained in this "ync" file will be decoded at the same time
  2. Close the DOS box by clicking on the dialog box opened by ydec.exe being opened


11. Can I post using yEnc?

Yes of course. No little chickens without the rooster. You will need a newsreader/newsposter that is updated to handle yEnc. Check out http://www.yenc.org/yenc/index.htm to see whether your newsposter supports yEnc.

A very popular binary news poster is PowerPost. Unfortunately this excellent and free program has not yet been updated ;(. The guy who created PowerPost has been so kind to make the source available. A few patches have been posted around since. One of these patches, one that proved to be stable up till now, can be downloaded from this site, but I'm not responsible for it!

Download the PowerPost Yenc patch here: PostMost. Unzip it in the working directory. It will automatically encode your binaries into yEnc. Post with maximum 3000-4000 lines per segment, since some servers seem to have problems with larger yEnc segments.

WARNING: this version of PowerPost automatically inserts the word "yEnc" in the subject line. The position of the word "yEnc", after the filename "$F", causes much displeasure with Agent users: it deters Agent from automatically joining segment headers into one file header. Therefore, you must change the Subject Header Template and move the word "yEnc" before the filename "$F":

Wrong: Rossini - La gazza ladra [$1/$2] - "$F" [yEnc]
Right: Rossini - La gazza ladra [yEnc] [$1/$2] - "$F"

Suggestion: if you post a .nfo file - a good idea btw - then this file will also be encoded with yEnc. As a kind of a service to downloaders who have to decode the yEnc manually, copy the contents of the .nfo file in the 0/n part of the first file of the post.


12. Why are yEnc file headers not not joined in Agent?

Newsreaders usually automatically join all the segments belonging to one binary. In Agent, you will see this message:

   40165 Rossini - La gazza ladra [yEnc] [05/63] 1_05 - Là seduto l'amato Giannetto.mp3 (*/8)

which means: a binary file consisting of 8 segments, totalling 40165 lines of code. However, if you are unlucky and a poster puts some text behind the filename, Agent will show the individual segments (note that the difference between the text below and the text above is the position of the text "[yEnc]"):

    5075 Rossini - La gazza ladra [05/63] 1_05 - Là seduto l'amato Giannetto.mp3 [yEnc] (1/8)
    5075 Rossini - La gazza ladra [05/63] 1_05 - Là seduto l'amato Giannetto.mp3 [yEnc] (2/8)
    ...............................
    ...............................
    4639 Rossini - La gazza ladra [05/63] 1_05 - Là seduto l'amato Giannetto.mp3 [yEnc] (8/8)

You can in fact ignore this: whether you download joint or split segments, decoding them is the same (see questions 6 - 8 above). Also, this bahavior is NOT a consequence of using yEnc, it's the behavior of Agent when there are characters or spaces after the filename.

If this behavior of Agent annoys you, what can you do to avoid it?

  1. Posters should avoid placing any characters after the filename. When you use PowerPost for posting, you should not add any text after the "$F" (see also question 10 above).
  2. Agent users can add (or change) a switch in the Agent.ini file:

    [Attachment]
    RequireFilenameWithTag=0


13. Where can I find more information on yDec and yEnc?

More info on the use of the yDec utility can be found here: http://www.easynews.com/yenc/ydec.htm. And of course, for more information on yEnc, go to http://www.yenc.org/yenc/index.htm. Here you will find a lot more practical things for using yEnc. This page is updated frequently.

 

Hosted by www.Geocities.ws

1