folders renames

git-svn-id: http://svn.miranda-ng.org/main/trunk@1300 1316c22d-e87f-b044-9b9b-93d7a3e3ba9c

5 files changed, 305 insertions, 0 deletions

diff --git a/plugins/ListeningTo/docs/listeningto-translation.txt b/plugins/ListeningTo/docs/listeningto-translation.txt
new file mode 100644
index 0000000000..ed961b5eca
--- /dev/null
+++ b/plugins/ListeningTo/docs/listeningto-translation.txt
@@ -0,0 +1,64 @@
+; Common strings that belong to many files

+;[]

+

+; ../../plugins/ListeningTo/listeningto.cpp

+;[Don't send to any protocols]

+;[Enable/Disable sending Listening To info (to all protocols)]

+;[Listening to]

+;[Send to %s]

+;[Send to all protocols]

+;[Toggle send to all protocols]

+

+; ../../plugins/ListeningTo/options.cpp

+;[Format]

+;[General]

+;[Listening info]

+;[Players]

+;[Status]

+

+; ../../plugins/ListeningTo/resource.rc

+;[ Contacts ]

+;[ Listening to ]

+;[ Listening to information ]

+;[ XStatus ]

+;[%album% - Album name]

+;[%artist% - Artist name]

+;[%genre% - Song genre]

+;[%length% - Song length]

+;[%listening% - Listening to info (as set above)]

+;[%player% - Player name]

+;[%title% - Song title]

+;[%track% - Track number]

+;[%type% - Media type (Music, Radio, Video, etc)]

+;[%year% - Song year]

+;[Allow auto-loading plugins into players (affect players with *)]

+;[Apply template for info from contacts (overrides contacts template)]

+;[Ask for new info every]

+;[Do nothing]

+;[Enable sending listening information to contacts:]

+;[For protocols that don't support listening to but support XStatus:]

+;[Get info from WATrack plugin]

+;[Get info from these players:]

+;[If XStatus is Music, show listening info]

+;[If other XStatus is not set, set XStatus to Music and show listening info]

+;[Message:]

+;[Music]

+;[Other Variables:]

+;[Other players]

+;[Others]

+;[Radio]

+;[Set XStatus to Music and show listening info]

+;[Show advanced icon in slot]

+;[Template:]

+;[Title:]

+;[Variables:]

+;[Video]

+;[When nothing is playing, replace %listening% with:]

+;[When variable not found, use:]

+;[Winamp (*)]

+;[Windows Media Player]

+;[You also have to enable it per protocol in the main menu]

+;[foobar2000 (need to install the plugin manually)]

+;[iTunes]

+;[mRadio]

+;[seconds]

diff --git a/plugins/ListeningTo/docs/listeningto_changelog.txt b/plugins/ListeningTo/docs/listeningto_changelog.txt
new file mode 100644
index 0000000000..8a3a578432
--- /dev/null
+++ b/plugins/ListeningTo/docs/listeningto_changelog.txt
@@ -0,0 +1,125 @@
+ListeningTo

+

+Changelog:

+

+. 0.3.0.0

+  + A lot of changes for the internal logic for handling players

+

+. 0.2.1.0

+  * Fix for disable by menu item

+  * Fix for no output (closes #33)

+

+. 0.2.0.0

+  + Added support for accounts

+  + Added support for extra icons service

+  - Hotkeys only for enable/disable all status

+

+. 0.1.3.2

+  * Fixes for foobar

+  * Better WATrack support

+

+. 0.1.3.1

+  + Added hotkeys to toggle sending info (closes #54)

+  * Fixed variables support (closes #75)

+  + Better handling of menu items (closes #74)

+

+. 0.1.3.0

+  + Added hotkeys to enable/disable sending info (closes #54)

+  * Fixed graying radio in optionc (closes # 52)

+  * Better cleanup on exit (for #63)

+

+. 0.1.2.3

+  * Fix for memory leak

+  * Fix for variables (also need latest variables version)

+

+. 0.1.2.2

+  * Fix to work on Win 9X

+  * Fix to compile in VS2005

+

+. 0.1.2.1

+  + Support not moded version of variables too

+  * Fix for foo_mlt and non english tags

+

+. 0.1.2.0

+  + Added variables support for template and XStatus template - need Variables MOD

+  + Added option to disable info per type

+  + Added foobar plugin (need to be installed manually) - thanks LRN for this one

+

+. 0.1.1.8

+  + First step for foobar support

+  + Added service to allow other plugins to send info to this one

+  * Renamed mlt_winamp.dll to gen_mlt.dll (to be more compatible with winamp). You can delete mlt_winamp.dll

+

+. 0.1.1.7

+  * Fix for crash when disabled

+  + Wait at least 10s beetween protocol notifications 

+

+. 0.1.1.6

+  * Fix to get info from radio station in winamp

+  * Fix to remove listening to data on startup

+

+. 0.1.1.5

+  + Added icon to main menu

+  - Removed old hack for clist classic

+  + Changed variables to show unknown text when an info is not available and to, if tested with ?if(), return false

+

+. 0.1.1.4

+  + Added support for Miranda 0.8

+

+. 0.1.1.3

+  + Added variables to variables plugin. Now listening info can be used in away messages.

+  + Winamp plugin will reload info for current song at each 3s. This will make radio station names be handled better.

+

+. 0.1.1.2

+  + Added 'If other XStatus is not set, set XStatus to Music and show listening info'

+  * Changes in options dialog strings

+

+. 0.1.1.1

+  * Fix for IcoLib support

+

+. 0.1.1.0

+  + Added handling of XStatus

+  + Added IcoLib support

+  + Added langpack file

+  - Removed option to remove menu item (use menu order option dialog instead)

+

+. 0.1.0.9

+  + Option to set string to show when info is not avaible

+  * Changed host of files

+  * Changes for miranda 0.6 mmi

+  * fix for pressing configure in winamp

+

+. 0.1.0.8

+  * Fix for getting video info from winamp

+

+. 0.1.0.7

+  * Fixes for winamp 5.3

+  + Change internal struct. THIS VERSION IS NOT COMPATIBLE WITH PREVIOUS ONE. USE NEW VERSION OF PROTOCOLS.

+

+. 0.1.0.6

+  * More fixes for winamp

+  * Try tp fix (null) in MSN client

+

+. 0.1.0.5

+  * Fixes for WMP and winamp

+

+. 0.1.0.4

+  * Fixes in winamp plugin (first song was not set and pause was not handled)

+  + Added help file in listeningto dir

+  * WATrack integration works

+

+. 0.1.0.3

+  + Event to help My Details

+  * Fix for winamp stop playing

+

+. 0.1.0.2

+  + Made external plugin for winamp

+  + Option to auto-load plugin

+  + Listening to extra icon

+

+. 0.1.0.1

+  + More code to work with WATrack (don't work yet)

+  * Fixes

+

+. 0.1.0.0

+  + Initial version
\ No newline at end of file
diff --git a/plugins/ListeningTo/docs/listeningto_readme.txt b/plugins/ListeningTo/docs/listeningto_readme.txt
new file mode 100644
index 0000000000..6bbdd4cd5b
--- /dev/null
+++ b/plugins/ListeningTo/docs/listeningto_readme.txt
@@ -0,0 +1,25 @@
+ListeningTo plugin

+------------------

+

+This plugins allows to set/remove your listening info to protocols that support it. It also has basic support for getting this info from the players.

+

+This means that it set the user listening to information, not the info from your contacts. To see the info from your contacts you need a clist that supports it (only modern now) or a plugin like tipper (for a contact this info is stored inside <ProtocolName>/ListeningTo db key of the contact).

+

+Any protocol that support some services (in m_proto_listeningto.h) can interface with this plugin. By now it means JGmail unicode version, MSN and Jabber.

+

+This protocol also save the listening info for the user (you!) into <ProtocolName>/ListeningTo db key.

+

+This plugin is disbled by default. To enable it you need to use the main menu: Listening to->Send to all protocols or use My Details (the option is in popup menu).

+

+If you want this to implement some other player, I need a link to a page that explain how to do it, getting all the data, if possible without polling. (iTunes do it now but wont do in future). If you need more options, etc, use WATrack... This plugin is meant to be kept small.

+

+One last thing: when reporting bugs, please post the name and version of the player you are using.

+

+It also support Variables plugin to format the info, but it has to be the lastest version of the plugin. This version allows to use temporary variables in the replacement too, so you can use %artist%.

+

+Todo:

+- Better support for iTunes (it is not good now)

+

+To report bugs/make suggestions, go to the forum thread: http://forums.miranda-im.org/showthread.php?t=10912

+

+This plugin requires at least miranda 0.6, but is fully functional only in miranda 0.7
\ No newline at end of file
diff --git a/plugins/ListeningTo/docs/listeningto_version.txt b/plugins/ListeningTo/docs/listeningto_version.txt
new file mode 100644
index 0000000000..e0799e6484
--- /dev/null
+++ b/plugins/ListeningTo/docs/listeningto_version.txt
@@ -0,0 +1 @@
+ListeningTo 0.3.0.0
\ No newline at end of file
diff --git a/plugins/ListeningTo/docs/readme_players.txt b/plugins/ListeningTo/docs/readme_players.txt
new file mode 100644
index 0000000000..af2fce1c18
--- /dev/null
+++ b/plugins/ListeningTo/docs/readme_players.txt
@@ -0,0 +1,90 @@
+Some plugins in this folder can be automatically loaded into players. This means that you don't have to do nothing and the plugin will be loaded into the player when it is first detected running.

+

+For this to happen 3 things are needed:

+1. The following option must be enabled: "Allow auto-loading plugins into players (affect players with *)" (Inside Options->Status->Listening info->Players)

+2. The implementation allow this to happen (only Winamp by now)

+3. The plugin isn't loaded previously (aka it wasn't installed into player by the user)

+

+One warning: for the auto-loading to work, some inter-process messages have to happen (namelly code injection) and some anti-virus or firewalls can complain. Also, I don't know if this works if the user don't have admin rights.

+

+You also can install this plugins into the player yourself (and avoid the above warning). Instructions in how to do that are based on the player:

+

+- Winamp: copy the gen_mlt.dll to <WinampDir>\Plugins\gen_mlt.dll

+- foobar2000: copy the foo_mlt.dll to <FoobarDir>\components\foo_mlt.dll

+- QCD: can be found at http://test.quinnware.com/list_plugins.php?plugin=149

+- Songbird: you can use WMP support from http://addons.songbirdnest.com/addon/1204

+

+PS: Auto loading does not work on Win 9X

+

+

+

+

+

+------------------------------------------------------------------------------

+

+

+

+

+For developers: if you want to add support for listening to in your player, this is what you need to do:

+

+To send the info you have to create a unicode string with the format:

+L"<Status 0-stoped 1-playing>\\0<Player>\\0<Type>\\0<Title>\\0<Artist>\\0<Album>\\0<Track>\\0<Year>\\0<Genre>\\0<Length (secs)>\\0<Station name>\\0"

+(almost all fields are optional, except player name and title or artist) and pass it to SendData function.

+

+Some examples:

+ - Stopped playing:

+     SendData(L"0\\0My Player Name\\0\\0\\0\\0\\0\\0\\0\\0\\0\\0");

+ - New song:

+     SendData(L"1\\0My Player Name\\0Music\\0Title 1\\0Artist 1\\0Album 1\\001\\01997\\0\\0123\\0\\0\\0");

+ - New video:

+     SendData(L"1\\0My Player Name\\0Video\\0Title 1\\0\\0\\0\\0\\0\\0\\0\\0\\0");

+ - New radio song:

+     SendData(L"1\\0My Player Name\\0Radio\\0Title 1\\0Artist 1\\0\\0\\0\\0\\0\\0\\0X FM\\0");

+

+	

+	

+	

+

+// Code to send data

+	

+#define DATA_SIZE 1024

+#define MIRANDA_WINDOWCLASS _T("Miranda.ListeningTo")

+#define MIRANDA_DW_PROTECTION 0x8754

+

+

+BOOL CALLBACK EnumWindowsProc(HWND hwnd, LPARAM lParam)

+{

+	// Find the windows

+	TCHAR class_name[256];

+	if (GetClassName(hwnd, class_name, 256))

+	{

+		class_name[255] = _T('\0');

+

+		if (lstrcmpi(MIRANDA_WINDOWCLASS, class_name) == 0) 

+		{

+			COPYDATASTRUCT *cds = (COPYDATASTRUCT *) lParam;

+			SendMessage(hwnd, WM_COPYDATA, (WPARAM) NULL, (LPARAM) cds);

+		}

+	}

+

+	return TRUE;

+}

+

+inline void SendData(WCHAR *text) 

+{

+	static WCHAR lastMsg[DATA_SIZE] = L"";

+

+	if (wcscmp(lastMsg, text) == 0)

+		return;

+

+	// Prepare the struct

+	COPYDATASTRUCT cds;

+	cds.dwData = MIRANDA_DW_PROTECTION;

+	cds.lpData = text;

+	cds.cbData = (wcslen(text) + 1) * sizeof(WCHAR);

+

+	EnumWindows(EnumWindowsProc, (LPARAM) &cds);

+

+	wcsncpy(lastMsg, text, DATA_SIZE);

+	lastMsg[DATA_SIZE-1] = L'\0';

+}