TinyMP3 | Documentation
1. Intro 2. Screenshot 3. Starting up/Installing 4. Features 5. Keyboard Shortcuts 6. Mousewheel Support 7. How to edit custom colors 8. QA ("bugs" & more) 9. Credits 10. Greetings
1 Intro Welcome to Tinymp3, a challenge entry for the mircscripts.org 'best mp3 player in a picwin under 10K. To avoid emails or anything about this, TinyMP3 was over 10,000 bytes, but not 10KB. The reason is because traditionally 1KB is 1024 bytes, a power of 2. 1024 * 10 = 10240. Now it's just huge and feature filled. Return to top
2 Screenshot Return to top
3 Installation To install, type /load -rs <location of tinymp3final.mrc> in any window in mIRC. Example: /load -rs tiny/tinymp3final.mrc Then some text will pop up in the active and status windows stating that TinyMP3 was loaded and that you must type /tm3 to run it. Do so to run it. Return to top
4 Features Trippy Hue Changer: TinyMP3 has a totally worthless and CPU intensive huechanger which took days to code. But it’s really fun to have on! Keyboard Shortcuts: TinyMP3 has built in keyboard shortcuts for ease of use Mousewheel Support: TinyMP3 has extensive mousewheel support using Soul_Eater's mousewheel DLL. Toolbar Support: TinyMP3 has toolbar support using a supplied DLL. TinyMP3 can also download the DLL for you if you don’t have it. This means the player can run in the mIRC toolbar, and it also allows opening the playlist from the toolbar, and the window will automatically return to the toolbar when you click away. Tons of Options : You can access the plethora of options by right clicking on TinyMP3. Often Used options are in this menu, and there are many many more options in the "Other Options" submenu. Move Your Player: You can move the player by either clicking and dragging on the song title/position or the sideways dragbar on the left. Last Session Memory: When you close and reopen TinyMP3, it will save your playlist and reload it so that it is not lost! It will also remember which MP3 you were playing and where you were in the playlist, as well as what was selected, how big your player was, and whether the playlist was on or not. Stop MP3 on close: you dont have to stop the mp3 when you close tinymp3, but you can (in the options popup) Snap!: Your player will 'snap' to the edge of the screen when it comes within 10 pixels of it. Search MP3's: This option is in the options popup, a keyboard shortcut, and also accessable with /fi in the channel editbox. Note: it is recommended that you use /fi, because then, due to some weird window parenting issues, youll be able to just repeatedly press 'enter' until you find what you want. You can find the currently playing mp3 by hitting the 'Find current' button in options popup or using the keyboard shortcut You can navigate the playlist with the keys ARROW UP and ARROW DN, and play the selected item with ENTER The playlist can collapse into the main window, the option is in the right click popup or just double click in one of the draggable areas (song title & dragbar) Random play, in options popup Custom Color Set: don't like the colors of Tinymp3? Change them in options popup Rearrange your playlist by dragging a selected item around while holding the mouse button! Resize your player to make it the size you want, and then you can also collapse the playlist You can 'spam a channel' with what mp3 youre playing. The menu is in your nicklist. Change the color of your channel spam, located in the nicklist popup Change the channel to which TinyMP3 spams, note, it is compatible with multi-server Auto Advance: when the currently playing item is finished, Tinymp3 will move to the next item in the playlist and play it Load M3U: Tinymp3 can import M3U format playlists! Save and Load Tinymp3 Playlists in the options popup Add a directory to the playlist using the options popup or keyboard shortcut Add a single MP3 to wherever your selection is using the options popup or keyboard shortcut Remove the selected Playlist entry in the options popup ID3 support: Your playlist will automatically update itself with ID3 info when you play an entry. Please note that it will not update when you load the files, as this would be slow when adding obscene amounts of files. Double Position Slider: when you are changing the position in your mp3, the title are will display ::SEEKING:: (place) and you will have a second slider on your position slider. That way, you'll be able to see where the MP3 currently is and where it will seek to. If you decide not to seek, simply move your mouse up over the title text. Moving down will result in moving the selected mp3. Play File Quick Button: This button is located next to the 'next song' button. It will allow you to play a file without adding it to the playlist. This option is also in the options popup. Autoscroll: When you resize the player so that the title will not fit into the veiwing area, it will automatically scroll. Return to top
5 Keyboard Shortcuts TinyMP3 has the following 22 keyboard shortcuts for ease of use: [F]: Finds the currently playing file (also in options popup) [J]: Searchs all filenames (and ID3's that have been entered into the playlist) for a string (also in options popup) [A]: Opens the 'Add Dir' dialog (also in options popup) [INSERT]: Opens the 'Insert MP3 at selection' dialog (also in options popup) [I]: Opens the 'Insert Dir' dialog (also in options popup) [Z]: Equivalent to hitting the Previous Song button [X]: Equivalent to hitting the Play Song button [C]: Equivalent to hitting the Pause button [V]: Equivalent to hitting the Stop button [B]: Equivalent to hitting the Next Song button [O]: Opens the 'Open File' dialog (also in options popup) [T]: Puts the player in toolbar mode [P] or [SHIFT+F9]: Toggles the playlist on or off (also in options popup or double click on title/dragbar) [DELETE]: Deletes the selection without asking confirmation, so watch out [HOME]: Scrolls the playlist selector to the top [END]: Scrolls the playlist selector to the bottom [PAGEUP]: Scrolls the playlist selector up by one page [PAGEDN]: Scrolls the playlist selector down by one page [-]: Volume Down [+]: Volume Up [ARROW LEFT]: Seek backward in the mp3 5 seconds [ARROW RIGHT]: Seek forward in the mp3 5 seconds [ARROW UP]: Moves the playlist selector up (also scrolls to it if it is not on screen) [ARROW UP+SHIFT]: Moves the playlist selector up, but adds entries for multi-selection [ARROW UP+CTRL]: Moves all selected entries up [ARROW DOWN]: Moves the playlist selector down (also scrolls to it if it is not on screen) [ARROW UP+SHIFT]: Moves the playlist selector down, but adds entries for multi-selection [ARROW UP+CTRL]: Moves all selected entries down [ENTER]: Plays the entry that has been selected by the playlist selector Return to top
6 Mousewheel Support TinyMP3 makes use of Soul_Eater's mousewheel DLL, if it can be found: In The Control Area: [Up]: Volume Up [Down]: Volume Down [Up+CTRL]: Play Next Song [Down+CTRL]: Play Previous Song [Up+SHIFT]: Skip Forward in Song [Down+SHIFT]: Skip Backward in Song In The Playlist Area: [Up]: Scroll Up [Down]: Scroll Down [Up+CTRL]: Move selected song(s) up by one [Down+CTRL]: Move selected song(s) down by one [Up+SHIFT]: Scroll Up at 3 times your selected mousewheel scroll speed [Down+SHIFT]: Scroll Down at 3 times your selected mousewheel scroll speed [Up+SHIFT+CTRL]: Move selected song(s) up by your selected mousewheel scroll speed [Down+SHIFT+CTRL]: Move selected song(s) down by your selected mousewheel scroll speed Return to top
7 How to edit Custom Colors I thought it was reasonably straight forward, but I have decided to include documentation anyway. To change the colors, simply hole your mouse button down in the Red, Green, or Blue columns and then move the mouse. The color will update in the player window. To Change Colors: Right click in the color editing window and select the color you wish to change. TinyMP3 will always load your custom colors on startup instead of the default colors. Simply close the editing window when done, and you will be set. Return to top
8 QA ("bugs" & more) Q: Menu for spam is in nicklist and menubar instead of tinyamp window, what gives? A: the menu for spam is generated via $submenu. In mIRC, $submenu doesnt work in picture windows. I think this is actually a bug in mIRC, and I have emailed Khaled about it. Update: Newer versions of mIRC have this fixed, thanks to me. TinyMP3 has been likewise updated. Q: I can only select one mp3 in my playlist.. why? A: Space issue. Selecting more than one item would require quite a bit more code, and there simply was no room in order to make it into the challenge. Expect TinyMP3 SE to have it. Update: it does. And more. Q: TinyMP3 wont play network files in format //blahblah/blah.mp3, why? A: mIRC bug. You'll probably get an error in your status window about /splay 'file not found'. $isfile returns true for the file, but /splay wont play it. There is a solution though! Simply map a network drive to the folder on the network, and then you can play the files that way. Q: TinyMP3 wont play my MP3, why? A: Your mp3 is probably not compatible with mIRC. That, or your playlist entry is messed up. I have also noticed some MP3's work with /splay only after you /splay seek, so try moving the position bar. Q: You ripped off ^Andy's spam color selector from mp3stuff! A: I too thought it was too similar, and removed it. However, ^Andy told me to put it back in so everyone can see how much 'I wub him'. Q: I have mp3's with double spaces in the filename and they wont play! wtf! A: mIRC script has issues with redundant spaces. This is fixable, but not practical for a challenge entry. Q: I had spam on, I reconnected, and then it stopped working! why? A: In order to be compatible with multiserver, TinyMP3 needs to remember the 'CID' of the server you want to spam to. If you reconnect, that CID could change and be invalid, making it not work. Return to top
9 Credits Tinymp3 was created by oS\2, aka oSiRiS aka ^oS Return to top
10 Greetings ^Andy, EvilXeroX, Magnus`, nacitar, nimper, eXonyte, Kamek, dohcan, fubar, tabo, Variant, shikkie, Memo, ^TwoSock^, Soul_Eater Return to top

Tinymp3 homepage
Email the author