Read Me

******************************ENGLISH******************************

Stealth Player - short description

STEALTH PLAYER - mini player with no GUI 
Version: 1.0 


***DESCRIPTION***

Stealth Player is very convenient if you don't need any flashy GUI to control playback or manage playlists. Here you just run it and then forget about it. The player is running in background. Switching tracks, volume regulation, loading and saving playlists, all of this performed by using hotkeys. Therefore, you can control the player while working in any application.
Supported sound formats: MO3/IT/XM/S3M/MTM/MOD/UMX/MP3/MP2/MP1/OGG/WAV
Can open playlists with extensions: LST/M3U/M3U8/TXT/PLS/ASX/MPCPL/PLC
Can open internet radio streams, but not remote playlists containing those streams.
 

***SETUP***

For further information on how to setup Stealth Player read INSTALL.DIZ


***COMMAND LINE KEYS***

Command line format:
stealth [commands] [files]

Commands:
	--numlock=x - if x=0, then do not turn Numlock on automatically (useful for laptops or palmtops without numeric keypad);
	--shuffle=x - if x=1, then turn random playback on;
	--recursive=x - if x=1, then load files from subfolders too (if not specified  or x=0 then load only from folder);
	--priority=x - if x='low', then set player process priority to lowest (may decrease performance); if x='high', then set player process priority to highest (may decrease performance of other programs);
	--resume=x - if x=1, then if player was closed, but user didn't stop playback (for example, on Windows shutdown), then resume playback automatically when the player will start. This key works only if no input files was specified.
	--volume-step=x - increasing/decreasing volume by x points (0<x<=100)
	--hotkeys=x - turn on x set of the hotkeys, where x is:
		extra1 - turn "extra keys 1" on (see below)
		extra2 - turn "extra keys 2" on
		multimedia - turn "media keys" on
		general - turn "general keys" on (default)
	--hotkeys-off=x - turn off x set of the hotkeys, where x is:
		extra1 - turn "extra keys 1" off
		extra2 - turn "extra keys 2" off
		multimedia - turn "media keys" off
		general - turn "general keys" off
	--playlists-limit=x - if x=0, then turn on unlimited playlist mode, so you can operate on more than 9 playlists. Hold down CTRL to load playlist (or CTRL+ALT to save playlist) and type it's number. Keep holding CTRL until playlist loads. See more info below.
	--typing-timeout=x - set timeout for typing playlist's number to x milliseconds. That's it, if set to 1000 (default), you must wait 1 second before releasing CTRL key to load playlist after typing it's number. Works only if --playlists-limit=0. See example below.

"files" means any supported audio-files, internet streams, playlists or folders. Parameters can follow in any sequence.
Examples:
1) stealth musiс.m3u --shuffle=1 - opens playlist music.m3u and turns random playback on;
2) stealth --hotkeys=extra1 --hotkeys=extra2 --numlock=0  - loads nothing, turns on "extra keys 1" and two additional keys from "extra keys 2" (see below) and will not affect NumLock;
3) stealth "http://72.26.204.28:6414/" --hotkeys-off=general - connects to radio and turns numpad hotkeys off, so you can use them in other applications;
4) stealth "C:\Mod Music" --recursive=1 "C:\MP3s" - loads all files from C:\Mod Music\, then all files from C:\MP3s and from all subfolders of C:\MP3s.
5) Stealth.exe "C:\Mod Music\" --playlists-limit=0 --typing-timeout=2000 - loads files from C:\Mod Music\, set unlimeted playlists mode, so you can handle more than 9 playlists, i. e. to save current files in playlist 1337.lst: hold down CTRL+ALT, type "1337" on numpad, wait for 2 sec holding CTRL+ALT. The playlist is saved. You may now release CTRL+ALT.


***HOTKEYS***

Control keys available everywhere and therefore cannot be used in other applications unless disabled (or unless player is closed). Numlock mode should be on to make general hotkeys work. Common keys work all the time while the player is running. You can't disable them. Multimedia keys also supported. Extra keys is helpful when you control your computer from cellphone by bluetooth. Read INSTALL.DIZ for more information. 

