Magma Guide - Revision history

ArneBab at 19:44, 5 December 2006

2006-12-05T19:44:37Z

←Older revision		Revision as of 19:44, 5 December 2006

-	~~=Guide to Magma-Lists=~~	+	#redirect [[Guide_to_Magma_Lists]]
-	~~==Share your file-list with your friends==~~	+
-		+
-	~~===What Magmas are===~~	+
-	~~A magma-list is in essence an easy way to share your list of most loved files with your friends.~~	+
-		+
-	That well beloved feature of iTunes, to let friends listen in to your music-library, but now in a p2p-way, and as a plus the files stay on your computer (so you can listen to the songs whenever you want...).	+
-		+
-	~~It is a list of magnet-links, which get read out and downloaded by Phex (and hopefully soon by others) automatically. ( You can get the newest beta at [http://phex.org/download.php phex.kouk.de] )~~	+
-		+
-	~~===How to create Magma-Lists===~~	+
-	To create it, simply go to the library of Phex, make sure, that it hashed all your shared files (just select a shared-folder and look in he column "hash". It has to be filled with the hash-value - to share a folder, just do a right click and click either share folder or share folder recursive).	+
-		+
-	Then click the "export"-button at the bottom of the page and select "Magma list (YAML)" as format. Click on the browse-button next to "output" and select the folder where you want to store the file. For the name, the only limitation is, that it has to end on ".magma".	+
-		+
-	Send this file to your friends, if via E-Mail, a forum attachment, an IM-file-transfer (ICQ/AIM/YIM/MSN/etc) or by putting it on your webpage, and when they double-click it (on linux: open it with Phex), Phex instantly searches for the files and downloads them.	+
-		+
-	To make sure they get it, you can check the box "include my IP". This will include your internet address in the file, which is generally a good idea, as long as you don't include files you aren't allowed to share. So be careful what you share!	+
-		+
-	~~===Further possibilities===~~	+
-		+
-	You can also make all downloadable contents of your webpage avaible with this by simply putting those files into your shared-folder, sharing only that single folder (waiting, till Phex hashed all the files, which can take anything between 20s and 1h, for really much data, several GB, even longer) and then exporting the file and putting it on your webpage.	+
-		+
-	Now people can get the files without draining all allowed traffic from your webserver. Should your server be near its quote, you could also make the files avaible via p2p-only to preserve page-viewing capabilities...	+
-		+
-	~~==Mirror downloading with Magma-Lists==~~	+
-		+
-	Magma-Lists can also be written by hand. For example you can use them to serve a file (or several files), which is/are avaible via many mirrors with phex in such a way, that phex downloads from all mirrors at once.	+
-		+
-	~~For that, the file must begin with:~~	+
-	"#~~MAGMAv0.2"~~	+
-	~~followed by an empty line (this isn't mandatory, but looks nicer).~~	+
-	~~then in any following line you need to begin the line with~~	+
-	~~"list:"~~	+
-	~~After this parameter, the list of magnets begings. Here any line must have a space in front of any content, else the list ends.~~	+
-	~~For every file, begin an object with:~~	+
-	~~" - " (space hyphen space).~~	+
-	~~After this you open a magnet inside double-quotes. :~~	+
-	~~"<magnet>"~~	+
-		+
-	~~<magnet> must be replaced by the magnet-link. To make a multi-mirror-file-download, the magnet would look something like this:~~	+
-	~~<nowiki>magnet:?dn=the+name+of+your+file&as=http://your.domain/your-file&as=http://your.mirror/your-file&as=another.mirror/another-path/your-file-by-another-name</nowiki>~~	+
-		+
-	~~The dn-parameter specifies the name of your file. here you have to replace every space by a plus-sign ("+").~~	+
-		+
-	You can set every parameter on its own line (and even cut the line wherever you want), but the next line has to begin with three spaces (those get ignored when reading the magnet, but tell the program, that the magnet goes on. )	+
-		+
-	~~Don't forget to close the magnet with a double-quote.~~	+
-		+
-	~~For the next file, you beging another object with~~	+
-	~~" - " and go on just like you did with the first.~~	+
-		+
-	~~For additional security you can put the sha1-hash of your file into the magnet. For that, put this to your magnet-link (replacing "<sha1>" with the sha1-value.~~	+
-	~~"xt=urn:sha1:<sha1>"~~	+
-		+
-	~~The magnet will the look something like this:~~	+
-	~~magnet:?xt=urn:sha1:<sha1>&dn=file-name&as=http-link~~	+
-		+
-	~~To get started, best take an~~ [~~http://draketo.de/magma/phex-update/phex_win.magma example file] and modify it to fit your needs.~~	+
-		+
-	~~==Additional Information (web and project)==~~	+
-		+
-	~~You can find some more information about Magma-Lists on~~ [~~http://gnuticles.gnufu.net/magma.html gnuticles.gnufu.net~~] ~~or at the [http://sf.net/projects/magma magma-project] at [http://sf.net sourceforge~~].	+

84.161.181.167: added nowiki for url

2006-12-05T19:29:48Z

added nowiki for url

←Older revision		Revision as of 19:29, 5 December 2006


	<magnet> must be replaced by the magnet-link. To make a multi-mirror-file-download, the magnet would look something like this:		<magnet> must be replaced by the magnet-link. To make a multi-mirror-file-download, the magnet would look something like this:
-	magnet:?dn=the+name+of+your+file&as=http://your.domain/your-file&as=http://your.mirror/your-file&as=another.mirror/another-path/your-file-by-another-name	+	<nowiki>magnet:?dn=the+name+of+your+file&as=http://your.domain/your-file&as=http://your.mirror/your-file&as=another.mirror/another-path/your-file-by-another-name</nowiki>

	The dn-parameter specifies the name of your file. here you have to replace every space by a plus-sign ("+").		The dn-parameter specifies the name of your file. here you have to replace every space by a plus-sign ("+").

ArneBab: /* How to create Magma-Lists */

2006-12-05T18:06:57Z

How to create Magma-Lists

←Older revision		Revision as of 18:06, 5 December 2006

	Send this file to your friends, if via E-Mail, a forum attachment, an IM-file-transfer (ICQ/AIM/YIM/MSN/etc) or by putting it on your webpage, and when they double-click it (on linux: open it with Phex), Phex instantly searches for the files and downloads them.		Send this file to your friends, if via E-Mail, a forum attachment, an IM-file-transfer (ICQ/AIM/YIM/MSN/etc) or by putting it on your webpage, and when they double-click it (on linux: open it with Phex), Phex instantly searches for the files and downloads them.

-	To make sure they get it, you can check the box "include my IP". This will include your address in the file, which is generally a good idea, as long as you don't include files you aren't allowed to share. So be careful what you share!	+	To make sure they get it, you can check the box "include my IP". This will include your internet address in the file, which is generally a good idea, as long as you don't include files you aren't allowed to share. So be careful what you share!

	===Further possibilities===		===Further possibilities===

ArneBab: /* How to create Magma-Lists */

2006-12-05T18:06:36Z

How to create Magma-Lists

←Older revision		Revision as of 18:06, 5 December 2006


	Send this file to your friends, if via E-Mail, a forum attachment, an IM-file-transfer (ICQ/AIM/YIM/MSN/etc) or by putting it on your webpage, and when they double-click it (on linux: open it with Phex), Phex instantly searches for the files and downloads them.		Send this file to your friends, if via E-Mail, a forum attachment, an IM-file-transfer (ICQ/AIM/YIM/MSN/etc) or by putting it on your webpage, and when they double-click it (on linux: open it with Phex), Phex instantly searches for the files and downloads them.
		+
		+	To make sure they get it, you can check the box "include my IP". This will include your address in the file, which is generally a good idea, as long as you don't include files you aren't allowed to share. So be careful what you share!

	===Further possibilities===		===Further possibilities===

ArneBab at 17:58, 5 December 2006

2006-12-05T17:58:11Z

New page

=Guide to Magma-Lists=
==Share your file-list with your friends==

===What Magmas are===
A magma-list is in essence an easy way to share your list of most loved files with your friends.

That well beloved feature of iTunes, to let friends listen in to your music-library, but now in a p2p-way, and as a plus the files stay on your computer (so you can listen to the songs whenever you want...).

It is a list of magnet-links, which get read out and downloaded by Phex (and hopefully soon by others) automatically. ( You can get the newest beta at [http://phex.org/download.php phex.kouk.de] )

===How to create Magma-Lists===
To create it, simply go to the library of Phex, make sure, that it hashed all your shared files (just select a shared-folder and look in he column "hash". It has to be filled with the hash-value - to share a folder, just do a right click and click either share folder or share folder recursive).

Then click the "export"-button at the bottom of the page and select "Magma list (YAML)" as format. Click on the browse-button next to "output" and select the folder where you want to store the file. For the name, the only limitation is, that it has to end on ".magma".

Send this file to your friends, if via E-Mail, a forum attachment, an IM-file-transfer (ICQ/AIM/YIM/MSN/etc) or by putting it on your webpage, and when they double-click it (on linux: open it with Phex), Phex instantly searches for the files and downloads them.

===Further possibilities===

You can also make all downloadable contents of your webpage avaible with this by simply putting those files into your shared-folder, sharing only that single folder (waiting, till Phex hashed all the files, which can take anything between 20s and 1h, for really much data, several GB, even longer) and then exporting the file and putting it on your webpage.

Now people can get the files without draining all allowed traffic from your webserver. Should your server be near its quote, you could also make the files avaible via p2p-only to preserve page-viewing capabilities...

==Mirror downloading with Magma-Lists==

Magma-Lists can also be written by hand. For example you can use them to serve a file (or several files), which is/are avaible via many mirrors with phex in such a way, that phex downloads from all mirrors at once.

For that, the file must begin with:
"#MAGMAv0.2"
followed by an empty line (this isn't mandatory, but looks nicer).
then in any following line you need to begin the line with
"list:"
After this parameter, the list of magnets begings. Here any line must have a space in front of any content, else the list ends.
For every file, begin an object with:
" - " (space hyphen space).
After this you open a magnet inside double-quotes. :
"<magnet>"

<magnet> must be replaced by the magnet-link. To make a multi-mirror-file-download, the magnet would look something like this:
magnet:?dn=the+name+of+your+file&as=http://your.domain/your-file&as=http://your.mirror/your-file&as=another.mirror/another-path/your-file-by-another-name

The dn-parameter specifies the name of your file. here you have to replace every space by a plus-sign ("+").

You can set every parameter on its own line (and even cut the line wherever you want), but the next line has to begin with three spaces (those get ignored when reading the magnet, but tell the program, that the magnet goes on. )

Don't forget to close the magnet with a double-quote.

For the next file, you beging another object with
" - " and go on just like you did with the first.

For additional security you can put the sha1-hash of your file into the magnet. For that, put this to your magnet-link (replacing "<sha1>" with the sha1-value.
"xt=urn:sha1:<sha1>"

The magnet will the look something like this:
magnet:?xt=urn:sha1:<sha1>&dn=file-name&as=http-link

To get started, best take an [http://draketo.de/magma/phex-update/phex_win.magma example file] and modify it to fit your needs.

==Additional Information (web and project)==

You can find some more information about Magma-Lists on [http://gnuticles.gnufu.net/magma.html gnuticles.gnufu.net] or at the [http://sf.net/projects/magma magma-project] at [http://sf.net sourceforge].