How to Setup

This tutorial assumes you understand the basic concepts of IRC and that mIRC is already up and running, and that you're even likely connected to Slacknet IRC Network right now. There are a few things that you must do in order to get this working properly so that you can download from others and that they can download from you.

Table of Contents

1. Setup port forwarding
2. Setup mIRC DCC Settings
3. Load the script
4. Using the script

Setup port forwarding

Most people today have DSL or Cable for their Internet access, and with that most have a router that helps share the connection between multiple computers on their network. If your computer is directly connected to your DSL or Cable modem/transceiver without a box in between, you can likely skip this step. If you still have a problem, come back to this step anyway.

This part of the tutorial assumes you know absolutely nothing at all about networking, except that it connects computers and you need it to get online.

There are countless routers out there that you could have, so a generic tutorial won't work. If you have a Linksys router for example, I suggest googling: linksys router port forwarding and using what you find in conjunction with this tutorial.

Here are the basic, generic steps (note these may not fit your router, but it's worth a shot):

1. Click your Start menu, select Run, and type cmd
2. A black box will appear, in it type ipconfig /all
3. Depending on your computer, you may have a single area in the readout that says "Local Area Connection", or if you've got a laptop with Windows Vista or Windows 7, you've likely got about 20,000 of these.
   1.  If you have Windows 2000 or XP, you're looking for IP Address, make note of the number, which will be something like 192.168.x.x, 10.x.x.x, 172.16.x.x, if it's anything different, you might not need to continue and you should ask in #music or #tuneman for help.
   2. If you have Windows Vista or 7, you're looking for IPv4 Address, make note of the number, which will be something like 192.168.x.x, 10.x.x.x, 172.16.x.x, if it's anything different, you might not need to continue and you should ask in #music or #tuneman for help.
   3. Also make note of the Default Gateway, as you will need this number to configure your router. For the sake of example we'll assume your default gateway is 192.168.0.1, this is probably not your gateway, so don't get confused, it's just an example.
4. Open your favourite web browser and navigate to http://192.168.0.1/ the example default gateway.
5. You're likely to encounter a login screen, if you don't know the username and password, it's likely one of the following:
   

   Note: <blank> means you type nothing, don't literally put "<blank>"

   Username: admin
   Password: password

   Username: admin
   Password: admin

   Username: <blank>
   Password: password

   Username: <blank>
   Password: admin

   Username: admin
   Password: <blank>

   If none of these worked, ask your mom, dad, roommate, sister, brother, girlfriend (yeah, right), boyfriend, grandparent, guardian, caseworker, lawyer, network administrator, religious leader, etc. We don't know your password.

6. Follow the instructions when you googled on how to forward ports. For the sake of example in this tutorial, I'll assume that you want to forward the ports 4190 to 4200 to your IP Address, which for example is 192.168.0.150
7. [Insert specific router instructions here]
8. Navigate to http://slacknet.org/music/whatismyip/ 
9. The IP address listed there is your external IP address, make note of it, you'll need it later.
10. Now that you've gotten the ports forwarded on your router, it's time to make sure mIRC is setup decently.

Setup mIRC DCC Settings

This can be fairly straight forward if you follow my instructions exactly!

1. We need to first figure out your sounds directly, that is, where your mp3s and such go when you get them sent to you on IRC. You can do this by typing /run . in mIRC, don't forget the period there.
2. The directory that opens is the directly where mIRC's stuff is stored, double click the sounds directory.
3. You can make a short cut to this directory on your desktop or whatever, it's where your music will go.
4. Yes, you can change the sounds folder, but we won't get into that here, that's a whole different can of worms - just google it.

Now that we've got that out of the way, let's setup DCC to work with the ports that you selected on your router.

1. From the Tools menu select Options...
   
2. In the mIRC Options dialog, under Connect, select Options, then click the Advanced... button.
   
3. In the Advanced dialog, make it look like this (assuming your ports are 4190 to 4200 and you don't have any special network requirements).
   
4. Press OK to close out of that dialog once you're done.
5. Again under Connect, select Local Info:
   
6. If IP Address in this window matches the IP address from http://slacknet.org/music/whatismyip/ then you don't need to do anything here. If it doesn't, do the follow:
   1. Uncheck "Local Host" and also "IP Address"
   2. Put the IP Address you got from http://slacknet.org/music/whatismyip/ in both the IP Address and Local Host boxes.
7. Click OK to save your information.
8. Continue below.

Load the script

Now that you've got your network settings working, god willing, you can now load the script. Follow these instructions:

1. In mIRC type /run . to open the mIRC directory, this is where you'll put the script.
2. Download the latest version of the script at http://slacknet.org/music/ 
3. Using your favourite zip archiving program, like Winrar, Winzip (garbage), or something similar, open the zip.
4. Drag and drop the tuneman-v*.mrc file into the mIRC directory
5. When in mIRC, type /load -rs tuneman-v*.mrc - do not put the * there, that's for the version of TuneMan you downloaded, simply replace it with the file name you extracted.
6. When you run it you will see:
   
7. Click Yes.
8. It will start to load and ask you to select the directory to where your current audio collection is, this is not the directory where things will download to - we already discussed that. These are mp3s that will be shared with other users, it will only load mp3s, not other file types:
   
9. It might take a moment to load your mp3 list, especially if you have a lot, so be prepared to wait a moment. After it loads, you can then began using TuneMan.

Using the script

Congratulations, you've made it this far, here's how you can join in on the fun:

1. If you're not on Slacknet IRC Network, type: /server irc.slacknet.org -j #music
2. If you are, and you haven't joined #music, type /join #music now, as you must be on that channel.
3. You can right click on any window, that is Status, Channel, or Message and click Show TuneMan, it will bring up the search and play dialog.
4. You can search by typing in a query related to audio you're interested in listening to:
   
5. For the sake of bandwidth and not annoying your peers, only download something you actually want.
6. When you find something you want to download, simply double click it. Depending on your DCC connections you may be asked to confirm your download, or it may start automagically.
7. Assuming that you just installed mIRC and haven't changed any settings other than the ones in this tutorial, you may see a dialog like this:
   
8. Assuming you just selected something and this window didn't pop up out of no where, click OK.
9. A box will pop up confirming the location and file, be sure the file name matches the one you wanted to download:
   
10. Click accept, when your download is complete you'll have the option to open the directory it downloaded to, then you can enjoy your audio.

Really though, when it comes to learning anything, it comes from experience, so mess around with the software and see how it works for you. Be sure to offer suggestions in #music, and if you need help or have bugs to report join #tuneman.