|
|
|
|
|
|
||
| Home | Soulseek Links | Nicotine | Museek | Code | Graphics & Others | ||||||||
| Nicotine Plus | Nicotine+ Wiki / Trac | Nicotine Links | Nicotine Guide | Nicotine Propaganda | Nicotine Icons |
|
This is a User Interface guide for Nicotine, a PyGTK2 Soulseek peer to peer client. For Info on technical problems or installation, check out the Nicotine Faq NOTE: This guide has tips that will only work on version 1.0.8rc1 or later
Startup:
The first time you run Nicotine, the settings dialog will appear and you should enter the following:
Under Connection » Server:
A username.
A password.
Under Connection » Shares:
The download directory.
One or more shared directories.
Press OK Now, your shares will automatically be scanned (you can tell if the message Rescanning Started shows up in the status bar or the log window). When Rescanning is finished, Nicotine will attempt to connect to Soulseek. If all goes well, you will be connected to the soulseek server and automatically join the nicotine chat room. Getting Around:
The tabs at the top of the window are self explanatory, but here they are:
Chat rooms, Private chat, Downloads, Uploads, Search files, User info, User browse, Interests and User list. You can jump between them by clicking (no, really!) or hitting a Alt-Number combo, such as Alt-1. Chatrooms:
On the right side of each chatroom is the users-in-room-list, and past that is the roomlist (which can be hidden).
 Right-clicking on a username in the user list will provide you with a popup menu, but if you are
using a Mac, you'll be forced to use one of the delightful mouse and keyboard combos to bring it up. ⌘ (Apple) + mouse click :) Alt-Left arrow & Alt-Right arrow will move you from chat room to chatroom. Chatting commands such as /me, /browse and /search can be found in Help->About chat room commands. You can even make shell scripts paste text into the chat room and run external process with the /alias function. Status Icons:
For every user in the users-in-room-list and buddy-list there is an icon showing their online status.
 Online Away OfflineRoomlist:
