Links Nicotine Museek Icons Other
Themes Wallpaper
I enhanced museekchat (comes with Museek SVN) slightly (it was just chatting in Soulseek chatrooms) and have re-named it Mucous.

Getting Mucous:
  • Compatible Version: mucous 0.5.4 works with versions of Museek older than April 25th.
  • Cutting Edge versions only work properly with the latest Subversion Museek: mucous 0.5.8
  • Development Version: mucous-dev 0.5.6b3
Screenshots: About Mucous | Dependencies | Plans | Changelog | Old Versions


What it is:
Mucous is a Curses/Python client for Museek, the Soulseek daemon/client. Like Museeq, it's an interface to Museekd.

Tagline: Mucous: Protecting your soul after excessive Nicotine abuse

Usage:
run mucous

/interface <hostname:port>
/password <interface password>
/save
/connect

You should now be logged in.
type /help

Commands and names can be completed with the Tab key.
For example, typing:
/d<TAB><TAB><TAB>
will cycle thru commands beginning with /d

Dependencies

  • Python, and the Curses bindings for Python (usually included)
  • Put the latest messages.py and driver.py in the same directory as mucous.
  • If you haven't installed museek with the Python mucipher bindings, you'll need to get pymucipher 0.0.1.
    (Mucipher is the encryption library that mucous needs to communicate with museekd.)
    If you are going to compile the binary module for pymucipher, you'll need GCC, Python and SWIG (greater than 1.1.x | try 1.3.x).
  • Cygwin Binary mucipher module: mucipher-cygwin-0.0.1.tar.bz2 (python 2.4)

Plans

  • Make private chats seperated for each user (Done!)
    and the same for browsing, userinfo, and possibly searches
  • Add Full transfer management (Added, mostly)
  • Add Settings mode (Added, but needs more options)
  • Add mouse-clickable buttons, ala giFTcurs, mc (Added)
  • Make a better search input box
  • Make userinfo easier to browse (Added)
  • Add interests (possible?)

Changelog

Updated 3 May 2005
    Version: 0.5.8
  • Split User Info up into tabs. Click on them to cycle thru, Click close to close them, or use /infoclose
  • Fixed a bug in Private Chat scrolling (discovered whilst working on UserInfo)
Updated 2 May 2005
    Version: 0.5.7
  • Added a nicotine-like ticker to the status log. Toggle on or off in the new-and-improved setup mode or with /tickcycle
  • Setup mode vastly improved
  • Connection and debugging info moved to the new Help Mode

Updated 1 May 2005
    Version: 0.5.6
  • Integrated Buddy, Ban and Ignore lists in "Users" Mode, added online status to them
  • Added a "Rooms" mode, with a scrollable roomlist
  • Fixed some bugs in the chat room log, when scrolling, new chat messages don't appear
  • The Userlist Roombox now scrolls from the top of the list
  • Some protocol changes, use messages.py and driver.py included in tarball
    Version: 0.5.5
  • Updated to match current Museek Subversion's protocol changes (private messages, searches)

Updated 25 April 2005
    Version: 0.5.4
  • Fixed a bug in scrolling
  • Added /retryall (retries all failed downloads)
  • Added /clearroom clears current or specified room log
    Version: 0.5.3
  • Modified: remember that primitive userlist box? Now it's toggleable with /roombox to big, small and off and scrolls. To switch to it, use HOME, END, or /roombox.
  • Fixed a crash with tabbing in "connection mode" (thanks, stoked-fish, jaren80 for pointing it out)
  • Fixed a bug in the /np function that outputted "None" before now playing text
