Table of Contents
- Conventions Used in This Guide
- Frequently Asked Questions
- Installation
- Settings
- Getting Around
- Aliases
- Now Playing (use the NowPlaying dialog for versions >= 1.2.6)
- Customization
Grey background with dark-grey border and black font-color (Used for commands, command output, and switches)
./nicotine
On Linux, the BSDs and Mac OS X, a X-Server is required.
Nicotine+ > 1.2.7.1 no longer requires the TrayIcon module if you have PyGTK 2.10 and GTK 2.10. The TrayIcon in Windows for older versions used PyWin32, but GTK 2.10 made that unnecessary.tar jxvf nicotine+-X.X.X.tar.bz2or
tar zxvf nicotine+-X.X.X.tar.gz
cd nicotine+-X.X.X
./nicotine
To get Nicotine working under windows you need to download and install:
sudo port install py-gtk2
sudo port install subversionThen, download the latest source code.
svn checkout http://nicotine-plus.org/svn/trunk/nicotine+ nicotine+
cd nicotine+/
./nicotine
Choose a password carefully. There is no way to recover password you've lost. If this is a concern for you, backup your config files.
If you want to sort out your downloads by moving files to their appropriate location, do NOT check "Share download directory", since Windows cannot move files while they're in use. (getting downloaded by
others)
If you rename or move files and do not rescan your shares afterwards, you may get many annoyed people complaining about File errors? If you want to have a good way of keeping your collection sorted, so it's easy for you and
others, browse users who share lots of files to see how they have sorted their collection. Watch, learn and do the same.
One user CANNOT download 2 files from you at the same time. When you limit your upload slots to 2 files, then two different users can each download 1 file from you, for a total of 2 files uploaded. When 3 users are
trying to download from you, 2 users will download while the third user has to wait.
When a user downloads more than the allowed maximum file size or number of files they will not be placed in your upload queue and the user will see a message in their transfers list.
If you're going to use this option, make sure you put this in your User info, since there's no obvious way to detect it otherwise.
If some users are downloading, and one Buddy queues some files, he/she gets to download first, always. Privileged users have a monopoly on your queue and alway get preferential treatment.
If you have the same Incomplete and Download directory (the default setting), it's a good idea to keep this option checked.
This option is NOT available for Nicotine+ Windows version. Geo Block allows you to block specific users from a country.
Chat color settings are only for you, other users will the colours they've selected.
This feature is available from Nicotine+ 1.2.4 and up.
URL Catching only works in not just in Chat rooms and Private chat, but in pretty much any TextView, including some of the about dialogs.
You can only have one handler for each protocol.
"http" is for webpages, "ftp" is for FTP servers. Depending on what kind of protocol you and your buddies use all the time you can add new protocols.
Let's say you have 2898 wu family related files. When some user searches for "wu" or "wu tang" only the first 50 results are sent out to user whose searches match your files.
You can only add plain text. HTML and BB tags won't work.
If you have a webpage or profile somewhere, add it here, instead of having a long self description
Don't choose a high, big resolution picture. It takes time to load and you experience a slow Nicotine+ if everytime your User info is requested. Nicotine+ does not compress your images.
Most menu items can be used through shortcuts. Try to remember them, so you don't need to hunt and click with your mouse
You can turn on/off debug info by going to "File --> Show debug info "
To access right click menu on, use ⌘ + mouse click
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.
⌘ + mouse click.
There are endless possibilities and combinations of commands and scripts you can add with the /alias command, 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.
There are endless possibilities and combinations of commands and scripts you can add with the /alias command, 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.
You can access most items by Letter Commands. (see next section)
Save time by hitting Enter after you fill out the search field.
Search results in the default theme colors are either black (for immediate download) or gray (queued, you have to wait)User info doesn't have menus, instead you can use buttons
Before you search, make sure you select the shared directory at the top of the folder tree. That way you'll search through every file shared.Icon themes refer only to the 16x16 pixel .png and images that display in the trayicon, the user status column in user lists, and the notebook tabs.
The files in the img/ subdirectory are stored in the imagedata.py file as data strings and loaded at runtime.
To update imagedata.py, edit the .png files and then, from the root nicotine+ source directory run:
./encode_bitmaps.pyThe images will be stored in the pynicotine/gtkgui/imagedata.py file.