------common keys (always on)------
	Scroll Lock - random/sequential playback
	Shift+Alt+Pause - hotkeys off/on (except common keys)
	Left click on tray icon - sound mixer
	Right click on tray icon - exit

------general keys (--hotkeys=general option)------
	NumPad 5 - stop/play
	NumPad 4 - previous track
	NumPad 6 - next track
	NumPad 8 - volume up
	NumPad 2 - volume down
	NumPad 7 - jump to previous folder
	NumPad 9 - jump to next folder
	NumPad 0 - exit
	CTRL+NumPad X - load playlist number X
	CTRL+ALT+NumPad X - save current tracks in playlist number X
	
------extra keys 1 (--hotkeys=extra1 option)-------
	Ctrl+P - stop/play
	Ctrl+B - previous track
	Ctrl+F - next track
	F10 - volume up
	F9 - volume down
	Ctrl+Shift+B - jump to previous folder (if combined with -kb2 option)
	Ctrl+Shift+F - jump to next folder (if combined with -kb2 option)

------extra keys 2 (--hotkeys=extra2 option)-------	
	Ctrl+S - stop/play
	Ctrl+B - previous track
	Ctrl+F - next track
	Ctrl+P - volume up
	F10 - volume down
	Ctrl+Shift+B - jump to previous folder
	Ctrl+Shift+F - jump to next folder
	
------media keys (--hotkeys=multimedia option)-------
	PLAY_PAUSE - play/stop
	PREV_TRACK - previous track
	NEXT_TRACK - next track


***PLAYLISTS***

Playlists must be located in "playlists" subfolder. You can name playlist as you want but:
	1. file extension must be one of supported playlist extensions (see above);
	2. first symbols in filename should be a digits representing playlist number
For example playlist 7-Neskimos.lst will be loaded by pressing Ctrl+Numpad 7.
	3. if unlimited playlists mode is on (see above) then you can operate with almost unlimited number of playlists (see Examples to understand this technique) 
	
	
***KNOWN BUGS***