You can join rooms by double clicking on them in the roomlist or by using the right click menu.
⌘ + mouse click for OSXers. User-Popup Menu:
Send Message will start a private chat with the chosen user (you will have to click on private chat manually)
Show IP address will print the ip address and port the user is connected to Soulseek with into the log window. Optionally, if you have the GeoIP bindings installed,
it'll show the user's country of origin.
Get user info will load the user's queue status, as well as the user's text and pictures, if any was added by that user..
Browse files will load the user's files in the User browse tab, allowing you to view that user's shares.
Add User to list will drop that user into your user list, where you can give them privileged status, add comments or even ban them, if you wish.
Ban this user will block that user from downloading from you and from viewing your shares.
Ignore this user will make that user disappear from chat rooms and private chat. *Muwahaha*
Log window:
If you enable debugging, you'll be able to see everything nicotine is doing in the background.... it'll get boring very quickly, unless you're a python programmer. :)
Lots of useful info ends up in here, like download completion, so don't be afraid to check it out from time to time.
Searching:
Search results in the default theme colors are either black (for immediate download) or gray (queued, you have to wait).
Search filters are quite handy... and checking Free slot will remove all the search results that have a queue.
The remember check box will make your search run continuously and between sessions. So, if you don't close the search, every time you start Nicotine, it will start searching
again. (This is the same as Wish list in the windows client)
For OSX users especially, as of version 1.0.8rc1, double clicking on search results or files in
User browse will start downloading them. OSX users with 1.0.7 must use ⌘ + mouse click.Search Menu:
Download file(s) adds the selected files to your download queue.
Download file(s) to... allows you to choose where to save downloads.
Download containing folder(s) allows you to download entire folders (and subfolders). Be careful with this option.
Copy URL pastes a slsk:// link for the selected file in the copy buffer.
Copy folder URL pastes a slsk:// link for the selected file's folder in the copy buffer.
Look at the User Popup Menu section for explanation of the other options.
Download & Upload Menus:
Get place in queue send the number of files ahead of you in the queue to the Log Window.
Copy URL pastes a slsk:// link for the selected file in the copy buffer.
Copy folder URL pastes a slsk:// link for the selected file's folder in the copy buffer.
Look at the User Popup Menu section for explanation of the these options.
Abort will simply cancel download(s).
Abort and remove will cancel and delete the file(s) from the hard drive.
Retry will attempt to complete the file(s) from wherever they left off.
Clear will remove selected files from the list.
Clear finished/aborted will remove finished or aborted files from the list.
Clear finished will remove finished files from the list.
Clear aborted will remove aborted files from the list.
Clear queued will remove queued files from the list.
Transfer Settings:
There are a multitude of options, so I won't go into them all, here. The most important, besides those discussed in Startup are: 
Locally queue uploads if uploads speed exceeds X KBytes/sec means that if that many Kilobytes are being sent, any other uploads will be queued.
Number of uploads exceeds X is a max upload slot. It's not recommended because if limited to only one transfer and a slow user downloads stuff from you, your queue will
slow down.
Limit uploads speed to X KBytes/sec is most useful with the total transfers option. You should set your upload speed to a few kilobytes below your maximum
upload rate to insure your uploads don't choke your downloads and webbrowsing.
A user may queue a maximum of X Megabytes means that if a users queues X megabytes from you, his/her next queued file(s) will fail and be sent a message saying they
queued too much.
Queue limit does not apply to friends lets buddies queue unlimited amounts of files.
Share to friends only is a greedy/paranoid way of limiting your shares to friends, only. Basically it means the rest of the soulseek is banned/blacklisted until you add
them to your list.
Privilege all my friends gives buddies a higher priority in the queue.
Lock incoming files (turn off for NFS) is a workaround for users sharing/saving files on remote computers on their network.
Other Settings:
Logging: If you chat in Soulseek (hey, what's the point if you don't?) you should enabling logging.
Interface:Change the default colors to something that doesn't clash with your aesthetics (and gui theme).
URL Catching: Make sure your web browser executes when you click on a link in Nicotine. For example, Mozilla Firefox users can use: mozilla-xremote-client 'openURL(%s,new-tab)' &
User Info: Type in a bit of info and drop in a picture for a little bit of personalization.
Search Requests to your computer are a substantial performance hit if you are sharing many thousands of files. Misc->Searches->Return a max of 12
results. This will lessen the number of search results from your shared files that Nicotine sends to other soulseek users.
Events are programs that are run when either a download completes or a folder completes downloading.
Try a command like: xmms -e $
Extra Tips:
/ignore your enemies (also Right-click->Ignore this user from the user list)
Some users don't share at all or are sharing only to a select group of friends. If you suck up to them, they might put you on their buddy list.
Interests will help you find users that Like things you do. It doesn't tell you what files they have.
Tickers are a sometimes annoying feature, Alt-T or use File->Hide Tickers.
Apple Tips:
To use the GUI, learn: ⌘ + mouse click Some OSX users may get "Too many open files" errors.Adding ulimit -n unlimited to the command that starts nicotine (or by copying it to your ~/.profile ) will probably fix those.If you get a DB, database or BSD error when starting Nicotine (from the shell to see why it won't start), run the following command EXACTLY:
rm -f ~/.nicotine/config*db
This command deletes only your shares database, so all you have to do is rescan, and not lose all your settings.
Confused by the terminal? Read this: OSX Terminal Intro (If any of this doesn't work for you I really want to know. PM me on slsk) Windows Tips:
Windows users may be wondering what they need to install to use Nicotine.
Nicotine's dependencies are:
Once you've installed all those, download the tarball from the Nicotine website and use Winzip or 7-zip or something to extract it to a directory. ( C:\Program Files\Nicotine is as good as any)Rename the file nicotine in that directory to nicotine.py and then double-click on it.You're finished and running Nicotine. /Commands
There are quite a few commands in Nicotine that you may find useful. Commands save time otherwise wasted on lots of hunting and clicking.
Chat: /join /j room (Joins a room) /part /p /leave /l room (Leave a room, or the current room if none is specified) /away /a (toggles away status) /me message (says message in the Third Person. Example: * daelstorm eats a kitten ) . /tick /t message (sets the ticker for the current room to this message) /clear (clear Chat log) /close /c (close Chat Room or Private Chat) Private Chat: /pm user (start a Private Chat with a user) /msg user message (send a Private Message to user -- use it while in the Chat Rooms, for example) Browse / Info / IP: /browse /b user (attempts to browse a user's files) /whois /w user (get user's userinfo, which might include a picture) /ip /nsa user (shows the IP address and country -- if you have GeoIP installed -- of the user) Search: /search /s query (search globally for query) /usearch /us user query (search only this user with the query) /rsearch /rs query (search only the users in the rooms you are in with the query) /bsearch /bs query (search only your buddies with the query) Lists: /add /ad user (add/remove user from the user list) /buddy /unbuddy user (add/remove user from the buddy list) /ban /unban user (add/remove user from the ban list) /ignore /unignore user (add/remove user from the ignore list) ETC: //anything (will start the line with a /) /rescan (rescans shares, which may take several minutes) /quit /q (closes Nicotine) /alias (Display all alias functions) /alias alias_name alias_text |(alias_command) (create a new command that can display text and/or run a process) /alias alias_name (Display alias's function) /unalias alias_name (Remove alias) Examples: /alias date |(date)the new command, /date will now print the GNU date command's output to the chat room /alias date Hello, the time is: |(date)/date will print something like: 14:42:04 [daelstorm] Hello, the time is: Sun Apr 16 14:42:04 UDT 2006
There are endless possiblities and combinations of commands and scripts you can add, but be WARNED, you CAN lock up Nicotine if you run a program that doesn't exit immediately. This is feature is designed for running scripts, getting text output and most definitely NOT for running GUI programs. |
||
|
|
|