Редакция 0.1 от 12-04-11
  ОБЩЕЕ
Плагин предназначен для поиска и скачивания в ознакомительных целях треков из социальной сети VKontakte.ru.
Его работа возможна благодаря приложению Aimp_vk_plugin, которое может быть заменено в файле настроек на собственное приложение.


  УСТАНОВКА.

Распакуйте архив и скопируйте файл aimp_vkontakte.dll в папку %AIMPCoreFolder%\PlugIns (часто это C:\Program Files\AIMP2\PlugIns или C:\Program Files\AIMP3\PlugIns).


  НАСТРОЙКА.

В принципе после установки плагин уже готов к использованию. Настройки хранятся в файле aimp_vkontakte.ini, который находится в папке %AppData%\AIMP или %AppData%\AIMP3.

Откройте окно настройки плагина (Главное меню - Плагины, спозиционируйтесь на плагине и нажмите на кнопку "Настройки").

- Раздел Прокси
Настройка использования прокси сервера осуществляется в окне настроек самого плеера - Плеер - Потоковое аудио. Для применения внесенных изменений в данной настройке необходимо перегрузить плеер.

- Раздел Скачивание
Установите уровень прозрачности окна скачивания трека (0 - невидимое/полностью прозрачное, 255 - непрозрачное, любое другое значение установит соответствующую прозрачность окна).
Установите флаг "Поверх всех окон" если хотите чтобы окно скачивания перекрывало все остальные окна.

- Раздел База композиций
Результаты поиска треков сохраняются в файле aimp_vkontakte.mdb, находящемся рядом с файлом настроек. Эти результаты необходимы только для того, чтобы подменять представление трека в плей-листе при начале его воспроизведения, а не давать ядру плеера обновить его на основании ID-тегов, прочитанных с самого трека. Очистить базу от треков, которых уже нет в текущем плей-листе можете, нажав на кнопку "Очистить от мусора".

- Раздел Плей-лист
Установите флаг "Определять приблизительный битрейт..." если хотите знать битрейт проигрываемого трека. Битрейт можно просмотреть в окне информации о файле (F4) или настроив шаблон отображения трека в плей-листе в настройках самого плеера (н.п. %IF(%a,%a - %T,%T) </%B>). Также битрейт будет отображаться в заголовке окна выбора имени файла для скачиваемого трека.
Установите флаг "Треки с одинаковой длиной являются дублями" чтобы в текущий плей-лист добавлялся только один из треков, равных по продолжительности.


  ИСПОЛЬЗОВАНИЕ.

- Поиск треков
Щелкните по кнопке "+" в окне плей-листа и выберите пункт "Поиск композиций ВКонтакте".
Выберите вариант поиска "Поиск по артисту..." или "Поиск по коллекции...".
При поиске по артисту, композиции, альбому внесите поисковый запрос, при желании укажите смещение поиска (VK API не позволяет выдавать более 200 треков на один запрос, а треков может быть гораздо большее количество, поэтому регулируя смещение поиска, можно добиться более полных результатов запроса по поиску треков), нажмите на кнопку "Найти". 
При поиске по коллекции выберите вариант "по юзеру" или "по группе" и в соседнем поле укажите id пользователя/группы (поиск по имени пользователя не поддерживается VK API).
Выполнится поиск, отсеются дубли и результат будет добавлен в текущий плей-лист.
Плагин автоматически попытается (именно попытается, так как AIMP SDK на данный момент не включает подходящего метода и переименовывать приходится посылая окну плеера сочетания клавиш) переименовать плей-лист в формате, необходимом для обновления ссылок. Переименовывание пока не работает в AIMP3. 

- Скачивание трека
Спозиционируйтесь на желаемом треке в плей-листе. Щелкните правой кнопкой мыши. Выберите пункт "Скачать композицию/файл". В открывшемся окне укажите путь и имя сохраняемого трека и нажмите на кнопку "Сохранить".
Скачивание возможно только если ссылка на трек начинается с "http://".

- Обновление устаревших ссылок
Спозиционируйтесь на любом треке или пустом месте в плей-листе. Щелкните правой кнопкой мыши. Выберите пункт "Обновить ссылки". Дождитесь обновления.
На данный момент найденные ссылки устаревают примерно на вторые сутки.
Обновление возможно только если имя плей-листа сформировано специальным образом.
Так как имя плей-листа содержит только последний поисковый запрос, то и в плей-лист будут добавлены треки только из этого запроса, а все остальные удалены.

- Добавление трека в плей-лист
Спозиционируйтесь на желаемом треке в плей-листе. Щелкните правой кнопкой мыши. Выберите пункт "Добавить в плей-лист ВКонтакте". Дождитесь окна, подтверждающего успешность ваших действий.
На данный момент добавление возможно только если у вас есть собственное приложение, вы знаете его Id и Secret и подключили его в файле настроек. Добавление осуществляется только в аудиозаписи вашего аккаунта.


  ПРОЧЕЕ

- Создание собственного приложения
На данный момент при создании приложения нельзя узнать его Secret, поэтому этот пункт описан не будет. Это касается и "старых" приложений, у которых это поле есть, но уже скрыто от глаз. Вызвано это переходом VK на авторизацию посредством OAuth. Если вы все же располагаете раритетным приложением и знаете все необходимые данные, то внесите их в файл настроек.

- Подключение приложения
Закройте плеер, если он был открыт. Откройте в редакторе файл aimp_vkontakte.ini, добавьте следующие строки:
AppID=%YourAccountID%
AppApiID=%YourApplicationID%
AppSecret=%YourApplicationSecret%
и заполните их соответствующими значениями (вместо параметров обрамленных знаком процента). Сохраните этот файл.