Known bugs, that are not a subject to be solved in near future:
	1. Some MOD files can run forever if they have infinite loops in their structure (it's not a bug but a warning). Stealth Player plays MOD files as they must be played
	2. Player may not understand some *.IT and *.XM files
	3. When random playback is on player may jump to the same file next (well, it's random playback! isn't it? :)
	4. Metadata from some radio stations may be incorrect. It's not StealthPlayer's fault, it's because some radios are transmitting metadata in codepages other than ASCII, but they must not.
	

***PROJECT SUPPORT***

If you want to help a project, the best you can is to report a bug, you have found.
To submit a bug, follow this link:
https://sourceforge.net/tracker/?group_id=332937&atid=1395937
and press "Add New"

If have other suggestions how to improve the project, for examaple, about new functionality, write me:
alkatrazstudio@yandex.ru - Parfenov Alexey


******************************RUSSIAN******************************

Stealth Player - краткое описание

STEALTH PLAYER - мини плеер без графического интерфейса 
Версия: 1.0 


***ОПИСАНИЕ***

Очень удобен для воспроизведения музыки в фоновом режиме, т.е. по принципу “включил и забыл”. Переключение трэков, регулировка громкости, загрузка и сохранение плэйлистов осуществляется одной-двумя клавишами на цифровой клавиатуре. При этом эти горячие клавиши доступны из любого приложения, поэтому нет необходимости переключать окна и отвлекаться от основной работы. 

Поддерживаемые аудио-форматы: MO3/IT/XM/S3M/MTM/MOD/UMX/MP3/MP2/MP1/OGG/WAV
Может открывать плэйлисты с расширениями: LST/M3U/M3U8/TXT/PLS/ASX/MPCPL/PLC
Плеер может воспроизводить интернет-радио, в том числе и из плэйлистов, но только тех, которые находятся на компьютере.
 

***УСТАНОВКА***

Инструкции по настройке Stealth Player вы можете найти в INSTALL.DIZ


***ПАРАМЕТРЫ КОМАНДНОЙ СТРОКИ***

Формат командной строки:
stealth [commands] [files]

Параметры:
	--numlock=x - если x=0, не включать Numlock автоматически (полезно для ноутбуков без цифровой клавиатуры);
	--shuffle=x - если x=1, включить режим случайного воспроизведения;
	--recursive=x - если x=1, загружать файлы также из подпапок (если параметр не указан, то загружаются только файлы непосредственно из папки);
	--priority=x  - если x='low', установить наименьший приоритет для процесса (может снизить качество звука); если x='high', установить наивысший приоритет (может снизить производительность других программ)
	--resume=x - при x=1 если плеер был закрыт, но пользователь не останавливал воспроизведение (например при выходе из Windows), то автоматически возобновить воспроизведение пр запуске плеера. Данный ключ работает только в том случае, если не было указано никаких входных файлов
	--volume-step=x - увеличивать/уменьшать громкость с шагом x (0<x<=100)
	--hotkeys=x - включить набор x горячих клавиш, где x:
		extra1 - включить набор "extra keys 1" (см. ниже)
		extra2 - включить набор "extra keys 2"
		multimedia - включить набор "media keys"
		general - включить набор "general keys" (по-умолчанию)
	--hotkeys=x - выключить набор x горячих клавиш, где x:
		extra1 - выключить набор "extra keys 1"
		extra2 - выключить набор "extra keys 2"
		multimedia - выключить набор "media keys"
		general - выключить набор "general keys"
	--playlists-limit=x - если x=0, то это включит режим неограниченных плэйлистов, так что вы сможете оперировать более чем 9 плэйлистами. Зажмите CTRL для загрузки плэйлиста (или CTRL+ALT для сохранения), затем наберите его номер и подождите определенный интервал времени (держва CTRL), пока плэйлист не загрузится. См. ниже.
	--typing-timeout=x - выставляет интервал времени в миллисекундах, который должен пройти с набора последней цифры, перед тем как плэйлист загрузится (или сохранится). Т. е. при --typing-timeout=1000, нужно подождать 1 секунду перед тем, как отпускать CTRL после набора номера плэйлиста. Имеет действие только при --playlists-limit=0. См. пример ниже.
	
"files" означает любые поддерживаемые аудио-файлы, интернет радио, плэйлисты или папки. Параметры могут идти в произвольном порядке.
Примеры:
1) stealth musiс.m3u --shuffle=1 - откроет плэйлист music.m3u и включит режим случайного вопроизведения;
2) stealth --hotkeys=extra1 --hotkeys=extra2 --numlock=0 - не загружает ничего, включит "extra keys 1" и две добавочные клавиши из "extra keys 2" (см. ниже) при этом не изменит состояние NumLock;
3) stealth "http://72.26.204.28:6414/" --hotkeys-off=general - присоединится к радио и выключит горячие клавиши на NumPad, таким образом вы сможете их использовать в других приложениях;
4) stealth "C:\Mod Music" --recursive=1 "C:\MP3s" - загрузит все файлы из C:\Mod Music\, затем из C:\MP3s и всех подпапок C:\MP3s.
5) Stealth.exe "C:\Mod Music\" --playlists-limit=0 --typing-timeout=2000 - загрузит файлы из C:\Mod Music\, установит режим неограниченных плэйлистов, таким образом вы сможете управлять более чем 9 плэйлистами. Например, чтобы сохранить загруженные файлы в плэйлист 1337.lst сделайте следующее: зажмите CTRL+ALT, наберите "1337" на цифровой клавиатуре, подождите 2 секунды. Плэйлист сохранен. Теперь можете отспустить CTRL+ALT.


***ГОРЯЧИЕ КЛАВИШИ***

