httpget:dokumentation

Security Level 'read'

GETAUTOSERVICE

Action

Returns the status of httpGet autostart configuration

Arguments

p = the password

Return

1 if the service is set to start automatically
0 otherwise

Example

http://localhost:4800/getautoservice?p=pass

GETCURRENTTITLE

Action

Returns the title of the current song from the winamp window name. Used when the playlist title is not enough.
note: 0 will return at winamp startup and nothing is playing after it.

Arguments

p = the password

Return

Song title on success
0 otherwise

Example

http://localhost:4800/getcurrenttitle?p=pass

GETEQDATA

Action

Gets a band of eq data

Arguments

p = the password
band = The band of eq data
- 0-9: 10 bands of EQ data
- 10 : Preamp value
- 11 : Equalizer enabled
- 12 : Equalizer autoload

Return

0-9: 0-63 (+20db - -20db)
10 : 0-63 (+20db - -20db)
11 : Zero if disabled, nonzero if enabled
12 : Zero if disabled, nonzero if enabled

Example

http://localhost:4800/geteqdata?p=pass|band=8

GETLISTLENGTH

Action

Get the length of the current playlist, in tracks

Arguments

p = the password

Return

The length of the current playlist

Example

http://localhost:4800/getlistlength?p=pass

GETLISTPOS

Action

Gets the current index of the play list
note: The list is zero indexed so track 1 is index 0

Arguments

p = the password

Return

List position

Example

http://localhost:4800/getlistpos?p=pass

GETOUTPUTTIME

Action

Returns the position in milliseconds of the current song, or the song length, in seconds

Arguments

p = the password
frmt = 0 to get position (in ms) of current song or 1 to get length (in sec) of current song

Return

Position or Length of the current song
-1 if not playing when try to get position
0 on error

Example

http://localhost:4800/getoutputtime?p=pass|frmt=1

GETPLAYLISTFILE

Action

Returns a list of all the filenames in the playlist seperated by the specified delimiter

Arguments

p = the password
delim = The specified delimiter

Return

List of filenames on success
0 otherwise

Example

http://localhost:4800/getplaylistfile?p=pass|delim=;

GETPLAYLISTFILE

Action

Returns a list of all the filenames in the playlist seperated by the specified delimiter
note: the list is zero indexed so track 1 is 0.

Arguments

p = the password
index = index in the list from which to retrieve title.

Return

filename of track on success.
0 otherwise

Example

http://localhost:4800/getplaylistfile?p=pass|index=1

GETPLAYLISTTITLE

Action

Returns the title of the playlist entry at index 'index'
note: the list is zero indexed so track 1 is 0

Arguments

p = the password
index = index in the list from which to retrieve title

Return

Title of track on success
0 otherwise

Example

http://localhost:4800/getplaylisttitle?p=pass|index=1

GETPLAYLISTTITLE

Action

Returns a list of all the filenames in the playlist seperated by the specified delimiter
note: the list is zero indexed so track 1 is 0

Arguments

p = the password
delim = the specified delimieter.

Return

List of track titles on success
0 otherwise

Example

http://localhost:4800/getplaylisttitle?p=pass|delim=;

GETVERSION

Action

Get the current version of the winamp player

Arguments

p = the password

Return

Version of winamp
0 on error

Example

http://localhost:4800/getversion?p=pass

GETVOLUME

Action

Get the volume level

Arguments

p = the password

Return

volume level on success
0 otherwise

Example

http://localhost:4800/getvolume?p=pass

GETXML

Action

Returns the status of XML export

Arguments

p = the password

Return

1 if the httpGet returns as XML
0 otherwise

Example

http://localhost:4800/getxml?p=pass

INTERNET

Action

Checks for an internet conection

Arguments

p = the password

Return

1 if internect conecton exists
0 otherwise

Example

http://localhost:4800/internet?p=pass

ISPLAYING

Action

Get the playing status of winamp player

Arguments

p = the password

Return

0 = not playing
1 = playing
3 = paused

Example

http://localhost:4800/isplaying?p=pass

REPEAT_STATUS

Action

Gets the status of the repeat button

Arguments

p = the password

Return

1 if repeat is on
0 if repeat is off

Example

http://localhost:4800/repeat_status?p=pass

SHUFFLE_STATUS

Action

Gets the status of shuffle button

Arguments

p = the password

Return

1 on success
0 otherwise

Example

http://localhost:4800/shuffle_status?p=pass

UPDATECURRENTTITLE

Action

Like clicking on it

Arguments

p = the password

Return

1 on success
0 otherwise

Example

http://localhost:4800/updatecurrenttitle?p=pass

VALIDATE_PASSWORD

Action

Check a given string against the real password

Arguments

p = the password

Return

1 if passwords match
0 if passwords do not match

Example

http://localhost:4800/validate_password?pass=password

Security Level 'control'

CHDIR

Action

Change the working direcotry to 'argument'

Arguments

p = the password
dir = The path to the new current working directory

Return

1 on success
0 otherwise

Example