Updated 24 April 2005
    Version: 0.5.2
  • Modified: chatroom colors, layout, added a primitive userlist box in the top left.. doesn't scroll, yet. (thanks Xero, for the criticism about the colors)
  • Modifed: Private Chat to be seperated & "tabbed", with a clickable bar along the top
  • Fixed the crazy way the mouse worked earlier.. curses.BUTTON1_PRESSED -> curses.BUTTON1_CLICKED.. silly me.
  • Tab completion now cycles (this was a big pain, and it still isn't perfect, yet)
  • /list now outputs green for buddies, red for banned, etc.
Updated 22 April 2005
    Version: 0.5.1
  • Modified: nick mention highlighting to make it even cooler
  • Added: //command escaping
  • Fixed a bug in the timer
Updated 21 April 2005
    Version: 0.5.0
  • Added: nick highlighting... and some other groovy magic
    Version: 0.4.9
  • Modified: customizeable /np use /npset and /npprefix and /npcheck to manage it.
    Version: 0.4.8
  • Added: Logging (use /logging to enable, and then /save)
    logs will be saved in ~/.mucous/logs/[rooms|private]/[room|user] unless you use --log
  • Added: /rescanshares and /reloadshares
    Version: 0.4.7
  • Fixed: crash on server reconnect
  • Added /roomlistrefresh, made /roomlist output already recieved roomlist
  • Past chat in rooms in no longer cleared, if disconnected and reconnected from museekd or soulseek.
  • Added a --- Disconnected from xxxx --- message to the chatrooms
  • Added /nuke and /unnuke
  • Fixed a mistake I made in messages.py, now /ip doesn't crash mucous anymore

Updated 20 April 2005
    Version: 0.4.6
  • Added major enhancements to tab-completion
  • Tabbing now works for usernames and /commands
  • Cleaned up the code a lot, added more checks for proper /command input
  • Added /downpathdir, for recursive manual downloading. (Set user with /downuser)
  • Use PageUp & PageDown to switch scolling from downloads to uploads instead of tab
  • The keypad enter should now work no matter numlock's state
  • Added a forgotten transfer type (error) to the transfer lists
  • Changed how config setting changes are reported in Info Mode, made sure updates to buddy/ban/ignore lists take effect immediately

Updated 19 April 2005
    Version: 0.4.5
  • Added command-line options, --help, --config, --version
  • Mucous no longer crashes when disconnected from Museekd
  • Mucous also can now be manually disconnected with /disconnect
  • Mucous will close a bad connection attempt after 5 seconds
  • Added /downdir (use like /download, for searches)
  • You'll need the new driver.py, because of the new socket closing feature.

Updated 18 April 2005
    Version: 0.4.4
  • Finished implementing scrolling in Transfer Mode (Use Tab to switch between uploads and downloads)
  • Partially rewrote scrolling for chatrooms
  • Added clickable scrolling spots in chatrooms
  • Changed the formatting in the ban, buddy and ignore lists

Updated 17 April 2005
    Version: 0.4.3
  • Added tab nick completion! Yay!
  • Added a little bit more info to setup mode.
    Version: 0.4.2
  • Added the /retry transfer command
  • Added the /searchbuddy command (only works with Museek Subversion from April 16th)
  • Fixed another resize bug (in transfers)
  • Other misc fixes
  • As usual, if new museek features are implemented (not just client-side features), redownload driver.py and messages.py

Updated 15 April 2005
    Bugfix release: 0.4.1
  • Fixed the "first time start" bug
  • Fixed some of the many terminal-resize crashes. (hope I can kill them all)
  • Cleaned up a few things
  • Moved /joining users-in-room-lists from info-mode into the rooms

Updated 14 April 2005
    Renamed to Mucous, version: 0.4.0
  • Added F10, setup mode, some options are toggleable just by clicking on them.
  • BE CAREFUL with Buddies-Only!
  • Added a spot to click to cycle rooms. It looks like >>>>>
  • Made the transfer view name (Queued, All, Active) to be a clickable toggle as well
  • Added /unhide (for displaying the password in Setup Mode)
  • Moved config to ~/.mucous/config

Updated 13 April 2005
    Bumped version up to 0.3.9
  • Added /abortdown and /abortd commands, also /removedown, /removed, /removeup and /removeu.
  • If you wanted to abort download number 5, you'd type: /abortd 5
  • /clearup clears all aborted, failed transfers and offline uploading users.
  • /cleardown clears all finished downloads
  • /buddyall adds everyone you are transfering to or from into your buddylist.
  • /onlybuddy Toggles Buddy-Only-Sharing
  • /privbuddy Toggles giving privileges to buddies
  • /slots <number> sets the number of upload slots

    Bumped version up to 0.3.8
  • Cleaned up transfers, organized them, and colored a few, too.
  • Added /abortup and /abortdown commands, which you can use to abort transfers, via their "number".
  • Uploads are scrollable, downloads are not, yet.
  • Hit the INSERT key, or the Left/Right arrow keys to toggle which kinds of transfers to display.

Updated 3 April 2005
    Version 0.3.5
  • Alphabetized (A-Za-z) buddy, ban and ignore lists.

Updated 2 April 2005
    Version 0.3.4
  • Split chatrooms up
  • Fixed scrolling in chatrooms, so it's now quite nice (thanks to Hyriand)
Updated 1 April 2005
  • Added colors to the buttons (version 0.3.3)
  • Added mouse-clickable buttons (version 0.3.2)
Updated 31 March 2005
    Bumped version waaay up to 0.3.1
  • Custom tickers can be saved with: /save (erase your old config, first)
  • Fixed displaying tickers (yes, it was broken for a day or so)
  • Connecting from inside mucous (/interface, /password /save /connect) now works pretty well

Updated 30 March 2005
  • Added a config file, removed commandline options

Updated 29 March 2005
  • Added a cursor in edit line
  • Added an attributecheck for get_default_color (for python 2.3)

Updated 28 March 2005
  • Cleaned up the GUI a lot, the Online Status Log is now only visible in chat mode.
  • Added transparent background support
  • Added Function Keys to switch Modes:
    F1->Chat
    F2->Private Messages
    F3->Transfers
    F4->Search
    F5->Info
    F6->Browse
    F7->BuddyList
    F8->BanList
    F9->IgnoreList
    These keys work fine on rxvt/aterm.. but very badly in xterm and konsole for some reason.

Updated Later @ 27 March 2005
  • Added active transfer monitoring
  • Added Searching for browsed files
  • Added highlight-if-username-mentioned in chatrooms
  • Added /me highlight
  • Added a error message about Terminal size if too small (75col x 15lines)
  • Added New PM/New Chat/Nick Mention status messages

Updated 27 March 2005
  • With a lot of help from Hyriand (thanks!), I got museekchat working in cygwin. (Not native win32) (Screenshot)
  • What's required: pymucipher 0.0.1, python, curses, and if you are going to compile the binary module for pymucipher, you'll need SWIG.
  • If you're in a hurry, grab the compiled binary mucipher module: mucipher-cygwin-0.0.1.tar.bz2 (python 2.4)
  • Mucipher is the encryption library that museekchat needs to communicate with museekd

Updated 26 March 2005
    New Features:
  • Browsing: Browse-user, Download-by-number
  • Interface: /chat /search /browse /info /private now switch to their respective modes. It's slightly less cluttered this way, since everything was in the chat log before.

Updated 25 March 2005

    Now its features include:
  • User Management: Ban/Unban, Buddy/UnBuddy, Ignore/Unignore, Userinfo, Userstats, User IP, Private Messages
  • Status Settings: Away Toggling, Room AutoJoin Toggling, Setting Tickers, Toggle Tickers
  • Searching: Searching, Result Numbering, Download-by-Number
  • Transfers: Download-by-User/Path, AutoBuddy, Current Number of Active Uploads/Downloads
  • Rooms: RoomListing (by number of users), Users in room, Listing Tickers (per room), Primitive chat room Scrolling, and most important, a Now Playing script.