Управляющие клавиши доступны везде, поэтому их нельзя использовать в других приложениях до тех пор, пока они не будут отключены (или плеер не будет закрыт). Numlock должен быть включен, чтобы горячие клавиши на цифровой клавиатуре работали. Common keys работают всегда, пока плеер запущен. Также поддерживаются мультимедиа клавиши. "Extra keys" полезны, когда вы управляете компьютером с мобильного телефона посредством bluetooth. Читайте INSTALL.DIZ.

------common keys (всегда включены)------
	Scroll Lock - случайное/последовательное воспроизведение
	Shift+Alt+Pause - включить/выключить горячие клавиши (кроме common keys)
	Щелчок левой кнопкой мыши на иконке в трее - аудио-микшер
	Щелчок правой кнопкой мыши на иконке в трее - выход из программы

------general keys (параметр --hotkeys=general)------
	NumPad 5 - стоп/воспроизведение
	NumPad 4 - предыдущий трек
	NumPad 6 - следующий трек
	NumPad 8 - увеличить громкость
	NumPad 2 - уменьшить громкость
	NumPad 7 - перейти к предыдущей папке
	NumPad 9 - перейти к следующей папке
	NumPad 0 - выход из программы
	CTRL+NumPad X - загрузить плэйлист с номером X
	CTRL+ALT+NumPad X - сохранить текущие треки в плэйлист с номером X
	
------extra keys 1 (параметр --hotkeys=extra1)-------
	Ctrl+P - стоп/воспроизведение
	Ctrl+B - предыдущий трек
	Ctrl+F - следующий трек
	F10 - увеличить громкость
	F9 - уменьшить громкость
	Ctrl+Shift+B - перейти к предыдущей папке (если также указан параметр -kb2)
	Ctrl+Shift+F - перейти к следующей папке (если также указан параметр -kb2)

------extra keys 2 (параметр --hotkeys=extra2)-------	
	Ctrl+S - стоп/воспроизведение
	Ctrl+B - предыдущий трек
	Ctrl+F - следующий трек
	Ctrl+P - увеличить громкость
	F10 - уменьшить громкость
	Ctrl+Shift+B - перейти к предыдущей папке
	Ctrl+Shift+F - перейти к следующей папке
	
------media keys (параметр --hotkeys=multimedia)-------
	PLAY_PAUSE - стоп/воспроизведение
	PREV_TRACK - предыдущий трек
	NEXT_TRACK - следующий трек

	
***ПЛЭЙЛИСТЫ***

Плэйлисты должны находиться в подпапке "playlists". Вы можете давать им любые имена, но:
	1. расширение файла должно поддерживаться плеером (см. выше);
	2. первые символы в имени файла должны быть цифрами, обозначающими номер плэйлиста. Например плэйлист 7-Neskimos.lst будет открыт при нажатии Ctrl+Numpad 7.
	3. если включен режим неограниченных плэйлистов, то вы можете управлять более чем 9 плэйлистами (см. Примеры, чтобы лучше понять)


***ИЗВЕСТНЫЕ БАГИ***

Баги, которые не подлежат решению в  ближэайшее время:
	1. Некоторые MOD файлы могут воспроизводиться вечно если в них присутствует бесконечный цикл (это не баг, а скорее предупреждение). Stealth Player воспроизводит MOD файлы так, как они должны вопроизводиться
	2. Плеер может не читать некоторые *.IT и *.XM файлы
	3. Когда включен режим случайного вопроизведения, один и тот же трек может воспроиззвестись несколько раз подряд (ну все-таки это случайное воспроизведение! :)
	4. Метаданные, принимаемые с некоторых радиостанций могут быть неверны. Это не вина StealthPlayer. Некоторые станции вещают метаданные не в ASCII-кодировке, хотя не должны.	
	

***ПОДДЕРЖКА ПРОЕКТА***

Если вы нашли баг в программе, то запишите его на баг-треккере SourceForge:
https://sourceforge.net/tracker/?group_id=332937&atid=1395937
там нажмите "Add New"

Если у вас есть другие предложения по проекту, например, по новой функциональности, то пишите мне:
alkatrazstudio@yandex.ru - Парфёнов Алексей