http://localhost:4800/chdir?p=pass|dir=d:\mp3

DELETE

Action

Clears the contents of the play list

Arguments

p = the password

Return

1 on success
0 otherwise

Example

http://localhost:4800/chdir?p=pass

DELETEPOS

Action

Deletes the playlist item at index 'argument'
note: The list is zero indexed so track 1 is index 0

Arguments

p = the password
index = Index in playlist to remove

Return

1 when index exists
0 otherwise
note: httpGet checks with GETLISTLENGTH if this index exists and try to delete it.

Example

http://localhost:4800/deletepos?p=pass|index=0

EXEC_VISUAL

Action

Launch the current visualization plugin

Arguments

p = the password

Return

1 on success
0 otherwise

Example

http://localhost:4800/exec_visual?p=pass

FADEOUTANDSTOP

Action

Fades out current song and stops playing

Arguments

p = the password

Return

1 on success
0 otherwise

Example

http://localhost:4800/fadeoutandstop?p=pass

FLUSHPLAYLIST

Action

Flushes the playlist cache buffer

Arguments

p = the password

Return

1 on success
0 otherwise

Example

http://localhost:4800/flushplaylist?p=pass

JUMPTOTIME

Action

Sets the position in milliseconds of the current song (approximately) to 'argument'

Arguments

p = the password
ms = Position in milliseconds to jump to

Return

1 on success
0 otherwise

Example

http://localhost:4800/jumptotime?p=pass|ms=1000

NEXT

Action

Like clicking on it.

Arguments

p = the password

Return

NULL

Example

http://localhost:4800/next?p=pass

PAUSE

Action

Like clicking on it.

Arguments

p = the password

Return

NULL

Example

http://localhost:4800/pause?p=pass

PLAY

Action

Like clicking on it.

Arguments

p = the password

Return

NULL

Example

http://localhost:4800/play?p=pass

PLAYFILE

Action

Appends a file to the playlist.
note: The file must be in the current working directory or pass in the directory along with the filename as the argument.

Arguments

p = the password
The file name to append to the playlist

Return

1 on success
0 otherwise

Example

http://localhost:4800/playfile?p=pass|file=c:\mp3\music.mp3

PREV

Action

Like clicking on it.

Arguments

p = the password

Return

NULL

Example

http://localhost:4800/prev?p=pass

REPEAT

Action

Toggle repeat on and off

Arguments

p = the password
enable = 0 to turn repeat off or 1 to turn repeat on

Return

1 on success
0 otherwise

Example

http://localhost:4800/repeat?p=pass|enable=1

RESTART

Action

Restarts Winamp and httpGet server
note: If the httpGet service is not set to start automatically, the httpGet server will not continue to accept connections.

Arguments

p = the password

Return

1 on success
0 on error

Example

http://localhost:4800/restart?p=pass

SETAUTOSERVICE

Action

Returns the status the httpGet autostart configuration

Arguments

p = the password
enable = 1 to set service to START or 0 to set service to NOT START automatically.

Return

1 if the service is set to start automatically
0 otherwise

Example

http://localhost:4800/setautoservice?p=pass|enable=1

SETEQDATA

Action

Sets the eq data at 'band' to 'level'

Arguments

p = the password
band = The eq band to set where possible values include:
- 0-9 : 10 bands of EQ data (0-63)
- 10 : Preamp value (0-63)
- 11 : Equalizer enabled (0-1)
- 12 : Equalizer autoload (0-1)
level = The level of the band setting

Return

1 on success
0 otherwise

Example

http://localhost:4800/seteqdata?p=pass|band=8|level=10

SETPLAYLISTPOS

Action

Sets the playlist position to 'argument'

Arguments

p = the password
index = Position to set play list to

Return

1 when index exists
0 otherwise
note: httpGet checks with GETLISTLENGTH if this index exists and try to set it.

Example

http://localhost:4800/setplaylistpos?p=pass|index=1000

SETVOLUME

Action

Set the volume level

Arguments

p = the password
level = 0-255 volume level

Return

1 on success
0 otherwise

Example

http://localhost:4800/setvolume?p=pass|level=100

SHUFFLE

Action

Set the volume level

Arguments

p = the password
enable = 1 to turn shuffle on or 0 to turn shuffle off

Return

1 if shuffle is on
0 otherwise

Example

http://localhost:4800/shuffle?p=pass|enable=0

STOP

Action

Like clicking on it.

Arguments

p = the password

Return

NULL

Example

http://localhost:4800/stop?p=pass

VOLUMEDOWN

Action

Turns down the volume

Arguments

p = the password

Return

NULL

Example

http://localhost:4800/volumedown?p=pass

VOLUMEUP

Action

Turns up the volume

Arguments

p = the password

Return

NULL

Example

http://localhost:4800/volumeup?p=pass

SETXML

Action

Returns the status of XML Export

Arguments

p = the password
enable = 1 to activate XML export or 0 to activate plaintext

Return

1 if the httpGet returns as XML
0 otherwise

Example

http://localhost:4800/setxml?p=pass|enable=1