Repository: TheQwertiest/foo_spotify
Branch: master
Commit: ef3c0dd9fff1
Files: 226
Total size: 1.9 MB

Directory structure:
gitextract_nrm_lg86/

├── .appveyor.yml
├── .bandit
├── .codacy.yml
├── .gitattributes
├── .gitignore
├── .gitmodules
├── .license_index.txt
├── CHANGELOG.md
├── LICENSE
├── README.md
├── THIRD_PARTY_NOTICES.md
├── VERSION
├── foo_spotify/
│   ├── .clang-format
│   ├── .clang-tidy
│   ├── backend/
│   │   ├── audio_buffer.cpp
│   │   ├── audio_buffer.h
│   │   ├── libspotify_backend.cpp
│   │   ├── libspotify_backend.h
│   │   ├── libspotify_backend_user.h
│   │   ├── libspotify_key.h
│   │   ├── libspotify_wrapper.h
│   │   ├── spotify_instance.cpp
│   │   ├── spotify_instance.h
│   │   ├── spotify_object.cpp
│   │   ├── spotify_object.h
│   │   ├── webapi_auth.cpp
│   │   ├── webapi_auth.h
│   │   ├── webapi_auth_scopes.cpp
│   │   ├── webapi_auth_scopes.h
│   │   ├── webapi_backend.cpp
│   │   ├── webapi_backend.h
│   │   ├── webapi_cache.cpp
│   │   ├── webapi_cache.h
│   │   └── webapi_objects/
│   │       ├── webapi_album.cpp
│   │       ├── webapi_album.h
│   │       ├── webapi_artist.cpp
│   │       ├── webapi_artist.h
│   │       ├── webapi_image.cpp
│   │       ├── webapi_image.h
│   │       ├── webapi_media_objects.h
│   │       ├── webapi_paging_object.cpp
│   │       ├── webapi_paging_object.h
│   │       ├── webapi_playlist_track.cpp
│   │       ├── webapi_playlist_track.h
│   │       ├── webapi_restriction.cpp
│   │       ├── webapi_restriction.h
│   │       ├── webapi_track.cpp
│   │       ├── webapi_track.h
│   │       ├── webapi_track_link.cpp
│   │       ├── webapi_track_link.h
│   │       ├── webapi_user.cpp
│   │       └── webapi_user.h
│   ├── component_defines.h
│   ├── component_guids.h
│   ├── component_paths.cpp
│   ├── component_paths.h
│   ├── component_urls.h
│   ├── dllmain.cpp
│   ├── fb2k/
│   │   ├── acfu_integration.cpp
│   │   ├── advanced_config.cpp
│   │   ├── advanced_config.h
│   │   ├── album_art.cpp
│   │   ├── config.cpp
│   │   ├── config.h
│   │   ├── file_info_filler.cpp
│   │   ├── file_info_filler.h
│   │   ├── filesystem.cpp
│   │   ├── input.cpp
│   │   ├── playback.cpp
│   │   ├── playback.h
│   │   ├── playlist.cpp
│   │   └── playlist_loader.cpp
│   ├── foo_spotify.rc
│   ├── foo_spotify.rc2
│   ├── foo_spotify.vcxproj
│   ├── foo_spotify.vcxproj.filters
│   ├── packages.config
│   ├── resource.h
│   ├── stdafx.cpp
│   ├── stdafx.h
│   ├── ui/
│   │   ├── ui_ipref_tab.h
│   │   ├── ui_not_auth.cpp
│   │   ├── ui_not_auth.h
│   │   ├── ui_pref_tab_auth.cpp
│   │   ├── ui_pref_tab_auth.h
│   │   ├── ui_pref_tab_manager.cpp
│   │   ├── ui_pref_tab_manager.h
│   │   ├── ui_pref_tab_playback.cpp
│   │   └── ui_pref_tab_playback.h
│   └── utils/
│       ├── abort_manager.cpp
│       ├── abort_manager.h
│       ├── async_mutex.hpp
│       ├── cred_prompt.cpp
│       ├── cred_prompt.h
│       ├── json_macro_fix.h
│       ├── json_std_extenders.h
│       ├── rps_limiter.cpp
│       ├── rps_limiter.h
│       ├── secure_vector.h
│       ├── sleeper.cpp
│       └── sleeper.h
├── libspotify/
│   ├── ChangeLog
│   ├── LICENSE
│   ├── README
│   ├── docs/
│   │   ├── html/
│   │   │   ├── annotated.html
│   │   │   ├── api_8h.html
│   │   │   ├── browse_8c-example.html
│   │   │   ├── classes.html
│   │   │   ├── doxygen.css
│   │   │   ├── examples.html
│   │   │   ├── files.html
│   │   │   ├── functions.html
│   │   │   ├── functions_vars.html
│   │   │   ├── globals.html
│   │   │   ├── globals_0x69.html
│   │   │   ├── globals_0x73.html
│   │   │   ├── globals_0x74.html
│   │   │   ├── globals_defs.html
│   │   │   ├── globals_enum.html
│   │   │   ├── globals_eval.html
│   │   │   ├── globals_func.html
│   │   │   ├── globals_type.html
│   │   │   ├── group__album.html
│   │   │   ├── group__albumbrowse.html
│   │   │   ├── group__artist.html
│   │   │   ├── group__artistbrowse.html
│   │   │   ├── group__error.html
│   │   │   ├── group__image.html
│   │   │   ├── group__inbox.html
│   │   │   ├── group__link.html
│   │   │   ├── group__playlist.html
│   │   │   ├── group__search.html
│   │   │   ├── group__session.html
│   │   │   ├── group__toplist.html
│   │   │   ├── group__track.html
│   │   │   ├── group__types.html
│   │   │   ├── group__user.html
│   │   │   ├── index.html
│   │   │   ├── jukebox_8c-example.html
│   │   │   ├── modules.html
│   │   │   ├── search_8c-example.html
│   │   │   ├── structsp__audio__buffer__stats.html
│   │   │   ├── structsp__audioformat.html
│   │   │   ├── structsp__offline__sync__status.html
│   │   │   ├── structsp__playlist__callbacks.html
│   │   │   ├── structsp__playlistcontainer__callbacks.html
│   │   │   ├── structsp__session__callbacks.html
│   │   │   ├── structsp__session__config.html
│   │   │   ├── structsp__subscribers.html
│   │   │   ├── tabs.css
│   │   │   └── toplist_8c-example.html
│   │   └── images/
│   │       └── spotify-core.txt
│   ├── examples/
│   │   ├── Makefile
│   │   ├── Randomify/
│   │   │   ├── English.lproj/
│   │   │   │   ├── InfoPlist.strings
│   │   │   │   └── MainMenu.xib
│   │   │   ├── Randomify-Info.plist
│   │   │   ├── Randomify.xcodeproj/
│   │   │   │   └── project.pbxproj
│   │   │   ├── RandomifyAppDelegate.h
│   │   │   ├── RandomifyAppDelegate.m
│   │   │   ├── SpotifyPlaylist.h
│   │   │   ├── SpotifyPlaylist.m
│   │   │   ├── SpotifySession.h
│   │   │   ├── SpotifySession.m
│   │   │   ├── SpotifyTrack.h
│   │   │   ├── SpotifyTrack.m
│   │   │   └── main.m
│   │   ├── appkey.c
│   │   ├── common.mk
│   │   ├── jukebox/
│   │   │   ├── Makefile
│   │   │   ├── alsa-audio.c
│   │   │   ├── audio.c
│   │   │   ├── audio.h
│   │   │   ├── dummy-audio.c
│   │   │   ├── jukebox.c
│   │   │   ├── openal-audio.c
│   │   │   ├── osx/
│   │   │   │   └── jukebox.xcodeproj/
│   │   │   │       └── project.pbxproj
│   │   │   ├── osx-audio.c
│   │   │   ├── playtrack.c
│   │   │   └── queue.h
│   │   ├── localfiles/
│   │   │   ├── Makefile
│   │   │   ├── main.c
│   │   │   └── main.h
│   │   ├── spshell/
│   │   │   ├── Makefile
│   │   │   ├── browse.c
│   │   │   ├── cmd.c
│   │   │   ├── cmd.h
│   │   │   ├── inbox.c
│   │   │   ├── osx/
│   │   │   │   └── spshell.xcodeproj/
│   │   │   │       └── project.pbxproj
│   │   │   ├── playlist.c
│   │   │   ├── scrobbling.c
│   │   │   ├── search.c
│   │   │   ├── spshell.c
│   │   │   ├── spshell.h
│   │   │   ├── spshell_posix.c
│   │   │   ├── spshell_win32.c
│   │   │   ├── star.c
│   │   │   ├── test.c
│   │   │   ├── toplist.c
│   │   │   └── win32/
│   │   │       ├── spshell.vcproj
│   │   │       ├── spshell.vcxproj
│   │   │       └── spshell.vcxproj.filters
│   │   └── stub/
│   │       ├── Makefile
│   │       ├── main.c
│   │       └── main.h
│   ├── include/
│   │   └── libspotify/
│   │       └── api.h
│   ├── lib/
│   │   └── libspotify.lib
│   └── licenses.xhtml
├── licenses/
│   ├── JSON for Modern C++.txt
│   ├── LibSpotify.txt
│   ├── PFC.txt
│   ├── WTL.txt
│   ├── fmt.txt
│   ├── foobar2000 SDK.txt
│   ├── range-v3.txt
│   ├── ring-span-lite.txt
│   └── span-lite.txt
├── props/
│   ├── local_dependencies/
│   │   └── libspotify.props
│   └── submodules/
│       ├── fb2k_utils.props
│       └── submodules.props
├── scripts/
│   ├── README.md
│   ├── call_wrapper.py
│   ├── download_submodules.py
│   ├── pack_component.py
│   ├── setup.py
│   └── update_gh_pages.py
└── workspaces/
    └── foo_spotify.sln

================================================
FILE CONTENTS
================================================

================================================
FILE: .appveyor.yml
================================================

#---------------------------------#
#      general configuration      #
#---------------------------------#

# version format
version: 1.0.{build}-{branch}

# branches to build
branches:
  # blacklist
  except:
    - gh-pages

# Skipping commits affecting specific files (GitHub only). More details here: /docs/appveyor-yml
skip_commits:
  # Default `skip` messages are applied even on tag builds with APPVEYOR_IGNORE_COMMIT_FILTERING_ON_TAG==true
  message: /\[_skip ci_\]|\[_ci skip_\]|\[_skip_ci_\]|\[_ci_skip_\]/
  files:
    - README.md
    - THIRD_PARTY_NOTICES.md
#    - docs/*
#    - '**/*.png'
#    - '**/*.jpg'
#    - '**/*.jpeg'
#    - '**/*.bmp'
#    - '**/*.gif'
#    - '**/*.js'
#    - '**/*.txt'
#    - '**/*.md'

# Maximum number of concurrent jobs for the project
max_jobs: 1

#---------------------------------#
#    environment configuration    #
#---------------------------------#

# Build worker image (VM template)
image: Visual Studio 2019

# environment variables
environment:
  APPVEYOR_IGNORE_COMMIT_FILTERING_ON_TAG: true
  git_user_email: qwertiest@mail.ru
  git_user_name: TheQwertiest
  GITHUB_TOKEN:
    secure: gBfHQnRcGcTS0yQXWOHhKfDkTZfIBwPIDjTsCQOGmOSPkRqs1QPYBX47BjCvJKim

# this is how to allow failing jobs in the matrix
matrix:
  fast_finish: true     # set this flag to immediately finish build once one of the jobs fails.

cache:
  - workspaces\packages -> **\packages.config
  - c:\tools\vcpkg\installed

# scripts that run after cloning repository
install:
  #  vcpkg
  - cd C:\Tools\vcpkg
  - git pull
  - .\bootstrap-vcpkg.bat
  - cd %APPVEYOR_BUILD_FOLDER%
  - vcpkg remove --outdated --recurse
  - cmd: set VCPKG_PLATFORM_TOOLSET=v142
  - vcpkg install cpprestsdk:x86-windows-static
  - vcpkg integrate install
  # GitHub CLI
  - choco install gh -y
  - refreshenv
  - gh config set -h github.com git_protocol https
  # PIP
  - py -3 -m pip install semver
  # Component
  - py -u scripts\setup.py

#---------------------------------#
#       build configuration       #
#---------------------------------#

# build platform, i.e. x86, x64, Any CPU. This setting is optional.
platform:
  - Win32

# build Configuration, i.e. Debug, Release, etc.
configuration:
  - Debug
  - Release

# Build settings, not to be confused with "before_build" and "after_build".
# "project" is relative to the original build directory and not influenced by directory changes in "before_build".
build:
  parallel: true                  # enable MSBuild parallel builds
  project: workspaces\foo_spotify.sln      # path to Visual Studio solution or project

  # MSBuild verbosity level
  verbosity: normal

# scripts to run before build
before_build:
  - nuget restore workspaces\foo_spotify.sln

# to run your custom scripts instead of automatic MSBuild
build_script:

# scripts to run after build (working directory and environment changes are persisted from the previous steps)
after_build:

# scripts to run *after* solution is built and *before* automatic packaging occurs (web apps, NuGet packages, Azure Cloud Services)
before_package:
  - if '%configuration%' == 'Debug' (
      py -u scripts\pack_component.py --debug &&
      ren "_result\%platform%_%configuration%\foo_spotify.fb2k-component" "foo_spotify.fb2k-component_debug"
    )
    else (
      py -u scripts\pack_component.py
    )

# to disable automatic builds
#build: off

#---------------------------------#
#      artifacts configuration    #
#---------------------------------#

artifacts:
  # pushing a single file with environment variable in path and "Deployment name" specified
  - path: _result\$(platform)_$(configuration)\foo_spotify.fb2k-component
    name: SPTF package (Release)
  - path: _result\$(platform)_$(configuration)\foo_spotify_pdb.zip
    name: SPTF PDB package (Release)
  - path: _result\$(platform)_$(configuration)\foo_spotify.fb2k-component_debug
    name: SPTF package (Debug)

#---------------------------------#
#     deployment configuration    #
#---------------------------------#

# providers: Local, FTP, WebDeploy, AzureCS, AzureBlob, S3, NuGet, Environment
# provider names are case-sensitive!
deploy:
  description: 'Dummy description'
  provider: GitHub
  auth_token: $(GITHUB_TOKEN)
  artifact: /foo_spotify.*/           # upload all NuGet packages to release assets
  prerelease: true
  on:
    branch: master                 # release from master branch only
    appveyor_repo_tag: true        # deploy on tag push only


# scripts to run before deployment
before_deploy:

# scripts to run after deployment
after_deploy:

# to run your custom scripts instead of provider deployments
deploy_script:

# to disable deployment
# deploy: off

#---------------------------------#
#        global handlers          #
#---------------------------------#

# on successful build
on_success:
  # issues clean up
  - ps: |
        If ($env:APPVEYOR_REPO_TAG -eq $true -and $env:CONFIGURATION -eq "Release")
        {
          py -u submodules\fb2k_utils\scripts\close_gh_issues.py
        }
  # gh-pages
  - ps: |
        If ($env:APPVEYOR_REPO_TAG -eq $true -and $env:CONFIGURATION -eq "Release")
        {
          git config --global credential.helper store
          Add-Content "$env:USERPROFILE\.git-credentials" "https://$($env:GITHUB_TOKEN):x-oauth-basic@github.com`n"
          git config --global user.email $env:git_user_email
          git config --global user.name $env:git_user_name
          git clone -q --depth=1 -b gh-pages https://github.com/$($env:APPVEYOR_REPO_NAME).git gh-pages
          py -u scripts\update_gh_pages.py
          cd gh-pages
          git add -A 2>&1
          git commit -q -m "Updated documentation: $env:APPVEYOR_REPO_TAG_NAME ($env:APPVEYOR_REPO_COMMIT)"
          git push -q origin gh-pages
          cd $env:APPVEYOR_BUILD_FOLDER
        }

# on build failure
on_failure:

# after build failure or success
on_finish:

#---------------------------------#
#         notifications           #
#---------------------------------#

notifications:


================================================
FILE: .bandit
================================================
skips: ['B101','B404','B602','B607']


================================================
FILE: .codacy.yml
================================================
engines:
  prospector:
    enabled: true
    python_version: 3
  pylint:
    enabled: true
    python_version: 3
exclude_paths:
  - 'libspotify/**'
  - 'submodules/**'

================================================
FILE: .gitattributes
================================================
# Auto detect text files and perform LF normalization
* text=auto
# Custom for Visual Studio
*.cs     diff=csharp
# Standard to msysgit
*.doc	 diff=astextplain
*.DOC	 diff=astextplain
*.docx diff=astextplain
*.DOCX diff=astextplain
*.dot  diff=astextplain
*.DOT  diff=astextplain
*.pdf  diff=astextplain
*.PDF	 diff=astextplain
*.rtf	 diff=astextplain
*.RTF	 diff=astextplain
*.zip filter=lfs diff=lfs merge=lfs -text

libspotify/* linguist-detectable=false
scripts/* linguist-detectable=false


================================================
FILE: .gitignore
================================================
# Created by https://www.gitignore.io/api/visualstudio

### VisualStudio ###
## Ignore Visual Studio temporary files, build results, and
## files generated by popular Visual Studio add-ons.

# User-specific files
*.suo
*.user
*.userosscache
*.sln.docstates

# User-specific files (MonoDevelop/Xamarin Studio)
*.userprefs

# Build results
/_*
*.fb2k-component
[Dd]ebug/
[Dd]ebugPublic/
[Dd]ebug FB2K/
[Rr]elease/
[Rr]eleases/
[Rr]elease FB2K/
x64/
x86/
bld/
[Bb]in/
[Oo]bj/
[Ll]og/

# Visual Studio 2015 cache/options directory
.vs/
# Uncomment if you have tasks that create the project's static files in wwwroot
#wwwroot/

# MSTest test Results
[Tt]est[Rr]esult*/
[Bb]uild[Ll]og.*

# NUNIT
*.VisualState.xml
TestResult.xml

# Build Results of an ATL Project
[Dd]ebugPS/
[Rr]eleasePS/
dlldata.c

# DNX
project.lock.json
project.fragment.lock.json
artifacts/

*_i.c
*_p.c
*_i.h
*.ilk
*.meta
*.obj
*.pch
*.pdb
*.pgc
*.pgd
*.rsp
*.sbr
*.tlb
*.tli
*.tlh
*.tmp
*.tmp_proj
*.log
*.vspscc
*.vssscc
.builds
*.pidb
*.svclog
*.scc

# Chutzpah Test files
_Chutzpah*

# Visual C++ cache files
ipch/
*.aps
*.ncb
*.opendb
*.opensdf
*.sdf
*.cachefile
*.VC.db
*.VC.VC.opendb

# Visual Studio profiler
*.psess
*.vsp
*.vspx
*.sap

# TFS 2012 Local Workspace
$tf/

# Guidance Automation Toolkit
*.gpState

# ReSharper is a .NET coding add-in
_ReSharper*/
*.[Rr]e[Ss]harper
*.DotSettings.user

# JustCode is a .NET coding add-in
.JustCode

# TeamCity is a build add-in
_TeamCity*

# DotCover is a Code Coverage Tool
*.dotCover

# Visual Studio code coverage results
*.coverage
*.coveragexml

# NCrunch
_NCrunch_*
.*crunch*.local.xml
nCrunchTemp_*

# MightyMoose
*.mm.*
AutoTest.Net/

# Web workbench (sass)
.sass-cache/

# Installshield output folder
[Ee]xpress/

# DocProject is a documentation generator add-in
DocProject/buildhelp/
DocProject/Help/*.HxT
DocProject/Help/*.HxC
DocProject/Help/*.hhc
DocProject/Help/*.hhk
DocProject/Help/*.hhp
DocProject/Help/Html2
DocProject/Help/html

# Click-Once directory
publish/

# Publish Web Output
*.[Pp]ublish.xml
*.azurePubxml
# TODO: Comment the next line if you want to checkin your web deploy settings
# but database connection strings (with potential passwords) will be unencrypted
*.pubxml
*.publishproj

# Microsoft Azure Web App publish settings. Comment the next line if you want to
# checkin your Azure Web App publish settings, but sensitive information contained
# in these scripts will be unencrypted
PublishScripts/

# NuGet Packages
*.nupkg
# The packages folder can be ignored because of Package Restore
**/packages/*
# except build/, which is used as an MSBuild target.
!**/packages/build/
# Uncomment if necessary however generally it will be regenerated when needed
#!**/packages/repositories.config
# NuGet v3's project.json files produces more ignoreable files
*.nuget.props
*.nuget.targets

# Microsoft Azure Build Output
csx/
*.build.csdef

# Microsoft Azure Emulator
ecf/
rcf/

# Windows Store app package directories and files
AppPackages/
BundleArtifacts/
Package.StoreAssociation.xml
_pkginfo.txt

# Visual Studio cache files
# files ending in .cache can be ignored
*.[Cc]ache
# but keep track of directories ending in .cache
!*.[Cc]ache/

# Others
ClientBin/
~$*
*~
*.dbmdl
*.dbproj.schemaview
*.jfm
*.pfx
*.publishsettings
node_modules/
orleans.codegen.cs

# Since there are multiple workflows, uncomment next line to ignore bower_components
# (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)
#bower_components/

# RIA/Silverlight projects
Generated_Code/

# Backup & report files from converting an old project file
# to a newer Visual Studio version. Backup files are not needed,
# because we have git ;-)
_UpgradeReport_Files/
Backup*/
UpgradeLog*.XML
UpgradeLog*.htm

# SQL Server files
*.mdf
*.ldf

# Business Intelligence projects
*.rdl.data
*.bim.layout
*.bim_*.settings

# Microsoft Fakes
FakesAssemblies/

# GhostDoc plugin setting file
*.GhostDoc.xml

# Node.js Tools for Visual Studio
.ntvs_analysis.dat

# Visual Studio 6 build log
*.plg

# Visual Studio 6 workspace options file
*.opt

# Visual Studio LightSwitch build output
**/*.HTMLClient/GeneratedArtifacts
**/*.DesktopClient/GeneratedArtifacts
**/*.DesktopClient/ModelManifest.xml
**/*.Server/GeneratedArtifacts
**/*.Server/ModelManifest.xml
_Pvt_Extensions

# Paket dependency manager
.paket/paket.exe
paket-files/

# FAKE - F# Make
.fake/

# JetBrains Rider
.idea/
*.sln.iml

# CodeRush
.cr/

# Python Tools for Visual Studio (PTVS)
__pycache__/
*.pyc

### VisualStudio Patch ###
build/


================================================
FILE: .gitmodules
================================================
[submodule "submodules/acfu-sdk"]
	path = submodules/acfu-sdk
	url = https://github.com/3dyd/acfu-sdk/
[submodule "submodules/fmt"]
	path = submodules/fmt
	url = https://github.com/fmtlib/fmt
	branch = release
[submodule "submodules/foobar2000"]
	path = submodules/foobar2000
	url = https://github.com/TheQwertiest/foobar2000-sdk
[submodule "submodules/pfc"]
	path = submodules/pfc
	url = https://github.com/TheQwertiest/pfc
[submodule "submodules/range"]
	path = submodules/range
	url = https://github.com/ericniebler/range-v3
[submodule "submodules/span"]
	path = submodules/span
	url = https://github.com/martinmoene/span-lite
[submodule "submodules/json"]
	path = submodules/json
	url = https://github.com/nlohmann/json.git
	branch = master
[submodule "submodules/wtl"]
	path = submodules/wtl
	url = https://git.code.sf.net/p/wtl/git
[submodule "submodules/fb2k_utils"]
	path = submodules/fb2k_utils
	url = https://github.com/TheQwertiest/fb2k_utils.git
[submodule "submodules/ring-span"]
	path = submodules/ring-span
	url = https://github.com/martinmoene/ring-span-lite.git


================================================
FILE: .license_index.txt
================================================
foobar2000 SDK: other
fmt: other
JSON for Modern C++: MIT
LibSpotify: other
PFC: zlib
range-v3: BSL-1.0
ring-span-lite: BSL-1.0
span-lite: BSL-1.0
WTL: MS-PL


================================================
FILE: CHANGELOG.md
================================================
# Changelog

#### Table of Contents
- [Unreleased](#unreleased)
- [1.1.3](#113---2021-02-18)
- [1.1.2](#112---2020-11-03)
- [1.1.1](#111---2020-10-27)
- [1.1.0](#110---2020-10-26)
- [1.0.2](#102---2020-10-04)
- [1.0.1](#101---2020-10-03)
- [1.0.0](#100---2020-10-02)

___

## [Unreleased][]

## [1.1.3][] - 2021-02-18

### Fixed
- Fixed broken import-by-URL handling ([#47](https://github.com/TheQwertiest/foo_spotify/issues/47)).
- Fixed some issues with keyboard navigation in component menu in Preferences.

## [1.1.2][] - 2020-11-03

### Changed
- Better Web API handling in attempt to avoid 429 errors:
  - Pre-emptive batch artist update on album import ([#36](https://github.com/TheQwertiest/foo_spotify/issues/36)).

### Fixed
- Unreasonably high CPU usage in some scenarios ([#35](https://github.com/TheQwertiest/foo_spotify/issues/35)).
- Rps limiter is not working ([#34](https://github.com/TheQwertiest/foo_spotify/issues/34)).
- Extra silence at the end of track ([#33](https://github.com/TheQwertiest/foo_spotify/issues/33)).

## [1.1.1][] - 2020-10-27

### Changed
- Better Web API handling in attempt to avoid 429 errors:
  - Pre-emptive batch artist update on playlist import ([#32](https://github.com/TheQwertiest/foo_spotify/issues/32)).

## [1.1.0][] - 2020-10-26

### Added
- *Play* the artist: adds top tracks for the artist ([#15](https://github.com/TheQwertiest/foo_spotify/issues/15)).
- `%codec%` metadata field ([#14](https://github.com/TheQwertiest/foo_spotify/issues/14)).
- More options in `Preferences`:
  - Cache size configuration ([#23](https://github.com/TheQwertiest/foo_spotify/issues/23)).
  - Spotify `private mode` option ([#13](https://github.com/TheQwertiest/foo_spotify/issues/13)).
  - Spotify normalization option ([#12](https://github.com/TheQwertiest/foo_spotify/issues/12)).

### Changed
- Better Web API handling in attempt to avoid 429 errors:
  - RPS limit ([#27](https://github.com/TheQwertiest/foo_spotify/issues/27)).
  - `retry-after` response header handling ([#11](https://github.com/TheQwertiest/foo_spotify/issues/11)).
  - Pre-emptive batch track update on playlist change ([#30](https://github.com/TheQwertiest/foo_spotify/issues/30)).
  - Pre-emptive batch artist update on playlist change ([#31](https://github.com/TheQwertiest/foo_spotify/issues/31)).
- Improved error message when track is not available in user's country ([#8](https://github.com/TheQwertiest/foo_spotify/issues/8)).

### Fixed
- Can't relogin without closing Preferences dialog ([#24](https://github.com/TheQwertiest/foo_spotify/issues/24)).
- Dynamic info change is signaled too frequently, despite data being the same ([#22](https://github.com/TheQwertiest/foo_spotify/issues/22)).
- Can't play tracks when buffering is enabled in fb2k ([#21](https://github.com/TheQwertiest/foo_spotify/issues/21)).
- Crash: Illegal operation ([#19](https://github.com/TheQwertiest/foo_spotify/issues/19)).
- Multi-value tags are not displayed correctly ([#17](https://github.com/TheQwertiest/foo_spotify/issues/17)).
- Can't import playlists with local tracks ([#16](https://github.com/TheQwertiest/foo_spotify/issues/16), [#18](https://github.com/TheQwertiest/foo_spotify/issues/18)).

## [1.0.2][] - 2020-10-04

### Added
- Proxy support ([#6](https://github.com/TheQwertiest/foo_spotify/issues/6)).
- Adjust bit-rate via `Preferences` ([#5](https://github.com/TheQwertiest/foo_spotify/issues/5)).
- Bit-rate metadata for playing track ([#4](https://github.com/TheQwertiest/foo_spotify/issues/4)).

### Fixed
- Fails to open track that has null `preview_url` ([#3](https://github.com/TheQwertiest/foo_spotify/issues/3)).

## [1.0.1][] - 2020-10-03

### Fixed
- LibSpotify login doesn't always work ([#1](https://github.com/TheQwertiest/foo_spotify/issues/1)).

## [1.0.0][] - 2020-10-02
Initial release.

[unreleased]: https://github.com/TheQwertiest/foo_spotify/compare/v1.1.3...HEAD
[1.1.3]: https://github.com/TheQwertiest/foo_spotify/compare/v1.1.2...v1.1.3
[1.1.2]: https://github.com/TheQwertiest/foo_spotify/compare/v1.1.1...v1.1.2
[1.1.1]: https://github.com/TheQwertiest/foo_spotify/compare/v1.1.0...v1.1.1
[1.1.0]: https://github.com/TheQwertiest/foo_spotify/compare/v1.0.2...v1.1.0
[1.0.2]: https://github.com/TheQwertiest/foo_spotify/compare/v1.0.1...v1.0.2
[1.0.1]: https://github.com/TheQwertiest/foo_spotify/compare/v1.0.0...v1.0.1
[1.0.0]: https://github.com/TheQwertiest/foo_spotify/commits/master


================================================
FILE: LICENSE
================================================
MIT License

Copyright (c) 2018-2020 Yuri Shutenko

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.


================================================
FILE: README.md
================================================
# Spotify Integration
[![version][version_badge]][changelog] [![Build status][appveyor_badge]](https://ci.appveyor.com/project/TheQwertiest/foo-spotify/branch/master) [![CodeFactor][codefactor_badge]](https://www.codefactor.io/repository/github/theqwertiest/foo_spotify/overview/master) [![Codacy Badge][codacy_badge]](https://www.codacy.com/gh/TheQwertiest/foo_spotify/dashboard?utm_source=github.com&utm_medium=referral&utm_content=TheQwertiest/foo_spotify&utm_campaign=Badge_Grade) 

**!!! This component is no longer being developed. See [#68](https://github.com/TheQwertiest/foo_spotify/issues/68) for more info !!!**

This is a component for the [foobar2000](https://www.foobar2000.org) audio player, which allows to play tracks from Spotify.

Visit [component homepage](https://theqwertiest.github.io/foo_spotify/) for more info.

[changelog]: CHANGELOG.md
[version_badge]: https://img.shields.io/github/release/theqwertiest/foo_spotify.svg
[appveyor_badge]: https://ci.appveyor.com/api/projects/status/t5bhoxmfgavhq81m/branch/master?svg=true
[codacy_badge]: https://app.codacy.com/project/badge/Grade/c2d3b3a99ce640ad8c1512784e15910f
[codefactor_badge]: https://www.codefactor.io/repository/github/theqwertiest/foo_spotify/badge/master


================================================
FILE: THIRD_PARTY_NOTICES.md
================================================
Spotify Integration uses third-party libraries or other resources that may
be distributed under licenses different than the Spotify Integration software.
The linked notices are provided for information only.

- [foobar2000 SDK - other](licenses/foobar2000%20SDK.txt)
- [fmt - other](licenses/fmt.txt)
- [JSON for Modern C++ - MIT](licenses/JSON%20for%20Modern%20C%2B%2B.txt)
- [LibSpotify - other](licenses/LibSpotify.txt)
- [PFC - zlib](licenses/PFC.txt)
- [range-v3 - BSL-1.0](licenses/range-v3.txt)
- [ring-span-lite - BSL-1.0](licenses/ring-span-lite.txt)
- [span-lite - BSL-1.0](licenses/span-lite.txt)
- [WTL - MS-PL](licenses/WTL.txt)


================================================
FILE: VERSION
================================================
1.1.4-beta


================================================
FILE: foo_spotify/.clang-format
================================================
---
BasedOnStyle: Mozilla
AccessModifierOffset: '-4'
AlwaysBreakAfterDefinitionReturnType: 'false'
AlignAfterOpenBracket: Align
AlignConsecutiveAssignments: 'false'
AlignConsecutiveMacros: 'true'
AlignEscapedNewlines: Left
AlignOperands: 'true'
AllowShortBlocksOnASingleLine: 'false'
AllowShortCaseLabelsOnASingleLine: 'false'
AllowShortFunctionsOnASingleLine: None
AllowShortIfStatementsOnASingleLine: 'false'
AllowShortLoopsOnASingleLine: 'false'
AlwaysBreakAfterReturnType: None
AlwaysBreakTemplateDeclarations: 'true'
BinPackParameters: 'true'
BreakBeforeBinaryOperators: NonAssignment
BreakBeforeBraces: Allman
BreakBeforeInheritanceComma: 'true'
BreakConstructorInitializers: BeforeComma
ColumnLimit: '0'
ConstructorInitializerIndentWidth: '4' 
ContinuationIndentWidth: '4'
Cpp11BracedListStyle: 'false'
FixNamespaceComments: 'true'
IncludeBlocks: Regroup
IncludeCategories: 
  # precompiled headers
  - Regex:           '^<stdafx.h|pch.h|precompiled.h>'
    Priority:        -1
  # "header"
  - Regex:           '"[[:alnum:]_]+'
    Priority:        1
  # <dependency/header>
  - Regex:           '^<(acfu-sdk|cpprest|columns_ui-sdk|fmt|foobar2000|js|libspotify|nlohmann|nonstd|range|tim|qwr)/'
    Priority:        4 
  # <dependency_header>
  - Regex:           '^<(atl.*\.h)>'
    Priority:        5
  # <subdir/header.h>|<subdir/header.hpp>
  - Regex:           '<[[:alnum:]_]+/.+\.(h|hpp)>'
    Priority:        2
  # <header.h>|<header.hpp>
  - Regex:           '<[[:alnum:]_]+\.(h|hpp)>'
    Priority:        3
  # <header>
  - Regex:           '<[[:alnum:]_]+>'
    Priority:        6
IncludeIsMainRegex: '$'
IndentCaseLabels: false
IndentPPDirectives: AfterHash
IndentWidth: '4'
IndentWrappedFunctionNames: false
Language: Cpp
MacroBlockBegin: "^BEGIN_*"
MacroBlockEnd: "^END_*"
MaxEmptyLinesToKeep: '1'
PointerAlignment: Left
ReflowComments: 'true'
SortIncludes: 'false'
SpaceAfterCStyleCast: 'false'
SpaceAfterTemplateKeyword : 'true'
SpaceBeforeAssignmentOperators: 'true'
SpaceBeforeParens: ControlStatements
SpaceBeforeRangeBasedForLoopColon: 'false'
SpaceInEmptyParentheses: 'false'
SpacesInAngles: 'false'
SpacesInCStyleCastParentheses: 'false'
SpacesInParentheses: 'true'
SpacesInSquareBrackets: 'false'
SortIncludes: 'true'
Standard: Cpp11
TabWidth: '4'
TypenameMacros: ['STDMETHOD', 'STDMETHODIMP_']
UseTab: Never

...


================================================
FILE: foo_spotify/.clang-tidy
================================================
Checks: '-*,
         bugprone-*,
         cert-*,
         clang-analyzer-*,
         google-*,
         -google-build-using-namespace,
         -google-explicit-constructor,
         -google-readability-todo,
         -google-runtime-references,
         hicpp-*,
         -hicpp-explicit-conversions,
         -hicpp-no-array-decay,
         -hicpp-signed-bitwise,
         -hicpp-uppercase-literal-suffix,
         misc-*,
         -misc-non-private-member-variables-in-classes,
         llvm-*,
         -llvm-include-order,
         -llvm-header-guard,
         -llvm-namespace-comment,
         modernize-*,
         -modernize-use-trailing-return-type,
         performance-*,
         portability-*,
         readability-*,
         -readability-else-after-return,
         -readability-implicit-bool-conversion,
         -readability-magic-numbers,
         -readability-named-parameter,
         -readability-redundant-access-specifiers,
         -readability-uppercase-literal-suffix'


================================================
FILE: foo_spotify/backend/audio_buffer.cpp
================================================
#include <stdafx.h>

#include "audio_buffer.h"

#include <utils/abort_manager.h>

namespace sptf
{

AudioBuffer::AudioBuffer( AbortManager& abortManager )
    : abortManager_( abortManager )
{
}

bool AudioBuffer::write( AudioChunkHeader header, const uint16_t* data )
{
    {
        std::lock_guard lock( posMutex_ );

        const size_t readPos = readPos_;
        const size_t writePos = writePos_;
        const size_t waterMark = waterMark_;
        const size_t writeSize = k_headerSizeInU16 + header.size;

        const auto writeData = [&]( size_t writePos ) {
            const auto curBufferPos = begin_ + writePos;
            std::copy( &header, &header + 1, reinterpret_cast<AudioChunkHeader*>( curBufferPos ) );
            std::copy( data, data + header.size, curBufferPos + k_headerSizeInU16 );
        };

        // TODO: simplify the code
        if ( writePos >= readPos ) // write leads
        {
            if ( size_ - writePos >= writeSize )
            {
                writeData( writePos );

                writePos_ = writePos + writeSize;
                waterMark_ = size_;
            }
            else // wrap-around
            {
                if ( !readPos || readPos - 1 < writeSize )
                {
                    return false;
                }

                writeData( 0 );

                writePos_ = writeSize;
                waterMark_ = writePos;
            }
        }
        else // read leads
        {
            if ( readPos - 1 - writePos < writeSize )
            {
                return false;
            }

            writeData( writePos );

            writePos_ = writePos + writeSize;
        }
    }

    dataCv_.notify_all();
    return true;
}

void AudioBuffer::write_end()
{
    uint16_t dummy{};
    write( AudioChunkHeader{ 0, 0, 0, 1 }, &dummy );
}

bool AudioBuffer::has_data() const
{
    std::lock_guard lock( posMutex_ );

    return has_data_no_lock();
}

bool AudioBuffer::wait_for_data( abort_callback& abort )
{
    const auto abortableScope = abortManager_.GetAbortableScope( [&] { dataCv_.notify_all(); }, abort );

    std::unique_lock lock( posMutex_ );
    dataCv_.wait( lock, [&] {
        return ( has_data_no_lock() || abort.is_aborting() );
    } );
    return has_data_no_lock();
}

void AudioBuffer::clear()
{
    {
        std::lock_guard lock( posMutex_ );

        readPos_ = 0;
        writePos_ = 0;
        waterMark_ = size_;
    }
    dataCv_.notify_all();
}

bool AudioBuffer::has_data_no_lock() const
{
    return ( readPos_ != writePos_ );
}

} // namespace sptf


================================================
FILE: foo_spotify/backend/audio_buffer.h
================================================
#pragma once

#include <nonstd/span.hpp>

#include <array>
#include <atomic>
#include <mutex>

namespace sptf
{

class AbortManager;

// TODO: bench and replace with lock-free if needed
class AudioBuffer
{
    static constexpr size_t k_maxBufferSize = 8UL * 1024 * 1024;

public:
#pragma pack( push )
#pragma pack( 1 )
    struct AudioChunkHeader
    {
        uint32_t sampleRate;
        uint16_t channels;
        uint32_t size;
        uint16_t eof;
    };
#pragma pack( pop )

private:
    static constexpr size_t k_headerSizeInU16 = sizeof( AudioChunkHeader ) / sizeof( uint16_t );

public:
    AudioBuffer( AbortManager& abortManager );
    ~AudioBuffer() = default;

    bool write( AudioChunkHeader header, const uint16_t* data );
    void write_end();

    template <typename Fn>
    bool read( Fn fn );

    bool has_data() const;
    bool wait_for_data( abort_callback& abort );

    void clear();

private:
    bool has_data_no_lock() const;

private:
    AbortManager& abortManager_;

    std::array<uint16_t, k_maxBufferSize> buffer_;
    uint16_t* begin_ = buffer_.data();
    static constexpr size_t size_ = k_maxBufferSize;

    mutable std::mutex posMutex_;
    std::condition_variable dataCv_;

    size_t readPos_ = 0;
    size_t writePos_ = 0;
    size_t waterMark_ = size_;
};

template <typename Fn>
bool sptf::AudioBuffer::read( Fn fn )
{
    std::lock_guard lock( posMutex_ );

    size_t readPos = readPos_;
    const size_t writePos = writePos_;
    const size_t waterMark = waterMark_;

    if ( readPos == writePos )
    {
        return false;
    }

    readPos = ( readPos == waterMark ? 0 : readPos );

    const auto curBufferPos = begin_ + readPos;
    fn( *reinterpret_cast<AudioChunkHeader*>( curBufferPos ), curBufferPos + k_headerSizeInU16 );

    readPos_ = readPos + k_headerSizeInU16 + reinterpret_cast<AudioChunkHeader*>( curBufferPos )->size;

    return true;
}

} // namespace sptf


================================================
FILE: foo_spotify/backend/libspotify_backend.cpp
================================================
#include <stdafx.h>

#include "libspotify_backend.h"

#include <backend/libspotify_key.h>
#include <backend/spotify_instance.h>
#include <fb2k/advanced_config.h>
#include <ui/ui_not_auth.h>
#include <utils/abort_manager.h>
#include <utils/cred_prompt.h>

#include <component_paths.h>

#include <libspotify/api.h>
#include <qwr/abort_callback.h>
#include <qwr/error_popup.h>
#include <qwr/fb2k_adv_config.h>
#include <qwr/thread_helpers.h>
#include <qwr/winapi_error_helpers.h>

#include <filesystem>
#include <fstream>
#include <tuple>

// see https://github.com/mopidy/mopidy-spotify for tips and stuff

namespace fs = std::filesystem;

using namespace sptf;

namespace sptf
{

LibSpotify_Backend::LibSpotify_Backend( AbortManager& abortManager )
    : abortManager_( abortManager )
    , audioBuffer_( abortManager )
{
    if ( const auto settingsPath = path::LibSpotifySettings(); !fs::exists( settingsPath ) )
    {
        fs::create_directories( settingsPath );
    }
    // TODO: add fs error/exception checks

    const auto cachePath = path::LibSpotifyCache().u8string();
    const auto settingsPath = path::LibSpotifySettings().u8string();

    config_.api_version = SPOTIFY_API_VERSION,
    config_.cache_location = cachePath.c_str();
    config_.settings_location = settingsPath.c_str();
    config_.application_key = g_appkey;
    config_.application_key_size = sizeof( g_appkey );
    config_.user_agent = "foobar2000-foo_spotify-" SPTF_VERSION;
    config_.userdata = this;
    config_.callbacks = &callbacks_;

    const auto proxyUrl = sptf::config::advanced::network_proxy.GetValue();
    const auto proxyUsername = sptf::config::advanced::network_proxy_username.GetValue();
    const auto proxyPassword = sptf::config::advanced::network_proxy_password.GetValue();
    if ( !proxyUrl.empty() )
    {
        config_.proxy = proxyUrl.c_str();
        if ( !proxyUsername.empty() && !proxyPassword.empty() )
        {
            config_.proxy_username = proxyUsername.c_str();
            config_.proxy_password = proxyPassword.c_str();
        }
    }

    /*
    config_.tracefile = ...;
    */

#define SPTF_ASSIGN_CALLBACK( callbacks, name )                                                      \
    callbacks.name = []( sp_session * pSession, auto... args ) -> auto                               \
    { /** sp_session_userdata is assumed to be thread safe. */                                       \
        return static_cast<LibSpotify_Backend*>( sp_session_userdata( pSession ) )->name( args... ); \
    }

    // dummy callbacks are needed to avoid libspotify crashes on sp_session_release
#define SPTF_ASSIGN_DUMMY_CALLBACK( callbacks, name ) \
    callbacks.name = []( auto... ) {}

    SPTF_ASSIGN_CALLBACK( callbacks_, logged_in );
    SPTF_ASSIGN_DUMMY_CALLBACK( callbacks_, logged_out );
    SPTF_ASSIGN_DUMMY_CALLBACK( callbacks_, metadata_updated );
    SPTF_ASSIGN_DUMMY_CALLBACK( callbacks_, connection_error );
    SPTF_ASSIGN_CALLBACK( callbacks_, message_to_user );
    SPTF_ASSIGN_CALLBACK( callbacks_, notify_main_thread );
    SPTF_ASSIGN_CALLBACK( callbacks_, music_delivery );
    SPTF_ASSIGN_CALLBACK( callbacks_, play_token_lost );
    SPTF_ASSIGN_CALLBACK( callbacks_, log_message );
    SPTF_ASSIGN_CALLBACK( callbacks_, end_of_track );
    SPTF_ASSIGN_DUMMY_CALLBACK( callbacks_, streaming_error );
    SPTF_ASSIGN_DUMMY_CALLBACK( callbacks_, userinfo_updated );
    SPTF_ASSIGN_DUMMY_CALLBACK( callbacks_, start_playback );
    SPTF_ASSIGN_DUMMY_CALLBACK( callbacks_, stop_playback );
    SPTF_ASSIGN_DUMMY_CALLBACK( callbacks_, get_audio_buffer_stats );
    SPTF_ASSIGN_DUMMY_CALLBACK( callbacks_, offline_status_updated );
    SPTF_ASSIGN_DUMMY_CALLBACK( callbacks_, offline_error );
    SPTF_ASSIGN_DUMMY_CALLBACK( callbacks_, credentials_blob_updated );
    SPTF_ASSIGN_CALLBACK( callbacks_, connectionstate_updated );
    SPTF_ASSIGN_DUMMY_CALLBACK( callbacks_, scrobble_error );
    SPTF_ASSIGN_CALLBACK( callbacks_, private_session_mode_changed );

#undef SPTF_ASSIGN_DUMMY_CALLBACK
#undef SPTF_ASSIGN_CALLBACK

    // TODO: check if `sp_playlist_add_callbacks` works when implementing playlist handling

    {
        std::lock_guard lock( apiMutex_ );
        const auto sp = sp_session_create( &config_, &pSpSession_ );
        if ( sp != SP_ERROR_OK )
        {
            throw qwr::QwrException( fmt::format( "sp_session_create failed: {}", sp_error_message( sp ) ) );
        }
    }

    StartEventLoopThread();

    RefreshBitrate();
    RefreshNormalization();
    RefreshCacheSize();
}

void LibSpotify_Backend::Finalize()
{
    StopEventLoopThread();

    {
        std::lock_guard lk( backendUsersMutex_ );

        for ( auto& pInput: backendUsers_ )
        {
            pInput->Finalize();
        }
    }

    {
        std::lock_guard lock( apiMutex_ );
        sp_session_player_unload( pSpSession_ );
        sp_session_release( pSpSession_ );
    }
}

void LibSpotify_Backend::RegisterBackendUser( LibSpotify_BackendUser& input )
{
    std::lock_guard lk( backendUsersMutex_ );

    assert( !backendUsers_.count( &input ) );
    backendUsers_.emplace( &input );
}

void LibSpotify_Backend::UnregisterBackendUser( LibSpotify_BackendUser& input )
{
    std::lock_guard lk( backendUsersMutex_ );

    assert( backendUsers_.count( &input ) );
    backendUsers_.erase( &input );
}

sp_session* LibSpotify_Backend::GetInitializedSpSession( abort_callback& p_abort )
{
    assert( pSpSession_ );
    if ( !Relogin( p_abort ) )
    {
        ::fb2k::inMainThread( [&] {
            playback_control::get()->stop();
            ui::NotAuthHandler::Get().ShowDialog();
        } );
        throw qwr::QwrException( "Failed to get authenticated Spotify session" );
    }

    return pSpSession_;
}

sp_session* LibSpotify_Backend::GetWhateverSpSession()
{
    assert( pSpSession_ );
    return pSpSession_;
}

bool LibSpotify_Backend::Relogin( abort_callback& abort )
{
    {
        std::lock_guard lock( loginMutex_ );

        if ( loginStatus_ == LoginStatus::logged_out )
        {
            return false;
        }

        if ( loginStatus_ == LoginStatus::uninitialized )
        {
            loginStatus_ = LoginStatus::login_in_process;

            const auto spRet = [&] {
                std::lock_guard lock( apiMutex_ );
                return sp_session_relogin( pSpSession_ );
            }();
            if ( spRet == SP_ERROR_NO_CREDENTIALS )
            {
                loginStatus_ = LoginStatus::logged_out;
                return false;
            }
        }
    }

    auto retStatus = WaitForLoginStatusUpdate( abort );
    return ( retStatus.has_value() ? *retStatus : false );
}

bool LibSpotify_Backend::LoginWithUI( HWND hWnd )
{
    // TODO: add abortable as a method argument
    assert( core_api::assert_main_thread() );

    {
        std::lock_guard lock( loginMutex_ );
        assert( loginStatus_ == LoginStatus::logged_out );
        loginStatus_ = LoginStatus::login_in_process;
        isLoginBad_ = false;
    }

    std::optional<bool> retStatus;
    do
    {
        const auto wasLoginBad = [&] {
            std::lock_guard lock( loginMutex_ );
            return isLoginBad_;
        }();

        auto cpr = ShowCredentialsDialog( hWnd, wasLoginBad ? sp_error_message( SP_ERROR_BAD_USERNAME_OR_PASSWORD ) : nullptr );
        if ( cpr->cancelled )
        {
            {
                std::lock_guard lock( loginMutex_ );
                loginStatus_ = LoginStatus::logged_out;
            }
            loginCv_.notify_all();
            return false;
        }

        {
            std::lock_guard lock( apiMutex_ );
            sp_session_login( pSpSession_, cpr->un.data(), cpr->pw.data(), true, nullptr );
        }

        qwr::TimedAbortCallback tac( fmt::format( "{}: {}", SPTF_UNDERSCORE_NAME, "LibSpotify wait for login update" ) );
        retStatus = WaitForLoginStatusUpdate( tac );
    } while ( retStatus.has_value() && !*retStatus );

    return ( retStatus.has_value() ? *retStatus : false );
}

void LibSpotify_Backend::LogoutAndForget( abort_callback& abort )
{
    {
        std::lock_guard lgLogin( loginMutex_ );
        if ( loginStatus_ != LoginStatus::logged_in )
        {
            return;
        }

        loginStatus_ = LoginStatus::logout_in_process;
    }

    {
        std::lock_guard lgApi( apiMutex_ );
        sp_session_logout( pSpSession_ );
        sp_session_forget_me( pSpSession_ );
    }

    WaitForLoginStatusUpdate( abort );
}

std::string LibSpotify_Backend::GetLoggedInUserName()
{
    {
        std::lock_guard lock( loginMutex_ );
        if ( loginStatus_ != LoginStatus::logged_in )
        {
            return "<error: user is not logged in>";
        }
    }

    std::lock_guard lock( apiMutex_ );

    // `sp_user_display_name` always returns canonical name:
    // https://stackoverflow.com/questions/23797162/sp-user-display-name-always-returns-canonical-name-even-when-user-is-loaded

    const char* email = sp_session_user_name( pSpSession_ );
    if ( !email )
    {
        return "<error: user name could not be fetched>";
    }

    return email;
}

void LibSpotify_Backend::RefreshBitrate()
{
    std::lock_guard lock( apiMutex_ );
    const auto sp = sp_session_preferred_bitrate( pSpSession_, static_cast<sp_bitrate>( static_cast<uint8_t>( config::preferred_bitrate.GetValue() ) ) );
    if ( sp != SP_ERROR_OK )
    {
        qwr::ReportErrorWithPopup( SPTF_UNDERSCORE_NAME, fmt::format( "sp_session_preferred_bitrate failed:\n{}", sp_error_message( sp ) ) );
    }
}

void LibSpotify_Backend::RefreshNormalization()
{
    std::lock_guard lock( apiMutex_ );
    const auto sp = sp_session_set_volume_normalization( pSpSession_, config::enable_normalization );
    if ( sp != SP_ERROR_OK )
    {
        qwr::ReportErrorWithPopup( SPTF_UNDERSCORE_NAME, fmt::format( "sp_session_set_volume_normalization failed:\n{}", sp_error_message( sp ) ) );
    }
}

void LibSpotify_Backend::RefreshPrivateMode()
{
    {
        std::lock_guard lock( loginMutex_ );
        if ( loginStatus_ != LoginStatus::logged_in )
        { // private session can be set only in logged in session
            return;
        }
    }

    {
        std::lock_guard lock( apiMutex_ );
        RefreshPrivateModeNonBlocking();
    }
}

void LibSpotify_Backend::RefreshCacheSize()
{
    const auto sizeInMb = config::libspotify_cache_size_in_mb.GetValue();
    const auto sizeInPercent = config::libspotify_cache_size_in_percent.GetValue();

    const auto cacheSize = [sizeInMb, sizeInPercent]() -> uint32_t {
        if ( !sizeInMb && ( sizeInPercent == 10 || !sizeInPercent ) )
        { // 0 - default LibSpotify behaviour
            return 0;
        }

        uint64_t dummy1;
        uint64_t dummy2;
        uint64_t freeBytes;
        auto bRet = GetDiskFreeSpaceEx( L"C:",
                                        (PULARGE_INTEGER)&dummy1,
                                        (PULARGE_INTEGER)&dummy2,
                                        (PULARGE_INTEGER)&freeBytes );
        qwr::error::CheckWinApi( bRet, "GetDiskFreeSpaceEx" );
        const auto freeMb = ( uint32_t )( freeBytes / ( 1024 * 1024 ) );

        if ( !sizeInPercent )
        {
            return std::min( sizeInMb, freeMb );
        }
        else
        {
            const auto freeSpacePercented = ( uint32_t )( freeMb * ( 1.0 / sizeInPercent ) );
            if ( sizeInMb )
            {
                return std::min( sizeInMb, freeSpacePercented );
            }
            else
            {
                return freeSpacePercented;
            }
        }
    }();

    std::lock_guard lock( apiMutex_ );
    const auto sp = sp_session_set_cache_size( pSpSession_, cacheSize );
    if ( sp != SP_ERROR_OK )
    {
        qwr::ReportErrorWithPopup( SPTF_UNDERSCORE_NAME, fmt::format( "sp_session_set_cache_size failed:\n{}", sp_error_message( sp ) ) );
    }
}

void LibSpotify_Backend::EventLoopThread()
{
    int nextTimeout = INFINITE;
    while ( true )
    {
        {
            std::unique_lock lock( workerMutex_ );

            while ( !hasEvents_ && !shouldStopEventLoop_ )
            {
                const auto ret = eventLoopCv_.wait_for( lock, std::chrono::milliseconds( nextTimeout ) );
                if ( std::cv_status::timeout == ret )
                {
                    break;
                }
            }

            if ( shouldStopEventLoop_ )
            {
                return;
            }
            hasEvents_ = false;
        }

        std::lock_guard lock( apiMutex_ );
        sp_session_process_events( pSpSession_, &nextTimeout );
    }
}

void LibSpotify_Backend::StartEventLoopThread()
{
    assert( !pWorker_ );
    pWorker_ = std::make_unique<std::thread>( &LibSpotify_Backend::EventLoopThread, this );
    qwr::SetThreadName( *pWorker_, "SPTF Event Loop" );
}

void LibSpotify_Backend::StopEventLoopThread()
{
    if ( !pWorker_ )
    {
        return;
    }

    {
        std::unique_lock<std::mutex> lock( workerMutex_ );
        shouldStopEventLoop_ = true;
    }
    eventLoopCv_.notify_all();

    if ( pWorker_->joinable() )
    {
        pWorker_->join();
    }
    pWorker_.reset();
}

std::optional<bool> LibSpotify_Backend::WaitForLoginStatusUpdate( abort_callback& abort )
{
    const auto abortableScope = abortManager_.GetAbortableScope( [&] { loginCv_.notify_all(); }, abort );

    std::unique_lock lock( loginMutex_ );

    loginCv_.wait( lock, [&] {
        return ( ( loginStatus_ != LoginStatus::login_in_process
                   && loginStatus_ != LoginStatus::logout_in_process )
                 || abort.is_aborting() );
    } );
    if ( abort.is_aborting() )
    {
        return std::nullopt;
    }

    return ( loginStatus_ == LoginStatus::logged_in );
}

void LibSpotify_Backend::RefreshPrivateModeNonBlocking()
{
    const auto sp = sp_session_set_private_session( pSpSession_, config::enable_private_mode );
    if ( sp != SP_ERROR_OK )
    {
        qwr::ReportErrorWithPopup( SPTF_UNDERSCORE_NAME, fmt::format( "sp_session_set_private_session failed:\n{}", sp_error_message( sp ) ) );
    }
}

void LibSpotify_Backend::AcquireDecoder( void* owner )
{
    std::lock_guard lk( decoderOwnerMutex_ );
    if ( pDecoderOwner_ && pDecoderOwner_ != owner )
    {
        throw exception_io_data( "Someone else is already decoding: Spotify does not support multiple concurrent decoders" );
    }

    pDecoderOwner_ = owner;
}

void LibSpotify_Backend::ReleaseDecoder( void* owner )
{
    (void)owner;

    std::lock_guard lk( decoderOwnerMutex_ );
    assert( owner == pDecoderOwner_ );
    pDecoderOwner_ = nullptr;
}

AudioBuffer& LibSpotify_Backend::GetAudioBuffer()
{
    return audioBuffer_;
}

void LibSpotify_Backend::log_message( const char* error )
{
    FB2K_console_formatter() << SPTF_UNDERSCORE_NAME " (log): " << error;
}

void LibSpotify_Backend::logged_in( sp_error error )
{
    if ( SP_ERROR_OK == error )
    {
        return;
    }

    if ( SP_ERROR_BAD_USERNAME_OR_PASSWORD == error )
    {
        std::lock_guard lock( loginMutex_ );
        if ( loginStatus_ == LoginStatus::login_in_process )
        {
            isLoginBad_ = true;
            loginStatus_ = LoginStatus::logged_out;
        }
    }
    else
    {
        {
            std::lock_guard lock( loginMutex_ );
            loginStatus_ = LoginStatus::uninitialized;
        }
        qwr::ReportErrorWithPopup( SPTF_NAME, fmt::format( "Failed to login:\n{}", sp_error_message( error ) ) );
    }
}

void LibSpotify_Backend::message_to_user( const char* message )
{
    qwr::ReportErrorWithPopup( SPTF_NAME, message );
}

void LibSpotify_Backend::notify_main_thread()
{
    {
        std::unique_lock lock( workerMutex_ );
        hasEvents_ = true;
    }

    eventLoopCv_.notify_all();
}

int LibSpotify_Backend::music_delivery( const sp_audioformat* format, const void* frames, int num_frames )
{
    if ( !num_frames )
    {
        audioBuffer_.clear();
        return 0;
    }

    assert( frames );
    if ( num_frames == 22050 && !*(uint16_t*)frames )
    {   // a dirty hack to remove a 1 seconds silence that libspotify pads the end of a track with
        // See: https://github.com/mopidy/mopidy-spotify/pull/269
        // and https://stackoverflow.com/questions/26014520/libspotify-c-sending-zeros-at-the-end-of-track
        return num_frames;
    }

    if ( !audioBuffer_.write( AudioBuffer::AudioChunkHeader{ (uint16_t)format->sample_rate,
                                                             (uint16_t)format->channels,
                                                             ( uint16_t )( num_frames * format->channels ) },
                              static_cast<const uint16_t*>( frames ) ) )
    {
        return 0;
    }

    return num_frames;
}

void LibSpotify_Backend::end_of_track()
{
    audioBuffer_.write_end();
}

void LibSpotify_Backend::play_token_lost()
{
    ::fb2k::inMainThread2( [&] {
        playback_control::get()->pause( true );
    } );
    qwr::ReportErrorWithPopup( SPTF_NAME, "Playback has been paused because your Spotify account is being used somewhere else." );
}

void LibSpotify_Backend::connectionstate_updated()
{
    switch ( sp_session_connectionstate( pSpSession_ ) )
    {
    case SP_CONNECTION_STATE_LOGGED_IN:
    case SP_CONNECTION_STATE_OFFLINE:
    {
        {
            std::lock_guard lock( loginMutex_ );
            loginStatus_ = LoginStatus::logged_in;
        }
        loginCv_.notify_all();

        RefreshPrivateModeNonBlocking();
        break;
    }
    case SP_CONNECTION_STATE_LOGGED_OUT:
    {
        {
            std::lock_guard lock( loginMutex_ );
            if ( loginStatus_ == LoginStatus::login_in_process )
            { // possible when invalid user/pass are supplied
                break;
            }
            loginStatus_ = LoginStatus::logged_out;
        }
        loginCv_.notify_all();
        break;
    }
    default:
    {
        break;
    }
    }
}

void LibSpotify_Backend::private_session_mode_changed( bool is_private )
{ // in case private mode expired
    if ( is_private == config::enable_private_mode )
    {
        return;
    }
    RefreshPrivateModeNonBlocking();
}

} // namespace sptf


================================================
FILE: foo_spotify/backend/libspotify_backend.h
================================================
#pragma once

#include <backend/audio_buffer.h>
#include <backend/libspotify_backend_user.h>
#include <fb2k/config.h>

#include <libspotify/api.h>

#include <condition_variable>
#include <optional>
#include <unordered_set>

namespace sptf
{

class AbortManager;

class LibSpotify_Backend
{
public:
    LibSpotify_Backend( AbortManager& abortManager );
    LibSpotify_Backend( const LibSpotify_Backend& ) = delete;
    LibSpotify_Backend( LibSpotify_Backend&& ) = delete;
    ~LibSpotify_Backend() = default;

    void Finalize();

    void RegisterBackendUser( LibSpotify_BackendUser& backendUser );
    void UnregisterBackendUser( LibSpotify_BackendUser& backendUser );

    void AcquireDecoder( void* owner );
    void ReleaseDecoder( void* owner );

    AudioBuffer& GetAudioBuffer();

    sp_session* GetInitializedSpSession( abort_callback& abort );
    sp_session* GetWhateverSpSession();

    template <typename Fn, typename... Args>
    auto ExecSpMutex( Fn func, Args&&... args ) -> decltype( auto )
    {
        std::lock_guard lock( apiMutex_ );
        return func( std::forward<Args>( args )... );
    }

    bool Relogin( abort_callback& abort );
    bool LoginWithUI( HWND hWnd );
    void LogoutAndForget( abort_callback& abort );

    std::string GetLoggedInUserName();

    void RefreshBitrate();
    void RefreshNormalization();
    void RefreshPrivateMode();
    void RefreshCacheSize();

private:
    void EventLoopThread();
    void StartEventLoopThread();
    void StopEventLoopThread();

    std::optional<bool> WaitForLoginStatusUpdate( abort_callback& abort );

    void RefreshPrivateModeNonBlocking();

    // callbacks

    void log_message( const char* error );
    void logged_in( sp_error error );
    void message_to_user( const char* error );
    void notify_main_thread();
    int music_delivery( const sp_audioformat* format, const void* frames, int num_frames );
    void end_of_track();
    void play_token_lost();
    void connectionstate_updated();
    void private_session_mode_changed( bool is_private );

private:
    AbortManager& abortManager_;

    sp_session_callbacks callbacks_{};
    sp_session_config config_{};

    std::mutex decoderOwnerMutex_;
    void* pDecoderOwner_ = nullptr;

    std::mutex apiMutex_;
    sp_session* pSpSession_ = nullptr;

    std::unique_ptr<std::thread> pWorker_;
    std::mutex workerMutex_;
    std::condition_variable eventLoopCv_;
    bool hasEvents_ = false;
    bool shouldStopEventLoop_ = false;

    std::mutex backendUsersMutex_;
    std::unordered_set<LibSpotify_BackendUser*> backendUsers_;

    enum class LoginStatus
    {
        uninitialized,
        logged_in,
        logged_out,
        login_in_process,
        logout_in_process,
    };

    std::mutex loginMutex_;
    std::condition_variable loginCv_;
    LoginStatus loginStatus_ = LoginStatus::uninitialized;
    bool isLoginBad_ = false;

    AudioBuffer audioBuffer_;
};

} // namespace sptf


================================================
FILE: foo_spotify/backend/libspotify_backend_user.h
================================================
#pragma once

namespace sptf
{

class LibSpotify_BackendUser
{
public:
    ~LibSpotify_BackendUser() = default;
    virtual void Finalize() = 0;
};

} // namespace sptf


================================================
FILE: foo_spotify/backend/libspotify_key.h
================================================
#pragma once

#include <cstdint>

// clang-format off

inline constexpr uint8_t g_appkey[] = {
	0x01, 0xF8, 0x35, 0x9D, 0x45, 0x52, 0xD7, 0xA5, 0xC2, 0x91, 0xC0, 0x94, 0x18, 0x52, 0x81, 0x28,
	0x6A, 0xA4, 0xAE, 0x77, 0x4B, 0xE9, 0x87, 0xC9, 0x05, 0x2D, 0x72, 0x11, 0xC2, 0x59, 0x18, 0x6F,
	0xB3, 0x91, 0x4E, 0x63, 0xCE, 0x6E, 0xDA, 0xF5, 0xE3, 0xC7, 0xC6, 0xC9, 0x3B, 0x88, 0x37, 0x31,
	0x3C, 0xDA, 0x71, 0xF1, 0x4C, 0x68, 0x03, 0x1B, 0xF8, 0xC0, 0x4A, 0xBA, 0x20, 0x0B, 0xBE, 0xC4,
	0x2F, 0x49, 0x7A, 0xC5, 0x5C, 0xC4, 0x36, 0xF1, 0x94, 0xF7, 0xC6, 0x4F, 0x27, 0xFB, 0x5E, 0x31,
	0x00, 0x31, 0x53, 0x52, 0x74, 0x0B, 0x64, 0x16, 0x4B, 0x70, 0xA6, 0x71, 0x6D, 0xC0, 0x71, 0x7F,
	0x6B, 0xFD, 0xE5, 0xA4, 0x57, 0x99, 0x4A, 0x11, 0xB0, 0x0B, 0xBA, 0xC4, 0xF2, 0x9A, 0xB9, 0x33,
	0xC7, 0x5F, 0x70, 0x6D, 0x73, 0xEA, 0xAB, 0x88, 0xD2, 0x83, 0xAC, 0x33, 0xA7, 0xFE, 0xDA, 0xD7,
	0xF2, 0xAC, 0x04, 0x41, 0xAC, 0x7D, 0xEF, 0x88, 0x5A, 0x21, 0xEC, 0xD8, 0x02, 0x40, 0xB7, 0x0C,
	0x3A, 0x42, 0x2C, 0x26, 0x17, 0x9D, 0x82, 0x43, 0x50, 0x07, 0x1F, 0x2E, 0xAF, 0x72, 0x88, 0x65,
	0xDB, 0xA7, 0x83, 0xA6, 0x44, 0x06, 0x2E, 0x55, 0x08, 0xF2, 0x4C, 0x4A, 0x96, 0xF7, 0xD5, 0xFC,
	0x57, 0x75, 0x5F, 0x1C, 0x1D, 0xB1, 0x35, 0x5A, 0x48, 0x83, 0x1F, 0x60, 0x65, 0xBD, 0x40, 0xDD,
	0x03, 0x1D, 0x3A, 0x4E, 0xD6, 0xA8, 0xB8, 0x5E, 0xFC, 0x60, 0x59, 0xE0, 0xB3, 0xC5, 0x64, 0xD0,
	0x2A, 0x20, 0x48, 0x24, 0x5E, 0x9B, 0xE4, 0xF0, 0x45, 0xAA, 0x30, 0xCE, 0xB3, 0x11, 0x45, 0xB0,
	0x01, 0xDA, 0x82, 0x58, 0xFE, 0x4F, 0x97, 0xF2, 0x40, 0x4D, 0x8C, 0x83, 0x17, 0x8C, 0x97, 0xCF,
	0x40, 0x17, 0xDB, 0xC7, 0x19, 0xEC, 0xFA, 0x01, 0x4F, 0xE6, 0x78, 0x3A, 0x54, 0x3F, 0xE9, 0x62,
	0xA3, 0xF2, 0xDD, 0x0A, 0xDD, 0x90, 0xE4, 0x24, 0xE7, 0x57, 0x8C, 0x30, 0x18, 0x13, 0xA6, 0x9C,
	0x52, 0x7D, 0xBE, 0x0B, 0x10, 0xEA, 0x0C, 0x53, 0x87, 0x9B, 0x26, 0xBA, 0xA7, 0x70, 0xAE, 0x88,
	0x8A, 0xAA, 0x5E, 0x7C, 0x73, 0xC3, 0x08, 0x92, 0x29, 0xDC, 0xEA, 0x22, 0x25, 0x16, 0xB5, 0xF0,
	0x89, 0xF0, 0x88, 0xBE, 0xAB, 0x84, 0x6C, 0xFE, 0xF1, 0xBE, 0x8A, 0x81, 0x19, 0x0A, 0xE7, 0x64,
	0xC4,
};

// clang-format on


================================================
FILE: foo_spotify/backend/libspotify_wrapper.h
================================================
#pragma once

#include <backend/libspotify_backend.h>

#include <libspotify/api.h>

namespace sptf::wrapper
{

namespace internal
{

template <typename T>
struct SpotifyTraits
{
    static_assert( "unknown specialization" );
};

template <>
struct SpotifyTraits<sp_track>
{
    static void AddRef( sp_track* album )
    {
        sp_track_add_ref( album );
    }

    static void Release( sp_track* album )
    {
        sp_track_release( album );
    }

    static bool IsLoaded( sp_track* album )
    {
        return sp_track_is_loaded( album );
    }
};

template <>
struct SpotifyTraits<sp_link>
{
    static void AddRef( sp_link* link )
    {
        sp_link_add_ref( link );
    }

    static void Release( sp_link* link )
    {
        sp_link_release( link );
    }

    // does not have a "IsLoaded" method
};

} // namespace internal

template <typename T>
class Ptr
{
public:
    Ptr() = default;

    Ptr( T* ptr )
        : ptr_( ptr )
    {

        if ( ptr_ )
        {
            internal::SpotifyTraits<T>::AddRef( ptr_ );
        }
    }

    Ptr( const Ptr<T*>& other )
        : ptr_( other.ptr_ )
    {
        if ( ptr_ )
        {
            internal::SpotifyTraits<T>::AddRef( ptr_ );
        }
    }

    Ptr( Ptr<T*>&& other )
        : ptr_( other.ptr_ )
    {
        other.ptr_ = nullptr;
    }

    void Release()
    {
        auto ptr = ptr_;
        ptr_ = nullptr;
        if ( ptr )
        {
            internal::SpotifyTraits<T>::Release( ptr );
        }
    }

    void Attach( T* ptr )
    {
        if ( ptr_ )
        {
            internal::SpotifyTraits<T>::Release( ptr );
        }
        ptr_ = ptr;
    }

    operator bool() const
    {
        return !!ptr_;
    }

    bool operator!() const
    {
        return !ptr_;
    }

    T* operator=( T* ptr )
    {
        Release();
        ptr_ = ptr;
        if ( ptr_ )
        {
            internal::SpotifyTraits<T>::AddRef( ptr_ );
        }
        return ptr_;
    }

    operator T*() const
    {
        return ptr_;
    }

private:
    T* ptr_ = nullptr;
};

} // namespace sptf::wrapper


================================================
FILE: foo_spotify/backend/spotify_instance.cpp
================================================
#include <stdafx.h>

#include "spotify_instance.h"

#include <backend/libspotify_backend.h>
#include <backend/webapi_auth.h>
#include <backend/webapi_backend.h>
#include <fb2k/playback.h>
#include <utils/abort_manager.h>

#include <qwr/abort_callback.h>
#include <qwr/thread_pool.h>

namespace sptf
{

SpotifyInstance& SpotifyInstance::Get()
{
    static SpotifyInstance si;
    return si;
}

void SpotifyInstance::Finalize()
{
    std::lock_guard lg( mutex_ );
    isFinalized_ = true;

    const auto finalize = []( auto& pElem ) {
        if ( pElem )
        {
            try
            {
                pElem->Finalize();
            }
            catch ( const std::exception& )
            {
            }
            pElem.reset();
        }
    };

    if ( fb2k_playCallbacks_initialized_ )
    {
        fb2k::PlayCallbacks::Finalize();
        fb2k_playCallbacks_initialized_ = false;
    }

    finalize( pWebApi_backend_ );
    finalize( pLibSpotify_backend_ );
    finalize( pAbortManager_ );
    finalize( pThreadPool_ );
}

qwr::ThreadPool& SpotifyInstance::GetThreadPool()
{
    InitializeAll();
    assert( pThreadPool_ );
    return *pThreadPool_;
}

AbortManager& SpotifyInstance::GetAbortManager()
{
    InitializeAll();
    assert( pAbortManager_ );
    return *pAbortManager_;
}

LibSpotify_Backend& SpotifyInstance::GetLibSpotify_Backend()
{
    InitializeAll();
    assert( pLibSpotify_backend_ );
    return *pLibSpotify_backend_;
}

WebApi_Backend& SpotifyInstance::GetWebApi_Backend()
{
    InitializeAll();
    assert( pWebApi_backend_ );
    return *pWebApi_backend_;
}

void SpotifyInstance::InitializeAll()
{
    std::lock_guard lg( mutex_ );
    if ( isFinalized_ )
    {
        throw qwr::QwrException( "foobar2000 is exiting" );
    }

    if ( !pThreadPool_ )
    {
        pThreadPool_ = std::make_unique<qwr::ThreadPool>( "SPTF Worker", 2 );
    }
    if ( !pAbortManager_ )
    {
        pAbortManager_ = std::make_unique<AbortManager>();
    }
    if ( !pLibSpotify_backend_ )
    {
        pLibSpotify_backend_ = std::make_unique<LibSpotify_Backend>( *pAbortManager_ );
    }
    if ( !pWebApi_backend_ )
    {
        pWebApi_backend_ = std::make_unique<WebApi_Backend>( *pAbortManager_ );
    }
    if ( !fb2k_playCallbacks_initialized_ )
    {
        fb2k::PlayCallbacks::Initialize( *pLibSpotify_backend_ );
        fb2k_playCallbacks_initialized_ = true;
    }
}

} // namespace sptf

================================================
FILE: foo_spotify/backend/spotify_instance.h
================================================
#pragma once

#include <mutex>

namespace qwr
{
class ThreadPool;
}

namespace sptf
{

class AbortManager;
class LibSpotify_Backend;
class WebApi_Backend;

namespace fb2k
{

class PlayCallbacks;

}

class SpotifyInstance
{

public:
    ~SpotifyInstance() = default;

    static SpotifyInstance& Get();
    void Finalize();

    qwr::ThreadPool& GetThreadPool();
    AbortManager& GetAbortManager();
    LibSpotify_Backend& GetLibSpotify_Backend();
    WebApi_Backend& GetWebApi_Backend();

private:
    SpotifyInstance() = default;
    void InitializeAll();

private:
    std::mutex mutex_;
    bool isFinalized_ = false;

    std::unique_ptr<qwr::ThreadPool> pThreadPool_;
    std::unique_ptr<AbortManager> pAbortManager_;
    std::unique_ptr<LibSpotify_Backend> pLibSpotify_backend_;
    std::unique_ptr<WebApi_Backend> pWebApi_backend_;
    bool fb2k_playCallbacks_initialized_ = false;
};

} // namespace sptf

================================================
FILE: foo_spotify/backend/spotify_object.cpp
================================================
#include <stdafx.h>

#include "spotify_object.h"

#include <qwr/string_helpers.h>

using namespace std::literals::string_view_literals;

namespace sptf
{

bool SpotifyObject::IsValid( std::string_view input )
{
    try
    {
        SpotifyObject tmp( input );
        (void)tmp;
        return true;
    }
    catch ( const qwr::QwrException& )
    {
        return false;
    }
}

SpotifyObject::SpotifyObject( std::string_view input )
{
    const auto schemaPrefix = "sptf://"sv;
    if ( input._Starts_with( schemaPrefix ) )
    {
        input.remove_prefix( schemaPrefix.size() );
    }

    const auto urlPrefix = "https://open.spotify.com/"sv;
    if ( input._Starts_with( urlPrefix ) )
    {
        input.remove_prefix( urlPrefix.size() );

        const auto ret = qwr::string::Split( input, '/' );
        qwr::QwrException::ExpectTrue( ret.size() == 2, "Invalid URL" );

        const auto localType = ret[0];
        type = std::string( localType.data(), localType.size() );

        const auto localId = [localId = ret[1]] {
            const auto pos = localId.find( '?' );
            if ( pos == std::string_view::npos )
            {
                return localId;
            }

            return localId.substr( 0, pos );
        }();
        qwr::QwrException::ExpectTrue( !localId.empty(), "Invalid Spotify object id: {}", localId );
        id = std::string( localId.cbegin(), localId.cend() );
    }
    else
    {
        const auto ret = qwr::string::Split( input, ':' );
        qwr::QwrException::ExpectTrue( ret.size() == 3, "Invalid URI" );
        qwr::QwrException::ExpectTrue( ret[0] == "spotify"sv, "Invalid URI" );

        const auto localType = ret[1];
        type = std::string( localType.data(), localType.size() );

        const auto localId = ret[2];
        qwr::QwrException::ExpectTrue( !localId.empty(), "Invalid Spotify object id: {}", localId );
        id = std::string( localId.cbegin(), localId.cend() );
    }
}

SpotifyObject::SpotifyObject( std::string_view type, std::string_view id )
    : type( type )
    , id( id )
{
}

std::string SpotifyObject::ToUri() const
{
    return fmt::format( "spotify:{}:{}", type, id );
}

std::string SpotifyObject::ToUrl() const
{
    return fmt::format( "https://open.spotify.com/{}/{}", type, id );
}

std::string SpotifyObject::ToSchema() const
{
    return fmt::format( "sptf://spotify:{}:{}", type, id );
}

SpotifyFilteredTrack::SpotifyFilteredTrack( std::string_view id )
    : object_( "track", id )
{
}

SpotifyFilteredTrack SpotifyFilteredTrack::Parse( std::string_view input )
{
    if ( !IsValid( input, false ) )
    {
        throw qwr::QwrException( "Unsupported input format: {}", input );
    }

    SpotifyObject so( input );
    assert( so.type == "track" );

    return SpotifyFilteredTrack( so.id );
}

const std::string& SpotifyFilteredTrack::Id() const
{
    return object_.id;
}

std::string SpotifyFilteredTrack::ToUri() const
{
    return object_.ToUri();
}

std::string SpotifyFilteredTrack::ToUrl() const
{
    return object_.ToUrl();
}

std::string SpotifyFilteredTrack::ToSchema() const
{
    return object_.ToSchema();
}

bool SpotifyFilteredTrack::IsValid( std::string_view input, bool usePurePathOnly )
{
    const auto schemaPrefix = "sptf://"sv;
    if ( input._Starts_with( schemaPrefix ) )
    {
        input.remove_prefix( schemaPrefix.size() );
    }
    else if ( usePurePathOnly )
    {
        return false;
    }

    return input._Starts_with( "spotify:track:"sv );
}

} // namespace sptf


================================================
FILE: foo_spotify/backend/spotify_object.h
================================================
#pragma once

#include <string>

namespace sptf
{

struct SpotifyObject
{
    /// @throw qwr::QwrException
    SpotifyObject( std::string_view input );
    /// @throw qwr::QwrException
    SpotifyObject( std::string_view type, std::string_view id );

    std::string ToUri() const;
    std::string ToUrl() const;
    std::string ToSchema() const;

    static bool IsValid( std::string_view input );

    std::string type;
    std::string id;
};

class SpotifyFilteredTrack
{
public:
    /// @throw qwr::QwrException
    SpotifyFilteredTrack( std::string_view id );
    /// @throw qwr::QwrException
    static SpotifyFilteredTrack Parse( std::string_view input );

    const std::string& Id() const;
    std::string ToUri() const;
    std::string ToUrl() const;
    std::string ToSchema() const;

    static bool IsValid( std::string_view input, bool usePurePathOnly );

private:
    SpotifyObject object_;
};

} // namespace sptf


================================================
FILE: foo_spotify/backend/webapi_auth.cpp
================================================
#include <stdafx.h>

#include "webapi_auth.h"

#include <backend/spotify_instance.h>
#include <backend/webapi_auth_scopes.h>
#include <ui/ui_not_auth.h>
#include <utils/abort_manager.h>
#include <utils/json_std_extenders.h>

#include <bcrypt.h>
#include <component_urls.h>
#include <pplawait.h>
#include <winternl.h>

#include <cpprest/asyncrt_utils.h>
#include <cpprest/http_client.h>
#include <cpprest/http_listener.h>
#include <cpprest/json.h>
#include <cpprest/uri_builder.h>
#include <nonstd/span.hpp>
#include <qwr/file_helpers.h>
#include <qwr/final_action.h>
#include <qwr/string_helpers.h>

#include <random>
#include <string_view>
#include <unordered_set>

#include <experimental/resumable>

// TODO: move to props
#pragma comment( lib, "bcrypt.lib" )
#pragma comment( lib, "Crypt32.lib" )
#pragma comment( lib, "winhttp.lib" )
#pragma comment( lib, "httpapi.lib" )

// TODO: add abortable to cts
// TODO: clean up mutex handling - it's a mess here

namespace fs = std::filesystem;

using namespace sptf;

namespace
{

constexpr wchar_t k_clientId[] = L"30826243a65f43f19b038fd65ffaa8b5";

} // namespace

namespace
{

std::wstring GenerateCodeVerifier()
{
    static constexpr wchar_t codeVerifierChars[] =
        L"abcdefghijklmnopqrstuvwxyz"
        L"ABCDEFGHIJKLMNOPQRSTUVWXYZ"
        L"1234567890"
        L"_.-~";

    std::random_device rd;
    const auto size = std::uniform_int_distribution<size_t>( 43, 128 )( rd );

    std::wstring ret;
    ret.resize( size );

    std::uniform_int_distribution<size_t> charDist( 0, std::size( codeVerifierChars ) - 2 );
    for ( auto& ch: ret )
    {
        ch = codeVerifierChars[charDist( rd )];
    }

    return ret;
}

std::vector<uint8_t> Sha256Hash( nonstd::span<const uint8_t> data )
{
    // TODO: cleanup add error handling

    NTSTATUS status;
    BCRYPT_ALG_HANDLE alg_handle = nullptr;
    BCRYPT_HASH_HANDLE hash_handle = nullptr;

    std::vector<uint8_t> hash;
    DWORD hash_len = 0;
    ULONG result_len = 0;

    status = BCryptOpenAlgorithmProvider( &alg_handle, BCRYPT_SHA256_ALGORITHM, nullptr, 0 );
    if ( !NT_SUCCESS( status ) )
    {
        goto cleanup;
    }
    status = BCryptGetProperty( alg_handle, BCRYPT_HASH_LENGTH, (PBYTE)&hash_len, sizeof( hash_len ), &result_len, 0 );
    if ( !NT_SUCCESS( status ) )
    {
        goto cleanup;
    }
    hash.resize( hash_len );

    status = BCryptCreateHash( alg_handle, &hash_handle, nullptr, 0, nullptr, 0, 0 );
    if ( !NT_SUCCESS( status ) )
    {
        goto cleanup;
    }
    status = BCryptHashData( hash_handle, (PBYTE)data.data(), (ULONG)data.size(), 0 );
    if ( !NT_SUCCESS( status ) )
    {
        goto cleanup;
    }
    status = BCryptFinishHash( hash_handle, hash.data(), hash_len, 0 );
    if ( !NT_SUCCESS( status ) )
    {
        goto cleanup;
    }

cleanup:
    if ( hash_handle )
    {
        BCryptDestroyHash( hash_handle );
    }
    if ( alg_handle )
    {
        BCryptCloseAlgorithmProvider( alg_handle, 0 );
    }

    return hash;
}

std::wstring GenerateChallengeCode( const std::wstring& codeVerifier )
{
    const auto code_u8 = qwr::unicode::ToU8( codeVerifier );
    const auto hash = Sha256Hash( nonstd::span<const uint8_t>( reinterpret_cast<const uint8_t*>( code_u8.data() ), code_u8.size() ) );
    auto base64 = utility::conversions::to_base64( hash );
    {
        while ( base64[base64.size() - 1] == L'=' )
        {
            base64.resize( base64.size() - 1 );
        }
        for ( auto& ch: base64 )
        {
            switch ( ch )
            {
            case L'+':
            {
                ch = L'-';
                break;
            }
            case L'/':
            {
                ch = L'_';
                break;
            }
            default:
            {
                break;
            }
            }
        }
    }

    return base64;
}

void OpenAuthConfirmationInBrowser( const std::wstring& url )
{
    ShellExecuteW( nullptr, L"open", url.c_str(), nullptr, nullptr, SW_SHOWNORMAL );
}

} // namespace

namespace sptf
{

struct AuthData
{
    std::wstring accessToken;
    std::wstring refreshToken;
    std::chrono::time_point<std::chrono::system_clock> expiresAt = std::chrono::system_clock::now();
    WebApiAuthScopes scopes;
};

void to_json( nlohmann::json& j, const AuthData& p )
{
    j["access_token"] = p.accessToken;
    j["refresh_token"] = p.refreshToken;
    j["expires_at"] = std::chrono::time_point_cast<std::chrono::minutes>( p.expiresAt ).time_since_epoch().count();
    j["scopes"] = p.scopes;
}

void from_json( const nlohmann::json& j, AuthData& p )
{
    j.at( "access_token" ).get_to( p.accessToken );
    j.at( "refresh_token" ).get_to( p.refreshToken );
    p.expiresAt = std::chrono::time_point<std::chrono::system_clock>( std::chrono::minutes( j.at( "expires_at" ).get<int>() ) );
    if ( j.contains( "scopes" ) )
    {
        j["scopes"].get_to( p.scopes );
    }
    else
    { // for backwards compatibility
        WebApiAuthScopes scopes;
        scopes.playlist_read_collaborative = true;
        scopes.playlist_read_private = true;
        p.scopes = scopes;
    }
}

WebApiAuthorizer::WebApiAuthorizer( const web::http::client::http_client_config& config, AbortManager& abortManager )
    : abortManager_( abortManager )
    , client_( url::accountsApi, config )
{
    const auto authpath = path::WebApiSettings() / "auth.json";
    if ( fs::exists( authpath ) )
    {
        try
        {
            const auto data = qwr::file::ReadFileW( authpath, CP_UTF8, false );
            const auto dataJson = nlohmann::json::parse( data );
            dataJson.get_to( pAuthData_ );
        }
        catch ( const std::exception& )
        {
            pAuthData_.reset();
            try
            {
                fs::remove( authpath );
            }
            catch ( const fs::filesystem_error& )
            {
            }
        }
    }
}

WebApiAuthorizer::~WebApiAuthorizer()
{
    cts_.cancel();
    StopResponseListener();
}

bool WebApiAuthorizer::HasRefreshToken() const
{
    std::lock_guard lock( accessTokenMutex_ );
    return !!pAuthData_;
}

const std::wstring WebApiAuthorizer::GetAccessToken( abort_callback& abort )
{
    std::lock_guard lock( accessTokenMutex_ );

    if ( !pAuthData_ )
    {
        ::fb2k::inMainThread( [&] {
            playback_control::get()->stop();
            ui::NotAuthHandler::Get().ShowDialog();
        } );
        throw qwr::QwrException( "Failed to get authenticated Spotify session" );
    }

    UpdateRefreshToken_NonBlocking( abort );

    assert( !pAuthData_->accessToken.empty() );
    return pAuthData_->accessToken;
}

void WebApiAuthorizer::ClearAuth()
{
    pAuthData_.reset();
    codeVerifier_.clear();
    state_.clear();

    const auto authpath = path::WebApiSettings() / "auth.json";
    if ( fs::exists( authpath ) )
    {
        fs::remove( authpath );
    }
}

void WebApiAuthorizer::CancelAuth()
{
    // TODO: rethink cts handling: current scheme is not thread-safe.
    // Example: CancelAuth from preferences (and reassign cts_), while some other thread is using cts_.
    cts_.cancel();
    cts_ = pplx::cancellation_token_source();
    StopResponseListener();
    ClearAuth();
}

void WebApiAuthorizer::AuthenticateClean( const WebApiAuthScopes& scopes, std::function<void()> onResponseEnd )
{
    assert( core_api::is_main_thread() );

    StopResponseListener();
    StartResponseListener( onResponseEnd );

    // <https://developer.spotify.com/documentation/general/guides/authorization-guide/#authorization-code-flow-with-proof-key-for-code-exchange-pkce>

    codeVerifier_ = GenerateCodeVerifier();

    web::uri_builder builder( url::accountsAuthenticate );
    builder
        .append_query( L"client_id", web::uri::encode_data_string( k_clientId ), false )
        .append_query( L"response_type", L"code" )
        .append_query( L"redirect_uri", web::uri::encode_data_string( url::redirectUri ), false )
        .append_query( L"code_challenge_method", L"S256" )
        .append_query( L"code_challenge", GenerateChallengeCode( codeVerifier_ ) )
        .append_query( L"scope", web::uri::encode_data_string( scopes.ToWebString() ), false );
    // TODO: cookie?
    // builder.append_query( L"state", L"azaza" );

    OpenAuthConfirmationInBrowser( builder.to_string() );
}

void WebApiAuthorizer::AuthenticateClean_Cleanup()
{
    StopResponseListener();
}

void WebApiAuthorizer::UpdateRefreshToken( abort_callback& abort )
{
    std::lock_guard lock( accessTokenMutex_ );
    UpdateRefreshToken_NonBlocking( abort );
}

void WebApiAuthorizer::UpdateRefreshToken_NonBlocking( abort_callback& abort )
{
    assert( pAuthData_ );

    if ( std::chrono::system_clock::now() + std::chrono::minutes( 1 ) < pAuthData_->expiresAt )
    {
        return;
    }

    web::uri_builder builder;
    builder
        .append_query( L"grant_type", L"refresh_token" )
        .append_query( L"refresh_token", pAuthData_->refreshToken )
        .append_query( L"client_id", web::uri::encode_data_string( k_clientId ), false );

    web::http::http_request req( web::http::methods::POST );
    req.headers().set_content_type( L"application/x-www-form-urlencoded" );
    req.set_request_uri( builder.to_uri() );

    auto ctsToken = cts_.get_token();
    auto localCts = Concurrency::cancellation_token_source::create_linked_source( ctsToken );
    const auto abortableScope = abortManager_.GetAbortableScope( [&localCts] { localCts.cancel(); }, abort );

    auto response = client_.request( req, cts_.get_token() );
    HandleAuthenticationResponse( response.get() );
}

pplx::task<void> WebApiAuthorizer::CompleteAuthentication( const std::wstring& responseUrl )
{
    // TODO: final_action
    web::uri uri( responseUrl );
    // TODO: check redirectUri?

    const auto data = web::uri::split_query( uri.query() );

    if ( data.count( L"error" ) )
    {
        throw qwr::QwrException( qwr::unicode::ToU8( fmt::format( L"Authentication failed: {}", data.at( L"error" ) ) ) );
    }

    if ( !state_.empty() && ( !data.count( L"state" ) || data.at( L"state" ) != state_ ) )
    {
        throw qwr::QwrException( "Malformed authentication response: `state` mismatch" );
    }

    qwr::QwrException::ExpectTrue( data.count( L"code" ), L"Malformed authentication response: missing `code`" );

    web::uri_builder builder;
    builder
        .append_query( L"client_id", k_clientId )
        .append_query( L"grant_type", L"authorization_code" )
        .append_query( L"code", data.at( L"code" ) )
        .append_query( L"redirect_uri", web::uri::encode_data_string( url::redirectUri ), false )
        .append_query( L"code_verifier", codeVerifier_, false );

    web::http::http_request req( web::http::methods::POST );
    req.headers().set_content_type( L"application/x-www-form-urlencoded" );
    req.set_body( builder.query() );

    const auto response = co_await client_.request( req, cts_.get_token() );
    HandleAuthenticationResponse( response );
}

void WebApiAuthorizer::StartResponseListener( std::function<void()> onResponseEnd )
{
    assert( !pListener_ );
    pListener_ = std::make_unique<web::http::experimental::listener::http_listener>( url::redirectUri );
    pListener_->support( [this, onResponseEnd]( const auto& request ) {
        try
        {
            if ( request.request_uri().path() == L"/" && request.request_uri().query() != L"" )
            {
                const auto callbackCaller = qwr::final_action( [&] { onResponseEnd(); } );
                try
                {
                    CompleteAuthentication( request.request_uri().to_string() ).wait();

                    web::http::http_response res;
                    res.set_status_code( web::http::status_codes::OK );
                    res.headers().set_content_type( L"text/html; charset=utf-8" );
                    res.set_body(
                        L"<html>\n"
                        L"<head>\n"
                        L"</head>\n"
                        L"<body onload=\" waitFiveSec() \">\n"
                        L"<p><b>foo_spotify</b> was successfully authenticated!</p>\n "
                        L"<p>You can close this tab now :)</p>\n "
                        L"</body>\n"
                        L"</html>" );

                    request.reply( res ).wait();
                }
                catch ( const std::exception& e )
                {
                    pAuthData_.reset();
                    auto errorMsg = qwr::unicode::ToWide( std::string( e.what() ) );
                    {
                        size_t pos = 0;
                        while ( ( pos = errorMsg.find( L"\n", pos ) ) != std::string::npos )
                        {
                            errorMsg.replace( pos, 1, L"<br>" );
                            pos += 4;
                        }
                    }

                    web::http::http_response res;
                    res.set_status_code( web::http::status_codes::OK );
                    res.headers().set_content_type( L"text/html; charset=utf-8" );
                    res.set_body(
                        L"<html>\n"
                        L"<head>\n"
                        L"</head>\n"
                        L"<p><b>foo_spotify</b> failed to authenticate!</p>\n"
                        L"<p>Error:</p>\n"
                        L"<p>"
                        + errorMsg + "</p>\n"
                                     L"</body>\n"
                                     L"</html>" );

                    request.reply( res ).wait();
                }
            }
            else
            {
                web::http::http_response res;
                res.set_status_code( web::http::status_codes::OK );
                res.headers().set_content_type( L"text/html; charset=utf-8" );
                res.set_body( L"<html><body><p>Congratulations! You found a useless page! o/</p></body></html>" );

                request.reply( res ).wait();
            }
        }
        catch ( ... )
        {
        }
    } );
    pListener_->open().wait();
}

void WebApiAuthorizer::StopResponseListener()
{
    if ( pListener_ )
    {
        pListener_->close().wait();
        pListener_.reset();
    }
}

void WebApiAuthorizer::HandleAuthenticationResponse( const web::http::http_response& response )
{
    if ( response.status_code() != 200 )
    {
        ClearAuth();

        throw qwr::QwrException( L"{}: {}\n"
                                 L"Additional data: {}\n",
                                 (int)response.status_code(),
                                 response.reason_phrase(),
                                 [&]() -> std::wstring {
                                     try
                                     {
                                         const auto responseJson = nlohmann::json::parse( response.extract_string().get() );
                                         return qwr::unicode::ToWide( responseJson.dump( 2 ) );
                                     }
                                     catch ( ... )
                                     {
                                         return response.to_string();
                                     }
                                 }() );
    }

    const auto responseJson = response.extract_json().get();
    qwr::QwrException::ExpectTrue( responseJson.is_object(),
                                   L"Malformed authentication response: json is not an object" );

    qwr::QwrException::ExpectTrue( responseJson.at( L"token_type" ).as_string() == L"Bearer",
                                   L"Malformed authentication response: invalid `token_type`: {}",
                                   responseJson.at( L"token_type" ).as_string() );

    auto pAuthData = std::make_unique<AuthData>();
    pAuthData->accessToken = responseJson.at( L"access_token" ).as_string();
    pAuthData->refreshToken = responseJson.at( L"refresh_token" ).as_string();
    pAuthData->expiresAt = std::chrono::system_clock::now() + std::chrono::seconds( responseJson.at( L"expires_in" ).as_integer() );

    auto scopesSplit = qwr::string::Split<wchar_t>( responseJson.at( L"scope" ).as_string(), L' ' );
    pAuthData->scopes = WebApiAuthScopes( scopesSplit );

    const auto settingsPath = path::WebApiSettings();
    if ( !fs::exists( settingsPath ) )
    {
        fs::create_directories( settingsPath );
    }
    // not using component config because it's not saved immediately
    qwr::file::WriteFile( settingsPath / "auth.json", nlohmann::json( pAuthData ).dump( 2 ) );

    pAuthData_ = std::move( pAuthData );
}

} // namespace sptf


================================================
FILE: foo_spotify/backend/webapi_auth.h
================================================
#pragma once

#include <cpprest/asyncrt_utils.h>
#include <cpprest/http_client.h>
#include <cpprest/http_msg.h>

#include <chrono>

namespace web::http::experimental::listener
{
class http_listener;
}

namespace sptf
{

class AbortManager;
struct WebApiAuthScopes;
struct AuthData;

class WebApiAuthorizer
{
public:
    WebApiAuthorizer( const web::http::client::http_client_config& config, AbortManager& abortManager );
    ~WebApiAuthorizer();

    bool HasRefreshToken() const;

    const std::wstring GetAccessToken( abort_callback& abort );

    void ClearAuth();
    void CancelAuth();

    void AuthenticateClean( const WebApiAuthScopes& scopes, std::function<void()> onResponseEnd );
    void AuthenticateClean_Cleanup();
    void UpdateRefreshToken( abort_callback& abort );

private:
    void UpdateRefreshToken_NonBlocking( abort_callback& abort );
    pplx::task<void> CompleteAuthentication( const std::wstring& respondUrl );

    void StartResponseListener( std::function<void()> onResponseEnd );
    void StopResponseListener();
    void HandleAuthenticationResponse( const web::http::http_response& response );

private:
    AbortManager& abortManager_;

    pplx::cancellation_token_source cts_;
    web::http::client::http_client client_;
    std::unique_ptr<web::http::experimental::listener::http_listener> pListener_;

    std::wstring codeVerifier_;
    std::wstring state_;

    mutable std::mutex accessTokenMutex_;
    std::unique_ptr<AuthData> pAuthData_;
};

} // namespace sptf

================================================
FILE: foo_spotify/backend/webapi_auth_scopes.cpp
================================================
#include <stdafx.h>

#include "webapi_auth_scopes.h"

#include <unordered_set>

using namespace std::literals::string_view_literals;

namespace sptf
{

WebApiAuthScopes::WebApiAuthScopes( nonstd::span<const std::wstring_view> scopes )
{
    std::unordered_set<std::wstring_view> scopeSet( scopes.cbegin(), scopes.cend() );

#define SPTF_FILL_SCOPE( scope_var, scope_id ) \
    if ( scopeSet.count( scope_id ) )          \
    {                                          \
        scope_var = true;                      \
    }

    SPTF_FILL_SCOPE( playlist_modify_public, L"playlist-modify-public"sv )
    SPTF_FILL_SCOPE( playlist_read_private, L"playlist-read-private"sv )
    SPTF_FILL_SCOPE( playlist_modify_private, L"playlist-modify-private"sv )
    SPTF_FILL_SCOPE( playlist_read_collaborative, L"playlist-read-collaborative"sv )
    SPTF_FILL_SCOPE( user_read_playback_position, L"user-read-playback-position"sv )
    SPTF_FILL_SCOPE( user_read_recently_played, L"user-read-recently-played"sv )
    SPTF_FILL_SCOPE( user_top_read, L"user-top-read"sv )
    SPTF_FILL_SCOPE( user_follow_modify, L"user-follow-modify"sv )
    SPTF_FILL_SCOPE( user_follow_read, L"user-follow-read"sv )
    SPTF_FILL_SCOPE( user_library_read, L"user-library-read"sv )
    SPTF_FILL_SCOPE( user_library_modify, L"user-library-modify"sv )
    SPTF_FILL_SCOPE( user_read_private, L"user-read-private"sv )
    SPTF_FILL_SCOPE( user_read_email, L"user-read-email"sv )

#undef SPTF_FILL_SCOPE
}

std::wstring WebApiAuthScopes::ToWebString() const
{
    std::wstring ret;

#define SPTF_FILL_SCOPE( scope_var, scope_id ) \
    if ( scope_var )                           \
    {                                          \
        ret += scope_id;                       \
        ret += L" ";                           \
    }

    SPTF_FILL_SCOPE( playlist_modify_public, L"playlist-modify-public"sv )
    SPTF_FILL_SCOPE( playlist_read_private, L"playlist-read-private"sv )
    SPTF_FILL_SCOPE( playlist_modify_private, L"playlist-modify-private"sv )
    SPTF_FILL_SCOPE( playlist_read_collaborative, L"playlist-read-collaborative"sv )
    SPTF_FILL_SCOPE( user_read_playback_position, L"user-read-playback-position"sv )
    SPTF_FILL_SCOPE( user_read_recently_played, L"user-read-recently-played"sv )
    SPTF_FILL_SCOPE( user_top_read, L"user-top-read"sv )
    SPTF_FILL_SCOPE( user_follow_modify, L"user-follow-modify"sv )
    SPTF_FILL_SCOPE( user_follow_read, L"user-follow-read"sv )
    SPTF_FILL_SCOPE( user_library_read, L"user-library-read"sv )
    SPTF_FILL_SCOPE( user_library_modify, L"user-library-modify"sv )
    SPTF_FILL_SCOPE( user_read_private, L"user-read-private"sv )
    SPTF_FILL_SCOPE( user_read_email, L"user-read-email"sv )

#undef SPTF_FILL_SCOPE

    return ret;
}

void to_json( nlohmann::json& j, const WebApiAuthScopes& p )
{
#define SPTF_FILL_SCOPE( scope_var ) \
    if ( p.scope_var )               \
    {                                \
        j[#scope_var] = p.scope_var; \
    }

    SPTF_FILL_SCOPE( playlist_modify_public )
    SPTF_FILL_SCOPE( playlist_read_private )
    SPTF_FILL_SCOPE( playlist_modify_private )
    SPTF_FILL_SCOPE( playlist_read_collaborative )
    SPTF_FILL_SCOPE( user_read_playback_position )
    SPTF_FILL_SCOPE( user_read_recently_played )
    SPTF_FILL_SCOPE( user_top_read )
    SPTF_FILL_SCOPE( user_follow_modify )
    SPTF_FILL_SCOPE( user_follow_read )
    SPTF_FILL_SCOPE( user_library_read )
    SPTF_FILL_SCOPE( user_library_modify )
    SPTF_FILL_SCOPE( user_read_private )
    SPTF_FILL_SCOPE( user_read_email )

#undef SPTF_FILL_SCOPE
}

void from_json( const nlohmann::json& j, WebApiAuthScopes& p )
{
#define SPTF_FILL_SCOPE( scope_var )         \
    if ( j.contains( #scope_var ) )          \
    {                                        \
        j[#scope_var].get_to( p.scope_var ); \
    }

    SPTF_FILL_SCOPE( playlist_modify_public )
    SPTF_FILL_SCOPE( playlist_read_private )
    SPTF_FILL_SCOPE( playlist_modify_private )
    SPTF_FILL_SCOPE( playlist_read_collaborative )
    SPTF_FILL_SCOPE( user_read_playback_position )
    SPTF_FILL_SCOPE( user_read_recently_played )
    SPTF_FILL_SCOPE( user_top_read )
    SPTF_FILL_SCOPE( user_follow_modify )
    SPTF_FILL_SCOPE( user_follow_read )
    SPTF_FILL_SCOPE( user_library_read )
    SPTF_FILL_SCOPE( user_library_modify )
    SPTF_FILL_SCOPE( user_read_private )
    SPTF_FILL_SCOPE( user_read_email )

#undef SPTF_FILL_SCOPE
}

} // namespace sptf


================================================
FILE: foo_spotify/backend/webapi_auth_scopes.h
================================================
#pragma once

#include <nonstd/span.hpp>

#include <string_view>

namespace sptf
{

struct WebApiAuthScopes
{
    WebApiAuthScopes() = default;
    WebApiAuthScopes( nonstd::span<const std::wstring_view> scopes );
    std::wstring ToWebString() const;

    bool playlist_modify_public = false;
    bool playlist_read_private = false;
    bool playlist_modify_private = false;
    bool playlist_read_collaborative = false;
    bool user_read_playback_position = false;
    bool user_read_recently_played = false;
    bool user_top_read = false;
    bool user_follow_modify = false;
    bool user_follow_read = false;
    bool user_library_read = false;
    bool user_library_modify = false;
    bool user_read_private = false;
    bool user_read_email = false;
};

void to_json( nlohmann::json& j, const WebApiAuthScopes& p );
void from_json( const nlohmann::json& j, WebApiAuthScopes& p );

} // namespace sptf


================================================
FILE: foo_spotify/backend/webapi_backend.cpp
================================================
#include <stdafx.h>

#include "webapi_backend.h"

#include <backend/webapi_auth.h>
#include <backend/webapi_objects/webapi_media_objects.h>
#include <backend/webapi_objects/webapi_paging_object.h>
#include <backend/webapi_objects/webapi_user.h>
#include <fb2k/advanced_config.h>
#include <utils/abort_manager.h>
#include <utils/json_std_extenders.h>
#include <utils/sleeper.h>

#include <component_urls.h>

#include <qwr/fb2k_adv_config.h>
#include <qwr/file_helpers.h>
#include <qwr/final_action.h>
#include <qwr/string_helpers.h>
#include <qwr/type_traits.h>
#include <qwr/winapi_error_helpers.h>

#include <filesystem>
#include <unordered_set>

// TODO: replace unique_ptr with shared_ptr wherever needed to avoid copying

namespace fs = std::filesystem;

namespace
{

constexpr size_t kRpsLimit = 2;

}

namespace sptf
{

WebApi_Backend::WebApi_Backend( AbortManager& abortManager )
    : abortManager_( abortManager )
    , shouldLogWebApiRequest_( config::advanced::logging_webapi_request )
    , shouldLogWebApiResponse_( config::advanced::logging_webapi_response )
    , rpsLimiter_( kRpsLimit )
    , client_( url::spotifyApi, GetClientConfig() )
    , trackCache_( "tracks" )
    , artistCache_( "artists" )
    , albumImageCache_( "albums" )
    , artistImageCache_( "artists" )
    , pAuth_( std::make_unique<WebApiAuthorizer>( GetClientConfig(), abortManager ) )
{
}

WebApi_Backend::~WebApi_Backend()
{
}

void WebApi_Backend::Finalize()
{
    cts_.cancel();
    pAuth_.reset();
}

WebApiAuthorizer& WebApi_Backend::GetAuthorizer()
{
    return *pAuth_;
}

std::unique_ptr<const sptf::WebApi_User> WebApi_Backend::GetUser( abort_callback& abort )
{
    if ( auto userOpt = userCache_.GetObjectFromCache();
         userOpt )
    {
        return std::unique_ptr<sptf::WebApi_User>( std::move( *userOpt ) );
    }
    else
    {
        web::uri_builder builder;
        builder.append_path( L"me" );

        const auto responseJson = GetJsonResponse( builder.to_uri(), abort );
        auto ret = responseJson.get<std::unique_ptr<WebApi_User>>();

        userCache_.CacheObject( *ret );
        return std::unique_ptr<sptf::WebApi_User>( std::move( ret ) );
    }
}

void WebApi_Backend::RefreshCacheForTracks( nonstd::span<const std::string> trackIds, abort_callback& abort )
{
    constexpr size_t kMaxItemsPerRequest = 50;

    // remove duplicates
    const auto uniqueIds = trackIds | ranges::to<std::unordered_set<std::string>>;

    for ( const auto& trackIdsChunk:
          uniqueIds
              | ranges::views::remove_if( [&]( const auto& id ) { return trackCache_.IsCached( id ); } )
              | ranges::views::chunk( kMaxItemsPerRequest ) )
    {
        const auto trackIdsStr = qwr::unicode::ToWide( qwr::string::Join( trackIdsChunk | ranges::to_vector, ',' ) );

        web::uri_builder builder;
        builder
            .append_path( L"tracks" )
            .append_query( L"ids", trackIdsStr );

        const auto responseJson = GetJsonResponse( builder.to_uri(), abort );
        const auto tracksIt = responseJson.find( "tracks" );
        qwr::QwrException::ExpectTrue( responseJson.cend() != tracksIt,
                                       L"Malformed track data response response: missing `tracks`" );

        auto ret = tracksIt->get<std::vector<std::unique_ptr<const WebApi_Track>>>();
        trackCache_.CacheObjects( ret );
    }
}

std::unique_ptr<const sptf::WebApi_Track>
WebApi_Backend::GetTrack( const std::string& trackId, abort_callback& abort, bool useRelink )
{
    // don't want to cache relinked tracks

    if ( auto trackOpt = trackCache_.GetObjectFromCache( trackId );
         !useRelink && trackOpt )
    {
        return std::unique_ptr<sptf::WebApi_Track>( std::move( *trackOpt ) );
    }
    else
    {
        web::uri_builder builder;
        builder
            .append_path( L"tracks" )
            .append_path( qwr::unicode::ToWide( trackId ) );
        if ( useRelink )
        {
            if ( const auto countryOpt = GetUser( abort )->country;
                 countryOpt )
            {
                builder.append_query( L"market", qwr::unicode::ToWide( *countryOpt ) );
            }
        }

        const auto responseJson = GetJsonResponse( builder.to_uri(), abort );
        auto ret = responseJson.get<std::unique_ptr<WebApi_Track>>();

        if ( !useRelink )
        {
            trackCache_.CacheObject( *ret );
        }
        return std::unique_ptr<sptf::WebApi_Track>( std::move( ret ) );
    }
}

std::vector<std::unique_ptr<const WebApi_Track>>
WebApi_Backend::GetTracks( nonstd::span<const std::string> trackIds, abort_callback& abort )
{
    RefreshCacheForTracks( trackIds, abort );

    return trackIds | ranges::views::transform( [&]( const auto& id ) -> std::unique_ptr<const WebApi_Track> {
               assert( trackCache_.IsCached( id ) );
               return std::move( *trackCache_.GetObjectFromCache( id ) );
           } )
           | ranges::to_vector;
}

std::tuple<
    std::vector<std::unique_ptr<const WebApi_Track>>,
    std::vector<std::unique_ptr<const WebApi_LocalTrack>>>
WebApi_Backend::GetTracksFromPlaylist( const std::string& playlistId, abort_callback& abort )
{
    constexpr size_t kMaxItemsPerRequest = 100;

    auto requestUri = [&] {
        web::uri_builder builder;
        builder
            .append_path( fmt::format( L"playlists/{}/tracks", qwr::unicode::ToWide( playlistId ) ) )
            .append_query( L"limit", kMaxItemsPerRequest, false );

        return builder.to_uri();
    }();

    std::vector<std::unique_ptr<const WebApi_Track>> tracks;
    std::vector<std::unique_ptr<const WebApi_LocalTrack>> localTracks;
    while ( true )
    {
        const auto responseJson = GetJsonResponse( requestUri, abort );
        const auto pPagingObject = responseJson.get<std::unique_ptr<const WebApi_PagingObject>>();

        auto playlistTracks = pPagingObject->items.get<std::vector<std::unique_ptr<WebApi_PlaylistTrack>>>();
        for ( auto& playlistTrack: playlistTracks )
        {
            std::visit( [&]( auto&& arg ) {
                using T = std::decay_t<decltype( arg )>;
                if constexpr ( std::is_same_v<T, WebApi_Track> )
                {
                    tracks.emplace_back( std::make_unique<T>( std::move( arg ) ) );
                }
                else if constexpr ( std::is_same_v<T, WebApi_LocalTrack> )
                {
                    localTracks.emplace_back( std::make_unique<T>( std::move( arg ) ) );
                }
                else
                {
                    static_assert( qwr::always_false_v<T>, "non-exhaustive visitor!" );
                }
            },
                        *playlistTrack->track );
        }

        if ( !pPagingObject->next )
        {
            break;
        }

        requestUri = *pPagingObject->next;
    }

    trackCache_.CacheObjects( tracks );
    return { std::move( tracks ), std::move( localTracks ) };
}

std::vector<std::unique_ptr<const sptf::WebApi_Track>>
WebApi_Backend::GetTracksFromAlbum( const std::string& albumId, abort_callback& abort )
{
    std::shared_ptr<WebApi_Album_Simplified> album;
    web::uri requestUri;
    std::vector<std::unique_ptr<WebApi_Track_Simplified>> ret;
    while ( true )
    {
        const auto responseJson = [&] {
            if ( requestUri.is_empty() )
            { // first paging object (and uri) is retrieved from album
                web::uri_builder builder;
                builder.append_path( fmt::format( L"albums/{}", qwr::unicode::ToWide( albumId ) ) );

                const auto responseJson = GetJsonResponse( builder.to_uri(), abort );
                responseJson.get_to( album );

                const auto tracksIt = responseJson.find( "tracks" );
                qwr::QwrException::ExpectTrue( responseJson.cend() != tracksIt,
                                               L"Malformed track data response: missing `tracks`" );

                return *tracksIt;
            }
            else
            {
                return GetJsonResponse( requestUri, abort );
            }
        }();

        const auto pPagingObject = responseJson.get<std::unique_ptr<const WebApi_PagingObject>>();

        auto newData = pPagingObject->items.get<std::vector<std::unique_ptr<WebApi_Track_Simplified>>>();
        ret.insert( ret.end(), make_move_iterator( newData.begin() ), make_move_iterator( newData.end() ) );

        if ( !pPagingObject->next )
        {
            break;
        }

        requestUri = *pPagingObject->next;
    }

    auto newRet = ranges::views::transform( ret, [&]( auto&& elem ) {
                      return std::make_unique<const WebApi_Track>( std::move( elem ), album );
                  } )
                  | ranges::to_vector;
    trackCache_.CacheObjects( newRet );
    return newRet;
}

std::vector<std::unique_ptr<const WebApi_Track>>
WebApi_Backend::GetTopTracksForArtist( const std::string& artistId, abort_callback& abort )
{
    const auto countryOpt = GetUser( abort )->country;
    qwr::QwrException::ExpectTrue( countryOpt.has_value(),
                                   "Adding artist top tracks requires `user-read-private` permission.\n"
                                   "Re-login to update your permission scope." );

    web::uri_builder builder;
    builder
        .append_path( L"artists" )
        .append_path( qwr::unicode::ToWide( artistId ) )
        .append_path( L"top-tracks" )
        .append_query( L"market", qwr::unicode::ToWide( *countryOpt ) );

    const auto responseJson = GetJsonResponse( builder.to_uri(), abort );

    const auto tracksIt = responseJson.find( "tracks" );
    qwr::QwrException::ExpectTrue( responseJson.cend() != tracksIt,
                                   L"Malformed track data response response: missing `tracks`" );

    auto ret = tracksIt->get<std::vector<std::unique_ptr<const WebApi_Track>>>();
    trackCache_.CacheObjects( ret );
    return ret;
}

std::vector<std::unordered_multimap<std::string, std::string>>
WebApi_Backend::GetMetaForTracks( nonstd::span<const std::unique_ptr<const WebApi_Track>> tracks )
{
    std::vector<std::unordered_multimap<std::string, std::string>> ret;
    for ( const auto& track: tracks )
    {
        auto& curMap = ret.emplace_back();

        // This length will be overriden during playback
        curMap.emplace( "SPTF_LENGTH", fmt::format( "{}", track->duration_ms ) );

        curMap.emplace( "TITLE", track->name );
        curMap.emplace( "TRACKNUMBER", fmt::format( "{}", track->track_number ) );
        curMap.emplace( "DISCNUMBER", fmt::format( "{}", track->disc_number ) );

        for ( const auto& artist: track->artists )
        {
            curMap.emplace( "ARTIST", artist->name );
        }

        const auto& album = track->album;
        curMap.emplace( "ALBUM", album->name );
        curMap.emplace( "DATE", album->release_date );

        for ( const auto& artist: album->artists )
        {
            curMap.emplace( "ALBUM ARTIST", artist->name );
        }
    }

    // TODO: cache data (<https://fy.3dyd.com/help/titleformatting/#Metadata_length_limitations> might be useful)
    // TODO: check webapi_objects for other fields

    return ret;
}

void WebApi_Backend::RefreshCacheForArtists( nonstd::span<const std::string> artistIds, abort_callback& abort )
{
    // remove duplicates
    const auto uniqueIds = artistIds | ranges::to<std::unordered_set<std::string>>;

    for ( const auto& idsChunk:
          uniqueIds
              | ranges::views::remove_if( [&]( const auto& id ) { return artistCache_.IsCached( id ); } )
              | ranges::views::chunk( 50 ) )
    {
        const auto idsStr = qwr::unicode::ToWide( qwr::string::Join( idsChunk | ranges::to_vector, ',' ) );

        web::uri_builder builder;
        builder
            .append_path( L"artists" )
            .append_query( L"ids", idsStr );

        const auto responseJson = GetJsonResponse( builder.to_uri(), abort );
        const auto artistsIt = responseJson.find( "artists" );
        qwr::QwrException::ExpectTrue( responseJson.cend() != artistsIt,
                                       L"Malformed track data response response: missing `artists`" );

        auto ret = artistsIt->get<std::vector<std::unique_ptr<const WebApi_Artist>>>();
        artistCache_.CacheObjects( ret );
    }
}

std::unique_ptr<const WebApi_Artist>
WebApi_Backend::GetArtist( const std::string& artistId, abort_callback& abort )
{
    if ( auto objectOpt = artistCache_.GetObjectFromCache( artistId );
         objectOpt )
    {
        return std::unique_ptr<const WebApi_Artist>( std::move( *objectOpt ) );
    }
    else
    {
        web::uri_builder builder;
        builder
            .append_path( L"artists" )
            .append_path( qwr::unicode::ToWide( artistId ) );

        const auto responseJson = GetJsonResponse( builder.to_uri(), abort );
        auto ret = responseJson.get<std::unique_ptr<const WebApi_Artist>>();
        artistCache_.CacheObject( *ret );
        return std::unique_ptr<const WebApi_Artist>( std::move( ret ) );
    }
}

fs::path WebApi_Backend::GetAlbumImage( const std::string& albumId, const std::string& imgUrl, abort_callback& abort )
{
    return albumImageCache_.GetImage( albumId, imgUrl, abort );
}

fs::path WebApi_Backend::GetArtistImage( const std::string& artistId, const std::string& imgUrl, abort_callback& abort )
{
    return artistImageCache_.GetImage( artistId, imgUrl, abort );
}

web::http::client::http_client_config WebApi_Backend::GetClientConfig()
{
    const auto proxyUrl = qwr::unicode::ToWide( sptf::config::advanced::network_proxy.GetValue() );
    const auto proxyUsername = qwr::unicode::ToWide( sptf::config::advanced::network_proxy_username.GetValue() );
    const auto proxyPassword = qwr::unicode::ToWide( sptf::config::advanced::network_proxy_password.GetValue() );

    web::http::client::http_client_config config;
    if ( !proxyUrl.empty() )
    {
        web::web_proxy proxy( web::uri::encode_uri( proxyUrl ) );
        if ( !proxyUsername.empty() && !proxyPassword.empty() )
        {
            proxy.set_credentials( web::credentials{ proxyUsername, proxyPassword } );
        }

        config.set_proxy( std::move( proxy ) );
    }

    return config;
}

nlohmann::json WebApi_Backend::GetJsonResponse( const web::uri& requestUri, abort_callback& abort )
{
    return ParseResponse( GetResponse( requestUri, abort ) );
}

web::http::http_response WebApi_Backend::GetResponse( const web::uri& requestUri, abort_callback& abort )
{
    const auto adjustedRequestUri = [&] {
        const auto uriStr = requestUri.to_string();
        const auto baseUriStr = client_.base_uri().to_string();
        if ( uriStr._Starts_with( baseUriStr ) )
        {
            return web::uri{ uriStr.data() + baseUriStr.size() };
        }
        else
        {
            return requestUri;
        }
    }();

    if ( shouldLogWebApiRequest_ )
    {
        FB2K_console_formatter() << SPTF_UNDERSCORE_NAME " (debug): request:\n"
                                 << qwr::unicode::ToU8( adjustedRequestUri.to_string() );
    }

    web::http::http_request req( web::http::methods::GET );
    req.headers().add( L"Authorization", fmt::format( L"Bearer {}", pAuth_->GetAccessToken( abort ) ) );
    req.headers().add( L"Accept", L"application/json" );
    req.headers().set_content_type( L"application/json" );

    req.set_request_uri( adjustedRequestUri );

    rpsLimiter_.WaitForRequestAvailability( abort );
    qwr::QwrException::ExpectTrue( !abort.is_aborting(), "Abort was signaled, canceling request..." );

    auto ctsToken = cts_.get_token();
    auto localCts = Concurrency::cancellation_token_source::create_linked_source( ctsToken );
    const auto abortableScope = abortManager_.GetAbortableScope( [&localCts] { localCts.cancel(); }, abort );

    web::http::http_response response;
    for ( size_t i = 0; i < 3; ++i )
    {
        response = client_.request( req, localCts.get_token() ).get();
        if ( response.status_code() != 429 )
        {
            break;
        }

        const auto it = response.headers().find( L"Retry-After" );
        qwr::QwrException::ExpectTrue( it != response.headers().end(), "Request failed with 429 error, but does not contain a `Retry-After` header" );

        const auto& [_, retryHeader] = *it;
        const auto retryInMsOpt = qwr::string::GetNumber<uint32_t>( qwr::unicode::ToU8( retryHeader ) );
        qwr::QwrException::ExpectTrue( retryInMsOpt.has_value(), "Request failed with 429 error, but does not contain a valid number in `Retry-After` header" );

        const auto retryIn = std::chrono::milliseconds( *retryInMsOpt ) + std::chrono::seconds( 1 );
        FB2K_console_formatter() << SPTF_UNDERSCORE_NAME " (error):\n"
                                 << fmt::format( L"Rate limit reached: retrying in {} ms", retryIn.count() );
        if ( !SleepFor( retryIn, abort ) )
        {
            break;
        }
    }

    if ( response.status_code() == 429 )
    {
        FB2K_console_formatter() << SPTF_UNDERSCORE_NAME " (error):\n"
                                 << fmt::format( L"Rate limit reached: retry failed" );
    }

    return response;
}

nlohmann::json WebApi_Backend::ParseResponse( const web::http::http_response& response )
{
    if ( response.status_code() != 200 )
    {
        throw qwr::QwrException( L"{}: {}\n"
                                 L"Additional data: {}\n",
                                 (int)response.status_code(),
                                 response.reason_phrase(),
                                 [&]() -> std::wstring {
                                     try
                                     {
                                         const auto responseJson = nlohmann::json::parse( response.extract_string().get() );
                                         return qwr::unicode::ToWide( responseJson.dump( 2 ) );
                                     }
                                     catch ( ... )
                                     {
                                         return response.to_string();
                                     }
                                 }() );
    }

    const auto responseJson = nlohmann::json::parse( response.extract_string().get() );
    if ( shouldLogWebApiResponse_ )
    {
        FB2K_console_formatter() << SPTF_UNDERSCORE_NAME " (debug): response:\n"
                                 << responseJson.dump( 2 );
    }
    qwr::QwrException::ExpectTrue( responseJson.is_object(),
                                   L"Malformed track data response response: json is not an object" );

    return responseJson;
}

} // namespace sptf


================================================
FILE: foo_spotify/backend/webapi_backend.h
================================================
#pragma once

#include <backend/webapi_cache.h>
#include <utils/rps_limiter.h>

#include <cpprest/http_client.h>
#include <nonstd/span.hpp>

#include <filesystem>
#include <tuple>
#include <unordered_map>
#include <vector>

namespace sptf
{

struct WebApi_User;
struct WebApi_Track;
struct WebApi_LocalTrack;
struct WebApi_Artist;
class WebApiAuthorizer;
class AbortManager;

class WebApi_Backend
{
public:
    WebApi_Backend( AbortManager& abortManager );
    ~WebApi_Backend();

    void Finalize();

    WebApiAuthorizer& GetAuthorizer();

    std::unique_ptr<const sptf::WebApi_User> GetUser( abort_callback& abort );

    void RefreshCacheForTracks( nonstd::span<const std::string> trackIds, abort_callback& abort );

    std::unique_ptr<const WebApi_Track>
    GetTrack( const std::string& trackId, abort_callback& abort, bool useRelink = false );

    std::vector<std::unique_ptr<const WebApi_Track>>
    GetTracks( nonstd::span<const std::string> trackIds, abort_callback& abort );

    std::tuple<
        std::vector<std::unique_ptr<const WebApi_Track>>,
        std::vector<std::unique_ptr<const WebApi_LocalTrack>>>
    GetTracksFromPlaylist( const std::string& playlistId, abort_callback& abort );

    std::vector<std::unique_ptr<const WebApi_Track>>
    GetTracksFromAlbum( const std::string& albumId, abort_callback& abort );

    std::vector<std::unique_ptr<const WebApi_Track>>
    GetTopTracksForArtist( const std::string& artistId, abort_callback& abort );

    std::vector<std::unordered_multimap<std::string, std::string>>
    GetMetaForTracks( nonstd::span<const std::unique_ptr<const WebApi_Track>> tracks );

    void RefreshCacheForArtists( nonstd::span<const std::string> artistIds, abort_callback& abort );

    std::unique_ptr<const WebApi_Artist>
    GetArtist( const std::string& artistId, abort_callback& abort );

    std::filesystem::path GetAlbumImage( const std::string& albumId, const std::string& imgUrl, abort_callback& abort );
    std::filesystem::path GetArtistImage( const std::string& artistId, const std::string& imgUrl, abort_callback& abort );

private:
    static web::http::client::http_client_config GetClientConfig();

    nlohmann::json GetJsonResponse( const web::uri& requestUri, abort_callback& abort );
    web::http::http_response GetResponse( const web::uri& requestUri, abort_callback& abort );
    nlohmann::json ParseResponse( const web::http::http_response& response );

private:
    AbortManager& abortManager_;
    RpsLimiter rpsLimiter_;

    bool shouldLogWebApiRequest_ = false;
    bool shouldLogWebApiResponse_ = false;

    pplx::cancellation_token_source cts_;
    std::unique_ptr<WebApiAuthorizer> pAuth_;
    web::http::client::http_client client_;

    WebApi_UserCache userCache_;
    WebApi_ObjectCache<WebApi_Track> trackCache_;
    WebApi_ObjectCache<WebApi_Artist> artistCache_;

    WebApi_ImageCache albumImageCache_;
    WebApi_ImageCache artistImageCache_;
};

} // namespace sptf


================================================
FILE: foo_spotify/backend/webapi_cache.cpp
================================================
#include <stdafx.h>

#include "webapi_cache.h"

#include <backend/spotify_instance.h>
#include <backend/webapi_objects/webapi_user.h>
#include <utils/abort_manager.h>
#include <utils/json_std_extenders.h>

#include <qwr/winapi_error_helpers.h>

// RODO: move to props
#pragma comment( lib, "Urlmon.lib" )

namespace fs = std::filesystem;

namespace
{

using namespace sptf;

class DownloadStatus : public IBindStatusCallback
{
public:
    DownloadStatus( abort_callback& abort );

public:
    STDMETHOD( OnStartBinding )(
        /* [in] */ DWORD dwReserved,
        /* [in] */ IBinding __RPC_FAR* pib )
    {
        return E_NOTIMPL;
    }

    STDMETHOD( GetPriority )(
        /* [out] */ LONG __RPC_FAR* pnPriority )
    {
        return E_NOTIMPL;
    }

    STDMETHOD( OnLowResource )(
        /* [in] */ DWORD reserved )
    {
        return E_NOTIMPL;
    }

    STDMETHOD( OnProgress )(
        /* [in] */ ULONG ulProgress,
        /* [in] */ ULONG ulProgressMax,
        /* [in] */ ULONG ulStatusCode,
        /* [in] */ LPCWSTR wszStatusText );

    STDMETHOD( OnStopBinding )(
        /* [in] */ HRESULT hresult,
        /* [unique][in] */ LPCWSTR szError )
    {
        return E_NOTIMPL;
    }

    STDMETHOD( GetBindInfo )(
        /* [out] */ DWORD __RPC_FAR* grfBINDF,
        /* [unique][out][in] */ BINDINFO __RPC_FAR* pbindinfo )
    {
        return E_NOTIMPL;
    }

    STDMETHOD( OnDataAvailable )(
        /* [in] */ DWORD grfBSCF,
        /* [in] */ DWORD dwSize,
        /* [in] */ FORMATETC __RPC_FAR* pformatetc,
        /* [in] */ STGMEDIUM __RPC_FAR* pstgmed )
    {
        return E_NOTIMPL;
    }

    STDMETHOD( OnObjectAvailable )(
        /* [in] */ REFIID riid,
        /* [iid_is][in] */ IUnknown __RPC_FAR* punk )
    {
        return E_NOTIMPL;
    }

    // IUnknown methods.  Note that IE never calls any of these methods, since
    // the caller owns the IBindStatusCallback interface, so the methods all
    // return zero/E_NOTIMPL.

    STDMETHOD_( ULONG, AddRef )
    ()
    {
        return 0;
    }

    STDMETHOD_( ULONG, Release )
    ()
    {
        return 0;
    }

    STDMETHOD( QueryInterface )(
        /* [in] */ REFIID riid,
        /* [iid_is][out] */ void __RPC_FAR* __RPC_FAR* ppvObject )
    {
        return E_NOTIMPL;
    }

private:
    std::unique_ptr<AbortManager::AbortableScope> pScope_;
    std::mutex mutex_;
    bool hasAborted_ = false;
};

DownloadStatus::DownloadStatus( abort_callback& abort )
{
    auto& am = SpotifyInstance::Get().GetAbortManager();
    pScope_ = std::make_unique<AbortManager::AbortableScope>(
        am.GetAbortableScope( [&] {
            std::lock_guard lg( mutex_ );
            hasAborted_ = true;
        },
                              abort ) );
}

HRESULT DownloadStatus::OnProgress( ULONG ulProgress, ULONG ulProgressMax,
                                    ULONG ulStatusCode, LPCWSTR wszStatusText )
{
    std::lock_guard lg( mutex_ );
    return ( hasAborted_ ? E_ABORT : S_OK );
}

} // namespace

namespace sptf
{

WebApi_UserCache::WebApi_UserCache()
    : jsonCache_( "" )
{
}

void WebApi_UserCache::CacheObject( const WebApi_User& object, bool force /*= false */ )
{
    std::lock_guard lock( cacheMutex_ );
    jsonCache_.CacheObject_NonBlocking( object, "me", force );
}

std::optional<std::unique_ptr<sptf::WebApi_User>> WebApi_UserCache::GetObjectFromCache()
{
    std::lock_guard lock( cacheMutex_ );
    return jsonCache_.GetObjectFromCache_NonBlocking( "me" );
}

WebApi_ImageCache::WebApi_ImageCache( const std::string& cacheSubdir )
    : cacheSubdir_( cacheSubdir )
{
}

fs::path WebApi_ImageCache::GetImage( const std::string& id, const std::string& imgUrl, abort_callback& abort )
{
    std::lock_guard lock( cacheMutex_ );

    const auto imagePath = path::WebApiCache() / "images" / cacheSubdir_ / fmt::format( "{}.jpeg", id );
    if ( !fs::exists( imagePath ) )
    {
        fs::create_directories( imagePath.parent_path() );

        const auto url_w = qwr::unicode::ToWide( imgUrl );

        DownloadStatus ds( abort );
        auto hr = URLDownloadToFile( nullptr, url_w.c_str(), imagePath.c_str(), 0, &ds );
        if ( FAILED( hr ) )
        {
            fs::remove( imagePath ); // in case download was aborted midway
            qwr::error::CheckHR( hr, "URLDownloadToFile" );
        }
    }
    assert( fs::exists( imagePath ) );
    return imagePath;
}

} // namespace sptf


================================================
FILE: foo_spotify/backend/webapi_cache.h
================================================
#pragma once

#include <nonstd/span.hpp>
#include <qwr/file_helpers.h>

#include <filesystem>
#include <memory>
#include <mutex>

namespace sptf
{

template <typename T>
class WebApi_JsonCache
{
public:
    WebApi_JsonCache( const std::string& cacheSubdir )
        : cacheSubdir_( cacheSubdir )
    {
    }

    std::optional<std::unique_ptr<T>>
    GetObjectFromCache_NonBlocking( const std::string& filename )
    {
        namespace fs = std::filesystem;

        const auto filePath = GetCachedPath( filename );
        if ( !fs::exists( filePath ) )
        {
            return std::nullopt;
        }

        const auto data = qwr::file::ReadFile( filePath, CP_UTF8, false );
        try
        {
            return nlohmann::json::parse( data ).get<std::unique_ptr<T>>();
        }
        catch ( const nlohmann::detail::exception& )
        {
            return std::nullopt;
        }
    }

    void CacheObject_NonBlocking( const T& object, const std::string& filename, bool force )
    {
        namespace fs = std::filesystem;

        const auto filePath = GetCachedPath( filename );
        if ( fs::exists( filePath ) )
        {
            if ( !force )
            {
                return;
            }
            fs::remove( filePath );
        }

        fs::create_directories( filePath.parent_path() );
        qwr::file::WriteFile( filePath, nlohmann::json( object ).dump( 2 ) );
    }

    bool IsCached_NonBlocking( const std::string& filename )
    {
        namespace fs = std::filesystem;

        const auto filePath = GetCachedPath( filename );
        return fs::exists( filePath );
    }

private:
    std::filesystem::path GetCachedPath( const std::string& filename ) const
    {
        return path::WebApiCache() / "data" / cacheSubdir_ / fmt::format( "{}.json", filename );
    }

private:
    std::string cacheSubdir_;
};

template <typename T>
class WebApi_ObjectCache
{
public:
    WebApi_ObjectCache( const std::string& cacheSubdir )
        : jsonCache_( cacheSubdir )
    {
    }

    void CacheObject( const T& object, bool force = false )
    {
        std::lock_guard lock( cacheMutex_ );
        jsonCache_.CacheObject_NonBlocking( object, object.id, force );
    }

    void CacheObjects( const nonstd::span<std::unique_ptr<T>> objects, bool force = false )
    {
        std::lock_guard lock( cacheMutex_ );
        for ( const auto& pObject: objects )
        {
            jsonCache_.CacheObject_NonBlocking( *pObject, pObject->id, force );
        }
    }

    void CacheObjects( const nonstd::span<std::unique_ptr<const T>> objects, bool force = false )
    {
        std::lock_guard lock( cacheMutex_ );
        for ( const auto& pObject: objects )
        {
            jsonCache_.CacheObject_NonBlocking( *pObject, pObject->id, force );
        }
    }

    std::optional<std::unique_ptr<T>>
    GetObjectFromCache( const std::string& id )
    {
        std::lock_guard lock( cacheMutex_ );
        return jsonCache_.GetObjectFromCache_NonBlocking( id );
    }

    bool IsCached( const std::string& id )
    {
        std::lock_guard lock( cacheMutex_ );
        return jsonCache_.IsCached_NonBlocking( id );
    }

private:
    std::mutex cacheMutex_;
    WebApi_JsonCache<T> jsonCache_;
};

struct WebApi_User;

class WebApi_UserCache
{
public:
    WebApi_UserCache();

    void CacheObject( const WebApi_User& object, bool force = false );

    std::optional<std::unique_ptr<WebApi_User>>
    GetObjectFromCache();

private:
    std::mutex cacheMutex_;
    WebApi_JsonCache<WebApi_User> jsonCache_;
};

class WebApi_ImageCache
{
public:
    WebApi_ImageCache( const std::string& cacheSubdir );

    std::filesystem::path GetImage( const std::string& id,
                                    const std::string& imgUrl,
                                    abort_callback& abort );

private:
    std::string cacheSubdir_;
    std::mutex cacheMutex_;
};

} // namespace sptf


================================================
FILE: foo_spotify/backend/webapi_objects/webapi_album.cpp
================================================
#include <stdafx.h>

#include "webapi_album.h"

#include <backend/webapi_objects/webapi_media_objects.h>
#include <utils/json_std_extenders.h>

namespace sptf
{

SPTF_NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE( WebApi_Album_Simplified, artists, images, release_date, name, id );

} // namespace sptf


================================================
FILE: foo_spotify/backend/webapi_objects/webapi_album.h
================================================
#pragma once

#include <memory>
#include <string>
#include <vector>

namespace sptf
{

struct WebApi_Artist_Simplified;
struct WebApi_Image;

struct WebApi_Album_Simplified
{
    // album_group 	string, optional 	The field is present when getting an artists albums. Possible values are album, single, compilation, appears_on. Compare to album_type this field represents relationship between the artist and the album.
    // album_type 	string 	The type of the album: one of album, single, or compilation.
    // available_markets 	array of strings 	The markets in which the album is available: ISO 3166-1 alpha-2 country codes. Note that an album is considered available in a market when at least 1 of its tracks is available in that market.
    // external_urls 	an external URL object 	Known external URLs for this album.
    // release_date_precision 	string 	The precision with which release_date value is known: year , month , or day.
    // restrictions 	a restrictions object 	Part of the response when Track Relinking is applied, the original track is not available in the given market, and Spotify did not have any tracks to relink it with. The track response will still contain metadata for the original track, and a restrictions object containing the reason why the track is not available: "restrictions" : {"reason" : "market"}

    std::vector<std::unique_ptr<WebApi_Artist_Simplified>> artists;
    std::vector<std::unique_ptr<WebApi_Image>> images;
    std::string id;
    std::string release_date;
    std::string name;
};

void to_json( nlohmann::json& j, const WebApi_Album_Simplified& p );
void from_json( const nlohmann::json& j, WebApi_Album_Simplified& p );

} // namespace sptf

================================================
FILE: foo_spotify/backend/webapi_objects/webapi_artist.cpp
================================================
#include <stdafx.h>

#include "webapi_artist.h"

#include <backend/webapi_objects/webapi_media_objects.h>
#include <utils/json_std_extenders.h>

namespace sptf
{

SPTF_NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE( WebApi_Artist_Simplified, id, name );
SPTF_NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE( WebApi_Artist, id, images, name, popularity );

} // namespace sptf


================================================
FILE: foo_spotify/backend/webapi_objects/webapi_artist.h
================================================
#pragma once

#include <string>

namespace sptf
{

struct WebApi_Image;

struct WebApi_Artist_Simplified
{
    // external_urls 	an external URL object 	Known external URLs for this artist.

    std::string id;
    std::string name;
};

struct WebApi_Artist
{
    // external_urls 	an external URL object 	Known external URLs for this artist.
    // followers 	A followers object 	Information about the followers of the artist.
    // genres 	array of strings 	A list of the genres the artist is associated with. For example: "Prog Rock" , "Post-Grunge". (If not yet classified, the array is empty.)

    std::string id;
    std::vector<std::unique_ptr<WebApi_Image>> images;
    std::string name;
    uint32_t popularity;
};

void to_json( nlohmann::json& j, const WebApi_Artist_Simplified& p );
void from_json( const nlohmann::json& j, WebApi_Artist_Simplified& p );

void to_json( nlohmann::json& j, const WebApi_Artist& p );
void from_json( const nlohmann::json& j, WebApi_Artist& p );

} // namespace sptf

================================================
FILE: foo_spotify/backend/webapi_objects/webapi_image.cpp
================================================
#include <stdafx.h>

#include "webapi_image.h"

namespace sptf
{

SPTF_NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE( WebApi_Image, height, url, width );

} // namespace sptf


================================================
FILE: foo_spotify/backend/webapi_objects/webapi_image.h
================================================
#pragma once

#include <memory>
#include <string>

namespace sptf
{

struct WebApi_Image
{
    uint32_t height;
    std::string url;
    uint32_t width;
};

void to_json( nlohmann::json& j, const WebApi_Image& p );
void from_json( const nlohmann::json& j, WebApi_Image& p );

} // namespace sptf

================================================
FILE: foo_spotify/backend/webapi_objects/webapi_media_objects.h
================================================
#pragma once

#include <backend/webapi_objects/webapi_album.h>
#include <backend/webapi_objects/webapi_artist.h>
#include <backend/webapi_objects/webapi_image.h>
#include <backend/webapi_objects/webapi_playlist_track.h>
#include <backend/webapi_objects/webapi_restriction.h>
#include <backend/webapi_objects/webapi_track.h>
#include <backend/webapi_objects/webapi_track_link.h>


================================================
FILE: foo_spotify/backend/webapi_objects/webapi_paging_object.cpp
================================================
#include <stdafx.h>

#include "webapi_paging_object.h"

#include <utils/json_std_extenders.h>

namespace sptf
{

void from_json( const nlohmann::json& nlohmann_json_j, WebApi_PagingObject& nlohmann_json_t )
{
    NLOHMANN_JSON_EXPAND( NLOHMANN_JSON_PASTE( NLOHMANN_JSON_FROM, items, limit, next, offset, previous, total ) )
}

} // namespace sptf


================================================
FILE: foo_spotify/backend/webapi_objects/webapi_paging_object.h
================================================
#pragma once

#include <memory>
#include <optional>
#include <string>

namespace sptf
{

struct WebApi_PagingObject
{
    // href 	string 	A link to the Web API endpoint returning the full result of the request.
    nlohmann::json items;
    size_t limit;
    std::optional<std::wstring> next;
    size_t offset;
    std::optional<std::wstring> previous;
    size_t total;
};

void from_json( const nlohmann::json& j, WebApi_PagingObject& p );

} // namespace sptf


================================================
FILE: foo_spotify/backend/webapi_objects/webapi_playlist_track.cpp
================================================
#include <stdafx.h>

#include "webapi_playlist_track.h"

#include <backend/webapi_objects/webapi_media_objects.h>
#include <utils/json_std_extenders.h>

namespace sptf
{

void to_json( nlohmann::json& j, const WebApi_PlaylistTrack& p )
{
    std::visit( [&j]( auto&& arg ) {
        j["track"] = arg;
    },
                *p.track );
}

void from_json( const nlohmann::json& j, WebApi_PlaylistTrack& p )
{
    if ( j.at( "is_local" ).get<bool>() )
    {
        p.track = std::make_unique<std::variant<WebApi_Track, WebApi_LocalTrack>>( j.at( "track" ).get<WebApi_LocalTrack>() );
    }
    else
    {
        p.track = std::make_unique<std::variant<WebApi_Track, WebApi_LocalTrack>>( j.at( "track" ).get<WebApi_Track>() );
    }
}

SPTF_NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE( WebApi_LocalTrack, uri, name );

} // namespace sptf


================================================
FILE: foo_spotify/backend/webapi_objects/webapi_playlist_track.h
================================================
#pragma once

#include <memory>
#include <string>
#include <variant>

namespace sptf
{

struct WebApi_Track;

struct WebApi_LocalTrack
{
    std::string uri;
    std::optional<std::string> name;
};

struct WebApi_PlaylistTrack
{
    // added_at 	a timestamp 	The date and time the track was added. Note that some very old playlists may return null in this field.
    // added_by 	a user object 	The Spotify user who added the track. Note that some very old playlists may return null in this field.
    std::unique_ptr<std::variant<WebApi_Track, WebApi_LocalTrack>> track;
};

void to_json( nlohmann::json& j, const WebApi_PlaylistTrack& p );
void from_json( const nlohmann::json& j, WebApi_PlaylistTrack& p );

void to_json( nlohmann::json& j, const WebApi_LocalTrack& p );
void from_json( const nlohmann::json& j, WebApi_LocalTrack& p );

} // namespace sptf


================================================
FILE: foo_spotify/backend/webapi_objects/webapi_restriction.cpp
================================================
#include <stdafx.h>

#include "webapi_restriction.h"

namespace sptf
{

SPTF_NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE( WebApi_Restriction, reason );

} // namespace sptf


================================================
FILE: foo_spotify/backend/webapi_objects/webapi_restriction.h
================================================
#pragma once

#include <memory>
#include <string>

namespace sptf
{

struct WebApi_Restriction
{
    std::string reason;
};

void to_json( nlohmann::json& j, const WebApi_Restriction& p );
void from_json( const nlohmann::json& j, WebApi_Restriction& p );

} // namespace sptf

================================================
FILE: foo_spotify/backend/webapi_objects/webapi_track.cpp
================================================
#include <stdafx.h>

#include "webapi_track.h"

#include <backend/webapi_objects/webapi_media_objects.h>
#include <utils/json_std_extenders.h>

namespace sptf
{

WebApi_Track::WebApi_Track( std::unique_ptr<WebApi_Track_Simplified> trackSimplified,
                            std::shared_ptr<const WebApi_Album_Simplified> albumSimplified )
{
    album = albumSimplified;
    artists = std::move( trackSimplified->artists );
    disc_number = trackSimplified->disc_number;
    duration_ms = trackSimplified->duration_ms;
    name = trackSimplified->name;
    linked_from = std::move( trackSimplified->linked_from );
    restrictions = std::move( trackSimplified->restrictions );
    preview_url = trackSimplified->preview_url;
    track_number = trackSimplified->track_number;
    id = trackSimplified->id;
}

void to_json( nlohmann::json& nlohmann_json_j, const WebApi_Track_Simplified& nlohmann_json_t )
{
    // we don't need to save `restrictions`, since it's only used on initial parsing
    NLOHMANN_JSON_EXPAND( NLOHMANN_JSON_PASTE( NLOHMANN_JSON_TO, artists, disc_number, duration_ms, linked_from, name, preview_url, track_number, id ) )
}

void from_json( const nlohmann::json& nlohmann_json_j, WebApi_Track_Simplified& nlohmann_json_t )
{
    NLOHMANN_JSON_EXPAND( NLOHMANN_JSON_PASTE( NLOHMANN_JSON_FROM, artists, disc_number, duration_ms, name, preview_url, track_number, id ) )
    if ( nlohmann_json_j.contains( "linked_from" ) )
    {
        NLOHMANN_JSON_FROM( linked_from )
    }
    if ( nlohmann_json_j.contains( "restrictions" ) )
    {
        NLOHMANN_JSON_FROM( restrictions )
    }
}

void to_json( nlohmann::json& nlohmann_json_j, const WebApi_Track& nlohmann_json_t )
{
    // we don't need to save `restrictions`, since it's only used on initial parsing
    NLOHMANN_JSON_EXPAND( NLOHMANN_JSON_PASTE( NLOHMANN_JSON_TO, album, artists, disc_number, duration_ms, linked_from, name, preview_url, track_number, id ) )
}

void from_json( const nlohmann::json& nlohmann_json_j, WebApi_Track& nlohmann_json_t )
{
    NLOHMANN_JSON_EXPAND( NLOHMANN_JSON_PASTE( NLOHMANN_JSON_FROM, album, artists, disc_number, duration_ms, name, preview_url, track_number, id ) )
    if ( nlohmann_json_j.contains( "linked_from" ) )
    {
        NLOHMANN_JSON_FROM( linked_from )
    }
    if ( nlohmann_json_j.contains( "restrictions" ) )
    {
        NLOHMANN_JSON_FROM( restrictions )
    }
}

} // namespace sptf


================================================
FILE: foo_spotify/backend/webapi_objects/webapi_track.h
================================================
#pragma once

#include <memory>
#include <string>
#include <vector>

namespace sptf
{

struct WebApi_Album_Simplified;
struct WebApi_Artist_Simplified;
struct WebApi_Restriction;
struct WebApi_TrackLink;

struct WebApi_Track_Simplified
{
    // available_markets 	array of strings 	A list of the countries in which the track can be played, identified by their ISO 3166-1 alpha-2 code.
    // explicit 	Boolean 	Whether or not the track has explicit lyrics ( true = yes it does; false = no it does not OR unknown).
    // external_urls 	an external URL object 	External URLs for this track.
    // is_playable boolean Part of the response when Track Relinking is applied.If true, the track is playable in the given market.Otherwise false.
    // is_local 	boolean 	Whether or not the track is from a local file.

    std::vector<std::unique_ptr<WebApi_Artist_Simplified>> artists;
    uint32_t disc_number;
    uint32_t duration_ms;
    std::string id;
    std::optional<std::unique_ptr<WebApi_TrackLink>> linked_from;
    std::optional<std::unique_ptr<WebApi_Restriction>> restrictions;
    std::string name;
    std::optional<std::string> preview_url;
    uint32_t track_number;
};

struct WebApi_Track
{
    WebApi_Track() = default;
    WebApi_Track( std::unique_ptr<WebApi_Track_Simplified> trackSimplified, std::shared_ptr<const WebApi_Album_Simplified> albumSimplified );

    //available_markets 	array of strings 	A list of the countries in which the track can be played, identified by their ISO 3166-1 alpha-2 code.
    //explicit 	Boolean 	Whether or not the track has explicit lyrics ( true = yes it does; false = no it does not OR unknown).
    //external_ids 	an external ID object 	Known external IDs for the track.
    //external_urls 	an external URL object 	Known external URLs for this track.
    //is_playable boolean Part of the response when Track Relinking is applied.If true, the track is playable in the given market.Otherwise false.
    //popularity 	integer 	The popularity of the track. The value will be between 0 and 100, with 100 being the most popular.
    //The popularity of a track is a value between 0 and 100, with 100 being the most popular. The popularity is calculated by algorithm and is based, in the most part, on the total number of plays the track has had and how recent those plays are.
    //Generally speaking, songs that are being played a lot now will have a higher popularity than songs that were played a lot in the past. Duplicate tracks (e.g. the same track from a single and an album) are rated independently. Artist and album popularity is derived mathematically from track popularity. Note that the popularity value may lag actual popularity by a few days: the value is not updated in real time.
    //is_local 	boolean 	Whether or not the track is from a local file.

    std::shared_ptr<const WebApi_Album_Simplified> album;
    std::vector<std::unique_ptr<WebApi_Artist_Simplified>> artists;
    uint32_t disc_number;
    uint32_t duration_ms;
    std::string id;
    std::optional<std::unique_ptr<WebApi_TrackLink>> linked_from;
    std::optional<std::unique_ptr<WebApi_Restriction>> restrictions;
    std::string name;
    std::optional<std::string> preview_url;
    uint32_t track_number;
};

void to_json( nlohmann::json& j, const WebApi_Track_Simplified& p );
void from_json( const nlohmann::json& j, WebApi_Track_Simplified& p );

void to_json( nlohmann::json& j, const WebApi_Track& p );
void from_json( const nlohmann::json& j, WebApi_Track& p );

} // namespace sptf


================================================
FILE: foo_spotify/backend/webapi_objects/webapi_track_link.cpp
================================================
#include <stdafx.h>

#include "webapi_track_link.h"

#include <backend/webapi_objects/webapi_media_objects.h>
#include <utils/json_std_extenders.h>

namespace sptf
{

SPTF_NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE( WebApi_TrackLink, id );

} // namespace sptf


================================================
FILE: foo_spotify/backend/webapi_objects/webapi_track_link.h
================================================
#pragma once

#include <memory>
#include <string>
namespace sptf
{

struct WebApi_TrackLink
{
    // external_urls 	an external URL object 	Known external URLs for this track.
    // href 	string 	A link to the Web API endpoint providing full details of the track.
    std::string id;
    // type 	string 	The object type: track.
    // uri 	string 	The Spotify URI for the track.
};

void to_json( nlohmann::json& j, const WebApi_TrackLink& p );
void from_json( const nlohmann::json& j, WebApi_TrackLink& p );

} // namespace sptf


================================================
FILE: foo_spotify/backend/webapi_objects/webapi_user.cpp
================================================
#include <stdafx.h>

#include "webapi_user.h"

#include <utils/json_std_extenders.h>

namespace sptf
{

void to_json( nlohmann::json& nlohmann_json_j, const WebApi_User& nlohmann_json_t )
{
    NLOHMANN_JSON_EXPAND( NLOHMANN_JSON_PASTE( NLOHMANN_JSON_TO, country, display_name, uri ) )
}

void from_json( const nlohmann::json& nlohmann_json_j, WebApi_User& nlohmann_json_t )
{
    NLOHMANN_JSON_EXPAND( NLOHMANN_JSON_PASTE( NLOHMANN_JSON_FROM, display_name, uri ) )
    if ( nlohmann_json_j.contains( "country" ) )
    {
        NLOHMANN_JSON_FROM( country )
    }
}

} // namespace sptf


================================================
FILE: foo_spotify/backend/webapi_objects/webapi_user.h
================================================
#pragma once

#include <optional>
#include <string>

namespace sptf
{

struct WebApi_User
{
    std::optional<std::string> country;
    std::optional<std::string> display_name;
    //std::optional<std::string> email;
    //external_urls 	an external URL object 	Known external URLs for this user.
    //followers 	A followers object 	Information about the followers of the user.
    //href 	string 	A link to the Web API endpoint for this user.
    std::string id;
    //images 	an array of image objects 	The users profile image.
    //product 	string 	The users Spotify subscription level: premium, free, etc. (The subscription level open can be considered the same as free.) This field is only available when the current user has granted access to the user-read-private scope.
    std::string uri;
};

void to_json( nlohmann::json& j, const WebApi_User& p );
void from_json( const nlohmann::json& j, WebApi_User& p );

} // namespace sptf


================================================
FILE: foo_spotify/component_defines.h
================================================
#pragma once

// Generated by scripts from setup.py
#include <commit_hash.h>
#include <version.h>

#define SPTF_NAME            "Spotify Integration"
#define SPTF_UNDERSCORE_NAME "foo_spotify"
#define SPTF_DLL_NAME        SPTF_UNDERSCORE_NAME ".dll"

#define SPTF_STRINGIFY_HELPER( x ) #x
#define SPTF_STRINGIFY( x )        SPTF_STRINGIFY_HELPER( x )

#ifdef SPTF_VERSION_PRERELEASE_TEXT
#    define SPTF_VERSION_PRERELEASE "-" SPTF_VERSION_PRERELEASE_TEXT
#    define SPTF_VERSION_METADATA   "+" SPTF_STRINGIFY( SPTF_COMMIT_HASH )
#else
#    define SPTF_VERSION_PRERELEASE ""
#    define SPTF_VERSION_METADATA   ""
#endif

#ifdef _DEBUG
#    define SPTF_VERSION_DEBUG_SUFFIX " (Debug)"
#else
#    define SPTF_VERSION_DEBUG_SUFFIX ""
#endif

#define SPTF_VERSION                                                                  \
    SPTF_STRINGIFY( SPTF_VERSION_MAJOR )                                              \
    "." SPTF_STRINGIFY( SPTF_VERSION_MINOR ) "." SPTF_STRINGIFY( SPTF_VERSION_PATCH ) \
        SPTF_VERSION_PRERELEASE SPTF_VERSION_METADATA
#define SPTF_NAME_WITH_VERSION SPTF_NAME " v" SPTF_VERSION SPTF_VERSION_DEBUG_SUFFIX

#define SPTF_ABOUT \
    SPTF_NAME_WITH_VERSION " by TheQwertiest"


================================================
FILE: foo_spotify/component_guids.h
================================================
#pragma once

namespace sptf::guid
{

constexpr GUID acfu_source = { 0xbfbd48bc, 0x9f3b, 0x42bd, { 0x8e, 0xfc, 0x9d, 0x5a, 0xf1, 0x2f, 0xf3, 0xa1 } };
constexpr GUID adv_branch = { 0x3e2d241a, 0x306b, 0x49bc, { 0x80, 0xb3, 0x6a, 0x77, 0xe9, 0x21, 0x32, 0xc7 } };
constexpr GUID adv_branch_logging = { 0xa69190a1, 0x3abd, 0x4a45, { 0x9c, 0x4a, 0x66, 0xbd, 0xb, 0x7f, 0xec, 0x11 } };
constexpr GUID adv_branch_network = { 0x53328c11, 0x156e, 0x4b5c, { 0x8f, 0x82, 0xe5, 0x3d, 0x5d, 0xb5, 0x7c, 0x2b } };
constexpr GUID adv_var_network_proxy = { 0x2626706b, 0x19a9, 0x4ccf, { 0x85, 0xdd, 0x55, 0xd4, 0x2f, 0x8b, 0x57, 0x46 } };
constexpr GUID adv_var_network_proxy_username = { 0xd9e86980, 0xcee4, 0x4075, { 0x96, 0xef, 0x79, 0xed, 0xba, 0x87, 0x79, 0x58 } };
constexpr GUID adv_var_network_proxy_password = { 0xd138fb5, 0x3e6f, 0x48d6, { 0x9b, 0x44, 0x44, 0x6c, 0x78, 0xd4, 0x6f, 0xa3 } };
constexpr GUID adv_var_logging_webapi_debug = { 0xea784339, 0x21d7, 0x47ab, { 0xbc, 0xeb, 0x7a, 0xf7, 0xc, 0x8f, 0xb0, 0x18 } };
constexpr GUID adv_var_logging_webapi_request = { 0x90066d1d, 0x1233, 0x4fcc, { 0xab, 0xc3, 0xbc, 0x17, 0xb4, 0x68, 0x65, 0x84 } };
constexpr GUID adv_var_logging_webapi_response = { 0x349d3d49, 0xfffc, 0x4b32, { 0x8b, 0xf7, 0xc0, 0x78, 0x3a, 0x87, 0x5e, 0xa4 } };
constexpr GUID config_enable_normalization = { 0x7917bfbc, 0x3731, 0x4523, { 0xa4, 0x9e, 0xf8, 0xb3, 0x8e, 0xad, 0xbd, 0xb1 } };
constexpr GUID config_enable_private_mode = { 0xfd7aad3c, 0x3e8f, 0x45c2, { 0xaa, 0x62, 0xbe, 0xcc, 0x55, 0xe1, 0x2d, 0xfb } };
constexpr GUID config_libspotify_cache_size_in_mb = { 0xf23f3e, 0x5d86, 0x4092, { 0x8d, 0xf, 0xf1, 0x7d, 0x5b, 0xa1, 0x22, 0xf7 } };
constexpr GUID config_libspotify_cache_size_in_percent = { 0xf2107600, 0x4e31, 0x4039, { 0x9a, 0x5, 0xd3, 0x8f, 0x23, 0x25, 0x88, 0x72 } };
constexpr GUID config_preferred_bitrate = { 0xfaf55f2c, 0xe6d6, 0x4adc, { 0xae, 0x85, 0x3e, 0xcc, 0x8c, 0x19, 0xa, 0xe0 } };
constexpr GUID config_webapi_auth_scopes = { 0xabc0e6b2, 0x2569, 0x42ee, { 0xb8, 0xb0, 0x86, 0x7e, 0x3a, 0xc3, 0x21, 0x9 } };
constexpr GUID input = { 0xb376ad64, 0xe029, 0x40f6, { 0x89, 0xf8, 0xae, 0xc, 0xfa, 0x73, 0xa5, 0xa3 } };
constexpr GUID preferences = { 0x7285bbbd, 0x2109, 0x437c, { 0x8f, 0x3e, 0xaa, 0xa9, 0xc9, 0x90, 0x65, 0x2c } };

} // namespace sptf::guid


================================================
FILE: foo_spotify/component_paths.cpp
================================================
#include <stdafx.h>

#include "component_paths.h"

#include <qwr/fbk2_paths.h>

namespace fs = std::filesystem;

namespace sptf::path
{

fs::path LibSpotifyCache()
{
    return qwr::path::Profile() / SPTF_UNDERSCORE_NAME / "ls" / "cache";
}
fs::path LibSpotifySettings()
{
    return qwr::path::Profile() / SPTF_UNDERSCORE_NAME / "ls" / "settings";
}

fs::path WebApiCache()
{
    return qwr::path::Profile() / SPTF_UNDERSCORE_NAME / "wa" / "cache";
}
fs::path WebApiSettings()
{
    return qwr::path::Profile() / SPTF_UNDERSCORE_NAME / "wa" / "settings";
}

} // namespace sptf::path

================================================
FILE: foo_spotify/component_paths.h
================================================
#pragma once

#include <filesystem>

namespace sptf::path
{

std::filesystem::path LibSpotifyCache();
std::filesystem::path LibSpotifySettings();

std::filesystem::path WebApiCache();
std::filesystem::path WebApiSettings();

} // namespace sptf::guid


================================================
FILE: foo_spotify/component_urls.h
================================================
#pragma once

namespace sptf::url
{

constexpr wchar_t accountsAuthenticate[] = L"https://accounts.spotify.com/authorize";
constexpr wchar_t accountsApi[] = L"https://accounts.spotify.com/api/token";
constexpr wchar_t spotifyApi[] = L"https://api.spotify.com/v1";

constexpr wchar_t redirectUri[] = L"http://localhost:23018";

constexpr wchar_t homepage[] = L"https://github.com/TheQwertiest/" SPTF_UNDERSCORE_NAME;

} // namespace sptf::url


================================================
FILE: foo_spotify/dllmain.cpp
================================================
#include <stdafx.h>

#include <backend/spotify_instance.h>
#include <ui/ui_not_auth.h>

#include <qwr/abort_callback.h>
#include <qwr/delayed_executor.h>
#include <qwr/error_popup.h>

DECLARE_COMPONENT_VERSION( SPTF_NAME, SPTF_VERSION, SPTF_ABOUT );

VALIDATE_COMPONENT_FILENAME( SPTF_DLL_NAME );

using namespace sptf;

namespace
{

bool HasComponent( const std::u8string& componentName )
{
    pfc::string8_fast temp;
    for ( service_enum_t<componentversion> e; !e.finished(); ++e )
    {
        auto cv = e.get();
        cv->get_file_name( temp );
        if ( temp.c_str() == componentName )
        {
            return true;
        }
    }

    return false;
}

} // namespace

namespace
{

class sptf_initquit : public initquit
{
public:
    void on_init() override
    {
        qwr::DelayedExecutor::GetInstance().EnableExecution(); ///< Enable task processing (e.g. error popups)
        if ( HasComponent( "foo_input_spotify" ) )
        {
            qwr::ReportErrorWithPopup( SPTF_UNDERSCORE_NAME,
                                       "!!!        `foo_input_spotify` component detected!             !!!\n"
                                       "!!! It is incompatible with `foo_spotify` and must be removed! !!!\n"
                                       "!!!           Otherwise foobar2000 *will* crash!               !!!" );
        }
    }

    void on_quit() override
    { // Careful when changing invocation order here!
        qwr::GlobalAbortCallback::GetInstance().Abort();
        SpotifyInstance::Get().Finalize();
        ui::NotAuthHandler::Get().CloseDialog();
    }
};

initquit_factory_t<sptf_initquit> g_initquit;

} // namespace

extern "C" BOOL WINAPI DllMain( HINSTANCE ins, DWORD reason, [[maybe_unused]] LPVOID lp )
{
    switch ( reason )
    {
    case DLL_PROCESS_ATTACH:
    {
        break;
    }
    case DLL_PROCESS_DETACH:
    {
        break;
    }
    default:
        break;
    }

    return TRUE;
}


================================================
FILE: foo_spotify/fb2k/acfu_integration.cpp
================================================
#include <stdafx.h>

#include <component_urls.h>

#include <qwr/acfu_integration.h>

using namespace sptf;

namespace
{

class SptfSource
    : public qwr::acfu::QwrSource
{
public:
    // ::acfu::source
    GUID get_guid() override;
    ::acfu::request::ptr create_request() override;

    // qwr::acfu::github_conf
    static pfc::string8 get_owner();
    static pfc::string8 get_repo();

    // qwr::acfu::QwrSource
    std::string GetComponentName() const override;
    std::string GetComponentFilename() const override;
};

} // namespace

namespace
{

GUID SptfSource::get_guid()
{
    return guid::acfu_source;
}

::acfu::request::ptr SptfSource::create_request()
{
    return fb2k::service_new<qwr::acfu::github_latest_release<SptfSource>>();
}

pfc::string8 SptfSource::get_owner()
{
    return "TheQwertiest";
}

pfc::string8 SptfSource::get_repo()
{
    return qwr::unicode::ToU8( std::wstring_view{ url::homepage } ).c_str();
}

std::string SptfSource::GetComponentName() const
{
    return SPTF_NAME;
}

std::string SptfSource::GetComponentFilename() const
{
    return SPTF_UNDERSCORE_NAME;
}

service_factory_single_t<SptfSource> g_acfuSource;

} // namespace


================================================
FILE: foo_spotify/fb2k/advanced_config.cpp
================================================
#include <stdafx.h>

#include "advanced_config.h"

namespace
{

advconfig_branch_factory branch_sptf(
    "Spotify Integration", sptf::guid::adv_branch, advconfig_branch::guid_branch_tools, 0 );
advconfig_branch_factory branch_network(
    "Network: restart is required", sptf::guid::adv_branch_network, sptf::guid::adv_branch, 0 );
advconfig_branch_factory branch_logging(
    "Logging: restart is required", sptf::guid::adv_branch_logging, sptf::guid::adv_branch, 1 );

} // namespace

namespace sptf::config::advanced
{

qwr::fb2k::AdvConfigString_MT network_proxy(
    "Proxy: url",
    sptf::guid::adv_var_network_proxy, sptf::guid::adv_branch_network, 0,
    "" );

qwr::fb2k::AdvConfigString_MT network_proxy_username(
    "Proxy: username",
    sptf::guid::adv_var_network_proxy_username, sptf::guid::adv_branch_network, 1,
    "" );

qwr::fb2k::AdvConfigString_MT network_proxy_password(
    "Proxy: password",
    sptf::guid::adv_var_network_proxy_password, sptf::guid::adv_branch_network, 2,
    "" );

qwr::fb2k::AdvConfigBool_MT logging_webapi_request(
    "Log Spotify Web API: request",
    sptf::guid::adv_var_logging_webapi_request, sptf::guid::adv_branch_logging, 0,
    false );

qwr::fb2k::AdvConfigBool_MT logging_webapi_response(
    "Log Spotify Web API: response",
    sptf::guid::adv_var_logging_webapi_response, sptf::guid::adv_branch_logging, 1,
    false );

qwr::fb2k::AdvConfigBool_MT logging_webapi_debug(
    "Log Spotify Web API: debug",
    sptf::guid::adv_var_logging_webapi_debug, sptf::guid::adv_branch_logging, 2,
    false );

} // namespace sptf::config::advanced


================================================
FILE: foo_spotify/fb2k/advanced_config.h
================================================
#pragma once

#include <qwr/fb2k_adv_config.h>

namespace sptf::config::advanced
{

extern qwr::fb2k::AdvConfigString_MT network_proxy;
extern qwr::fb2k::AdvConfigString_MT network_proxy_username;
extern qwr::fb2k::AdvConfigString_MT network_proxy_password;

extern qwr::fb2k::AdvConfigBool_MT logging_webapi_request;
extern qwr::fb2k::AdvConfigBool_MT logging_webapi_response;
extern qwr::fb2k::AdvConfigBool_MT logging_webapi_debug;

} // namespace sptf::config::advanced


================================================
FILE: foo_spotify/fb2k/album_art.cpp
================================================
#include <stdafx.h>

#include <backend/spotify_instance.h>
#include <backend/spotify_object.h>
#include <backend/webapi_backend.h>
#include <backend/webapi_objects/webapi_media_objects.h>

using namespace sptf;

namespace
{

class AlbumArtExtractorInstanceSpotify : public album_art_extractor_instance
{
public:
    AlbumArtExtractorInstanceSpotify( std::unique_ptr<const WebApi_Track> track, std::unique_ptr<const WebApi_Artist> artist );

    album_art_data_ptr query( const GUID& p_what, abort_callback& p_abort ) override;

private:
    WebApi_Backend& waBackend_;
    std::unique_ptr<const WebApi_Track> track_;
    std::unique_ptr<const WebApi_Artist> artist_;
};

class AlbumArtExtractorSpotify : public album_art_extractor
{
public:
    AlbumArtExtractorSpotify() = default;

    bool is_our_path( const char* p_path, const char* p_extension ) override;
    album_art_extractor_instance_ptr open( file_ptr p_filehint, const char* p_path, abort_callback& p_abort ) override;
};

} // namespace

namespace
{

AlbumArtExtractorInstanceSpotify::AlbumArtExtractorInstanceSpotify( std::unique_ptr<const WebApi_Track> track, std::unique_ptr<const WebApi_Artist> artist )
    : waBackend_( SpotifyInstance::Get().GetWebApi_Backend() )
    , track_( std::move( track ) )
    , artist_( std::move( artist ) )
{
    assert( track_ );
    assert( artist_ );
}

album_art_data_ptr AlbumArtExtractorInstanceSpotify::query( const GUID& p_what, abort_callback& p_abort )
{
    const auto imagePath = [&] {
        if ( p_what == album_art_ids::cover_front )
        {
            if ( track_->album->images.empty() )
            {
                throw exception_album_art_not_found();
            }

            return waBackend_.GetAlbumImage( track_->album->id, track_->album->images[0]->url, p_abort );
        }
        else if ( p_what == album_art_ids::artist )
        {
            if ( artist_->images.empty() )
            {
                throw exception_album_art_not_found();
            }

            return waBackend_.GetArtistImage( artist_->id, artist_->images[0]->url, p_abort );
        }
        else
        {
            throw exception_album_art_not_found();
        }
    }();

    pfc::string8_fast canPath;
    filesystem::g_get_canonical_path( imagePath.u8string().c_str(), canPath );

    file::ptr file;
    filesystem::g_open( file, canPath, filesystem::open_mode_read, p_abort );

    return album_art_data_impl::g_create( file.get_ptr(), (size_t)file->get_size_ex( p_abort ), p_abort );
}

bool AlbumArtExtractorSpotify::is_our_path( const char* p_path, const char* p_extension )
{
    return SpotifyFilteredTrack::IsValid( p_path, false );
}

album_art_extractor_instance_ptr AlbumArtExtractorSpotify::open( file_ptr p_filehint, const char* p_path, abort_callback& p_abort )
{
    const auto spotifyObject = SpotifyFilteredTrack::Parse( p_path );

    auto& waBackend = SpotifyInstance::Get().GetWebApi_Backend();
    auto track = waBackend.GetTrack( spotifyObject.Id(), p_abort );
    auto artist = waBackend.GetArtist( track->artists[0]->id, p_abort );
    if ( track->album->images.empty() && artist->images.empty() )
    {
        throw exception_album_art_not_found();
    }

    return ::fb2k::service_new<AlbumArtExtractorInstanceSpotify>( std::move( track ), std::move( artist ) );
}

} // namespace

namespace
{
static service_factory_single_t<AlbumArtExtractorSpotify> g_album_art_extractor;
}


================================================
FILE: foo_spotify/fb2k/config.cpp
================================================
#include <stdafx.h>

#include "config.h"

namespace sptf::config
{

qwr::fb2k::ConfigBool_MT enable_normalization( sptf::guid::config_enable_normalization, true );
qwr::fb2k::ConfigBool_MT enable_private_mode( sptf::guid::config_enable_private_mode, false );
qwr::fb2k::ConfigUint8_MT libspotify_cache_size_in_percent( sptf::guid::config_libspotify_cache_size_in_percent, 10 );
qwr::fb2k::ConfigUint32_MT libspotify_cache_size_in_mb( sptf::guid::config_libspotify_cache_size_in_mb, 2048 );
qwr::fb2k::ConfigUint8Enum_MT<BitrateSettings> preferred_bitrate( sptf::guid::config_preferred_bitrate, BitrateSettings::Bitrate320k );
qwr::fb2k::ConfigString_MT webapi_auth_scopes( sptf::guid::config_webapi_auth_scopes, "playlist-read-collaborative playlist-read-private user-read-private" );

} // namespace sptf::config


================================================
FILE: foo_spotify/fb2k/config.h
================================================
#pragma once

#include <qwr/fb2k_config.h>

namespace sptf::config
{

enum class BitrateSettings : uint8_t
{ // values are the same as in libspotify's sp_bitrate
    Bitrate160k = 0,
    Bitrate320k = 1,
    Bitrate96k = 2
};

extern qwr::fb2k::ConfigBool_MT enable_normalization;
extern qwr::fb2k::ConfigBool_MT enable_private_mode;
extern qwr::fb2k::ConfigUint8_MT libspotify_cache_size_in_percent;
extern qwr::fb2k::ConfigUint32_MT libspotify_cache_size_in_mb;
extern qwr::fb2k::ConfigUint8Enum_MT<BitrateSettings> preferred_bitrate;
extern qwr::fb2k::ConfigString_MT webapi_auth_scopes;

} // namespace sptf::config


================================================
FILE: foo_spotify/fb2k/file_info_filler.cpp
================================================
#include <stdafx.h>

#include "file_info_filler.h"

#include <qwr/string_helpers.h>

namespace
{

void FillMetaInfo( const std::unordered_multimap<std::string, std::string>& meta, file_info& info )
{
    auto addMeta = [&]( file_info& info, std::string_view metaName ) {
        const auto er = meta.equal_range( std::string( metaName.begin(), metaName.end() ) );
        if ( er.first != er.second )
        {
            const auto [key, val] = *er.first;
            info.meta_add( metaName.data(), val.c_str() );
        }
    };
    auto addMetaIfPositive = [&]( file_info& info, std::string_view metaName ) {
        const auto er = meta.equal_range( std::string( metaName.begin(), metaName.end() ) );
        if ( er.first != er.second )
        {
            const auto [key, val] = *er.first;
            auto numOpt = qwr::string::GetNumber<uint32_t>( static_cast<std::string_view>( val ) );
            if ( numOpt && *numOpt )
            {
                info.meta_add( metaName.data(), val.c_str() );
            }
        }
    };
    auto addMetaMultiple = [&]( file_info& info, std::string_view metaName ) {
        const auto er = meta.equal_range( std::string( metaName.begin(), metaName.end() ) );
        for ( auto it = er.first; it != er.second; ++it )
        {
            const auto [key, val] = *it;
            info.meta_add( metaName.data(), val.c_str() );
        }
    };

    addMeta( info, "TITLE" );
    addMeta( info, "ALBUM" );
    addMeta( info, "DATE" );
    addMetaMultiple( info, "ARTIST" );
    addMetaMultiple( info, "ALBUM ARTIST" );
    addMetaIfPositive( info, "TRACKNUMBER" );
    addMetaIfPositive( info, "DISCNUMBER" );

    const auto er = meta.equal_range( "SPTF_LENGTH" );
    if ( er.first != er.second )
    {
        const auto [key, val] = *er.first;
        auto numOpt = qwr::string::GetNumber<uint32_t>( static_cast<std::string_view>( val ) );
        if ( numOpt && *numOpt )
        {
            info.set_length( *numOpt / 1000.0 );
        }
    }
}

void FillTechnicalInfo( const std::unordered_multimap<std::string, std::string>& meta, file_info& info )
{
    if ( pfc_infinite == info.info_find( "codec" ) )
    {
        info.info_set( "codec", "Vorbis" );
    }
}

} // namespace

namespace sptf::fb2k
{

void FillFileInfoWithMeta( const std::unordered_multimap<std::string, std::string>& meta, file_info& info )
{
    FillMetaInfo( meta, info );
    FillTechnicalInfo( meta, info );
}

} // namespace sptf::fb2k


================================================
FILE: foo_spotify/fb2k/file_info_filler.h
================================================
#pragma once

#include <string>
#include <unordered_map>

namespace sptf::fb2k
{

void FillFileInfoWithMeta( const std::unordered_multimap<std::string, std::string>& meta, file_info& info );

}

================================================
FILE: foo_spotify/fb2k/filesystem.cpp
================================================
#include <stdafx.h>

#include <backend/spotify_object.h>

using namespace std::literals::string_view_literals;

using namespace sptf;

namespace
{

class FilesystemSpotify : public foobar2000_io::filesystem
{
public:
    bool get_canonical_path( const char* p_path, pfc::string_base& p_out ) override;

    bool is_our_path( const char* p_path ) override;
    bool get_display_path( const char* p_path, pfc::string_base& p_out ) override;

    void open( service_ptr_t<file>& p_out, const char* p_path, t_open_mode p_mode, abort_callback& p_abort ) override;

    void remove( const char* p_path, abort_callback& p_abort ) override;
    //! Moves/renames a file. Will fail if the destination file already exists. \n
    //! Note that this function may throw exception_io_denied instead of exception_io_sharing_violation when the file is momentarily in use, due to bugs in Windows MoveFile() API. There is no legitimate way for us to distinguish between the two scenarios.
    void move( const char* p_src, const char* p_dst, abort_callback& p_abort ) override;
    //! Queries whether a file at specified path belonging to this filesystem is a remote object or not.
    bool is_remote( const char* p_src ) override;

    //! Retrieves stats of a file at specified path.
    void get_stats( const char* p_path, t_filestats& p_stats, bool& p_is_writeable, abort_callback& p_abort ) override;

    //! Creates a directory.
    void create_directory( const char* p_path, abort_callback& p_abort ) override;
    void list_directory( const char* p_path, directory_callback& p_out, abort_callback& p_abort ) override;

    //! Hint; returns whether this filesystem supports mime types. \n
    //! When this returns false, all file::get_content_type() calls on files opened thru this filesystem implementation will return false; otherwise, file::get_content_type() calls may return true depending on the file.
    bool supports_content_types() override;
    ;
};

} // namespace

namespace
{

bool FilesystemSpotify::get_canonical_path( const char* p_path, pfc::string_base& p_out )
{
    if ( !SpotifyFilteredTrack::IsValid( p_path, true ) )
    {
        return false;
    }

    try
    {
        const auto ret = SpotifyObject( p_path ).ToSchema();
        p_out = ret.c_str();
        return true;
    }
    catch ( qwr::QwrException& )
    {
        return false;
    }
}

bool FilesystemSpotify::is_our_path( const char* p_path )
{
    // accept only filtered input
    return SpotifyFilteredTrack::IsValid( p_path, true );
}

bool FilesystemSpotify::get_display_path( const char* p_path, pfc::string_base& p_out )
{
    if ( !SpotifyFilteredTrack::IsValid( p_path, true ) )
    {
        return false;
    }

    try
    {
        const auto ret = SpotifyObject( p_path ).ToUri();
        p_out = ret.c_str();
        return true;
    }
    catch ( qwr::QwrException& )
    {
        return false;
    }
}

void FilesystemSpotify::open( service_ptr_t<file>& p_out, const char* p_path, t_open_mode p_mode, abort_callback& p_abort )
{
    (void)p_abort;

    if ( p_mode != open_mode_read )
    {
        throw pfc::exception( "Can't modify remote files" );
    }

    p_out = ::fb2k::service_new<file_streamstub>();
}

void FilesystemSpotify::remove( const char* p_path, abort_callback& p_abort )
{
    (void)p_path;
    (void)p_abort;
    throw pfc::exception( "Can't delete remote files" );
}

void FilesystemSpotify::move( const char* p_src, const char* p_dst, abort_callback& p_abort )
{
    (void)p_src;
    (void)p_dst;
    (void)p_abort;
    throw pfc::exception( "Can't move remote files" );
}

bool FilesystemSpotify::is_remote( const char* p_src )
{
    (void)p_src;
    return false;
}

void FilesystemSpotify::get_stats( const char* p_path, t_filestats& p_stats, bool& p_is_writeable, abort_callback& p_abort )
{
    (void)p_abort;
    p_stats = filestats_invalid;
    p_is_writeable = false;
}

void FilesystemSpotify::create_directory( const char* p_path, abort_callback& p_abort )
{
    (void)p_path;
    (void)p_abort;
    throw pfc::exception( "Directories are not supported" );
}

void FilesystemSpotify::list_directory( const char* p_path, directory_callback& p_out, abort_callback& p_abort )
{
    (void)p_path;
    (void)p_out;
    (void)p_abort;
    throw pfc::exception( "Directories are not supported" );
}

bool FilesystemSpotify::supports_content_types()
{
    return false;
}

} // namespace

namespace
{

static service_factory_single_t<FilesystemSpotify> g_filesystem;

}

================================================
FILE: foo_spotify/fb2k/input.cpp
================================================
#include <stdafx.h>

#include <backend/libspotify_backend.h>
#include <backend/libspotify_wrapper.h>
#include <backend/spotify_instance.h>
#include <backend/spotify_object.h>
#include <backend/webapi_backend.h>
#include <backend/webapi_objects/webapi_media_objects.h>
#include <fb2k/config.h>
#include <fb2k/file_info_filler.h>

#include <qwr/string_helpers.h>

#include <cstdint>
#include <cstdlib>
#include <fstream>
#include <functional>
#include <vector>

using namespace std::literals::string_view_literals;
using namespace sptf;

namespace
{

// input_impl::input_impl
class InputSpotify
    : public input_stubs
    , public LibSpotify_BackendUser
{
public:
    InputSpotify() = default;
    ~InputSpotify();

    // SpotifyBackendUser
    void Finalize() override;

    // input_impl::open
    void open( service_ptr_t<file> m_file, const char* p_path, t_input_open_reason p_reason, abort_callback& p_abort );

    // input_info_reader::get_info
    void get_info( t_int32 subsong, file_info& p_info, abort_callback& p_abort );

    // input_info_reader::get_file_stats
    t_filestats get_file_stats( abort_callback& p_abort );

    // input_decoder::initialize
    void decode_initialize( t_int32 subsong, unsigned p_flags, abort_callback& p_abort );

    // input_decoder::run
    bool decode_run( audio_chunk& p_chunk, abort_callback& p_abort );

    // input_decoder::seek
    void decode_seek( double p_seconds, abort_callback& p_abort );

    // input_decoder::can_seek
    bool decode_can_seek();

    // input_decoder::get_dynamic_info
    bool decode_get_dynamic_info( file_info& p_out, double& p_timestamp_delta );

    // input_decoder::get_dynamic_info_track
    bool decode_get_dynamic_info_track( file_info& p_out, double& p_timestamp_delta );

    // input_decoder::on_idle
    void decode_on_idle( abort_callback& p_abort );

    // input_impl::retag_set_info
    void retag_set_info( t_int32 subsong, const file_info& p_info, abort_callback& p_abort );

    // input_impl::retag_commit
    void retag_commit( abort_callback& p_abort );

    // input_info_reader::get_subsong_count
    t_uint32 get_subsong_count();

    // input_info_reader::get_subsong
    t_uint32 get_subsong( unsigned song );

    // input_entry::is_our_content_type
    static bool g_is_our_content_type( const char* p_content_type );

    // input_entry::is_our_path
    static bool g_is_our_path( const char* p_full_path, const char* p_extension );

    // input_entry::get_guid
    static GUID g_get_guid();

    // input_entry::get_name
    static const char* g_get_name();

private:
    LibSpotify_Backend& GetInitializedLibSpotify();

private:
    bool usingLibSpotify_ = false;
    bool hasDecoder_ = false;

    std::optional<t_input_open_reason> openedReason_;

    wrapper::Ptr<sp_track> track_;
    std::string trackId_;
    std::unordered_multimap<std::string, std::string> trackMeta_;

    bool isFirstBlock_ = false;
    int channels_{};
    int sampleRate_{};
    int bitRate_{};
};
} // namespace

namespace
{

std::string GetPlaybackErrorMessage( sp_error sp, const std::string& trackId, abort_callback& p_abort )
{
    if ( sp == SP_ERROR_TRACK_NOT_PLAYABLE )
    {
        try
        {
            auto& waBackend = SpotifyInstance::Get().GetWebApi_Backend();
            const auto track = waBackend.GetTrack( trackId, p_abort, true );
            if ( track->restrictions )
            {
                const auto& reason = track->restrictions.value()->reason;
                if ( reason == "market"sv )
                {
                    return "track is not accessible in your country";
                }
                else if ( reason == "product"sv )
                {
                    return "track is not accessible for your subscription type";
                }
                else if ( reason == "explicit"sv )
                {
                    return "track is explicit and your account is set to not play explicit content";
                }
                else
                {
                    return reason;
                }
            }
        }
        catch ( const std::exception& )
        {
        }
    }

    return sp_error_message( sp );
}

} // namespace

namespace
{

InputSpotify::~InputSpotify()
{
    try
    {
        Finalize();
    }
    catch ( const std::exception& )
    {
    }
}

void InputSpotify::Finalize()
{
    if ( !usingLibSpotify_ )
    {
        return;
    }
    usingLibSpotify_ = false;

    auto& lsBackend = SpotifyInstance::Get().GetLibSpotify_Backend();
    {
        if ( hasDecoder_ )
        {
            lsBackend.ReleaseDecoder( this );
        }
    }

    if ( track_ )
    {
        lsBackend.ExecSpMutex( [&] {
            track_.Release();
        } );
    }

    lsBackend.UnregisterBackendUser( *this );
}

void InputSpotify::open( service_ptr_t<file> m_file, const char* p_path, t_input_open_reason p_reason, abort_callback& p_abort )
{
    openedReason_ = p_reason;

    if ( p_reason == input_open_info_write )
    {
        throw exception_io_denied_readonly();
    }

    auto& waBackend = SpotifyInstance::Get().GetWebApi_Backend();

    const auto spotifyObject = SpotifyFilteredTrack::Parse( p_path );
    trackId_ = spotifyObject.Id();
    const auto track = waBackend.GetTrack( trackId_, p_abort );
    trackMeta_ = waBackend.GetMetaForTracks( nonstd::span<const std::unique_ptr<const WebApi_Track>>( &track, 1 ) )[0];

    if ( p_reason == input_open_info_read )
    { // don't use LibSpotify stuff if it's not needed
        return;
    }

    auto& lsBackend = GetInitializedLibSpotify();

    auto pSession = lsBackend.GetInitializedSpSession( p_abort );

    lsBackend.ExecSpMutex( [&] {
        wrapper::Ptr<sp_link> link( sp_link_create_from_string( spotifyObject.ToUri().c_str() ) );
        if ( !link )
        {
            throw exception_io_data( "Couldn't parse url" );
        }

        track_.Release();

        switch ( sp_link_type( link ) )
        {
        case SP_LINKTYPE_TRACK:
        {
            track_ = sp_link_as_track( link );
            break;
        }
        default:
        {
            throw exception_io_data( "Only track links should be passed to input" );
        }
        }
    } );

    while ( true )
    {
        // TODO: clean up here
        const auto done = lsBackend.ExecSpMutex( [&] {
            const auto sp = sp_track_error( track_ );
            if ( SP_ERROR_OK == sp )
            {
                return true;
            }
            else if ( SP_ERROR_IS_LOADING == sp )
            {
                return false;
            }
            else
            {
                throw qwr::QwrException( fmt::format( "sp_track_error failed: {}", sp_error_message( sp ) ) );
            }
        } );

        if ( done )
        {
            break;
        }

        p_abort.sleep( 0.05 );
    }

    bitRate_ = [] {
        switch ( config::preferred_bitrate )
        {
        case config::BitrateSettings::Bitrate96k:
        {
            return 96;
        }
        case config::BitrateSettings::Bitrate160k:
        {
            return 160;
        }
        case config::BitrateSettings::Bitrate320k:
        {
            return 320;
        }
        default:
        {
            assert( false );
            return 320;
        }
        }
    }();
}

void InputSpotify::get_info( t_int32 subsong, file_info& p_info, abort_callback& p_abort )
{
    if ( subsong )
    {
        throw std::exception( "This track does not have any sub-songs" );
    }

    sptf::fb2k::FillFileInfoWithMeta( trackMeta_, p_info );
    if ( openedReason_ == input_open_decode )
    { // Use exact length when possible
        auto& lsBackend = GetInitializedLibSpotify();
        lsBackend.ExecSpMutex( [&] {
            p_info.set_length( sp_track_duration( track_ ) / 1000.0 );
        } );
    }
}

foobar2000_io::t_filestats InputSpotify::get_file_stats( abort_callback& p_abort )
{
    return t_filestats{};
}

void InputSpotify::decode_initialize( t_int32 subsong, unsigned p_flags, abort_callback& p_abort )
{
    isFirstBlock_ = true;

    if ( subsong )
    {
        throw std::exception( "This track does not have any sub-songs" );
    }

    if ( !( p_flags & input_flag_playback ) )
    {
        throw exception_io_denied();
    }

    auto& lsBackend = GetInitializedLibSpotify();
    lsBackend.AcquireDecoder( this );
    hasDecoder_ = true;

    lsBackend.GetAudioBuffer().clear();
    auto pSession = lsBackend.GetInitializedSpSession( p_abort );

    lsBackend.ExecSpMutex( [&] {
        const auto sp = sp_session_player_load( pSession, track_ );
        if ( sp != SP_ERROR_OK )
        {
            throw qwr::QwrException( fmt::format( "sp_session_player_load failed: {}", GetPlaybackErrorMessage( sp, trackId_, p_abort ) ) );
        }

        sp_session_player_play( pSession, true );
    } );
}

bool InputSpotify::decode_run( audio_chunk& p_chunk, abort_callback& p_abort )
{
    bool isEof = false;
    const auto dataReader = [&]( const AudioBuffer::AudioChunkHeader& header,
                                 const uint16_t* data ) {
        if ( header.eof )
        {
            isEof = true;
            return;
        }
        channels_ = header.channels;
        sampleRate_ = header.sampleRate;
        p_chunk.set_data_fixedpoint( data,
                                     header.size * sizeof( uint16_t ),
                                     header.sampleRate,
                                     header.channels,
                                     16,
                                     audio_chunk::channel_config_stereo );
    };

    auto& lsBackend = GetInitializedLibSpotify();
    auto& buf = lsBackend.GetAudioBuffer();

    if ( !buf.read( dataReader ) )
    {
        buf.wait_for_data( p_abort );
        if ( !buf.read( dataReader ) )
        { // wait was aborted, ending playback
            isEof = true;
        }
    }

    if ( isEof )
    {
        lsBackend.ReleaseDecoder( this );
        hasDecoder_ = false;
        return false;
    }

    return true;
}

void InputSpotify::decode_seek( double p_seconds, abort_callback& p_abort )
{
    isFirstBlock_ = true;

    auto& lsBackend = GetInitializedLibSpotify();
    lsBackend.GetAudioBuffer().clear();
    auto pSession = lsBackend.GetInitializedSpSession( p_abort );
    lsBackend.ExecSpMutex( [&] {
        sp_session_player_seek( pSession, static_cast<int>( p_seconds * 1000 ) );
    } );
}

bool InputSpotify::decode_can_seek()
{
    return true;
}

bool InputSpotify::decode_get_dynamic_info( file_info& p_out, double& p_timestamp_delta )
{
    if ( !isFirstBlock_ )
    {
        return false;
    }

    p_out.info_set_int( "CHANNELS", channels_ );
    p_out.info_set_int( "SAMPLERATE", sampleRate_ );
    p_out.info_set_bitrate( bitRate_ );

    isFirstBlock_ = false;

    return true;
}

bool InputSpotify::decode_get_dynamic_info_track( file_info& p_out, double& p_timestamp_delta )
{
    return false;
}

void InputSpotify::decode_on_idle( abort_callback& p_abort )
{
    (void)p_abort;
}

void InputSpotify::retag_set_info( t_int32 subsong, const file_info& p_info, abort_callback& p_abort )
{
    throw exception_io_data();
}

void InputSpotify::retag_commit( abort_callback& p_abort )
{
    throw exception_io_data();
}

bool InputSpotify::g_is_our_content_type( const char* p_content_type )
{
    return false;
}

bool InputSpotify::g_is_our_path( const char* p_full_path, const char* p_extension )
{
    (void)p_extension;
    // accept only filtered input
    return SpotifyFilteredTrack::IsValid( p_full_path, false );
}

t_uint32 InputSpotify::get_subsong_count()
{
    return 1;
}

t_uint32 InputSpotify::get_subsong( unsigned song )
{
    return song;
}

GUID InputSpotify::g_get_guid()
{
    return guid::input;
}

const char* InputSpotify::g_get_name()
{
    return SPTF_NAME ": decoder";
}

LibSpotify_Backend& InputSpotify::GetInitializedLibSpotify()
{
    auto& lsBackend = SpotifyInstance::Get().GetLibSpotify_Backend();
    if ( !usingLibSpotify_ )
    {
        lsBackend.RegisterBackendUser( *this );
        usingLibSpotify_ = true;
    }
    return lsBackend;
}

} // namespace

namespace
{

input_factory_t<InputSpotify> g_input;

} // namespace


================================================
FILE: foo_spotify/fb2k/playback.cpp
================================================
#include <stdafx.h>

#include "playback.h"

#include <backend/libspotify_backend.h>

namespace sptf::fb2k
{

std::mutex PlayCallbacks::mutex_;
LibSpotify_Backend* PlayCallbacks::pLsBackend_ = nullptr;

PlayCallbacks::PlayCallbacks()
{
}

PlayCallbacks::~PlayCallbacks()
{
}

void PlayCallbacks::Initialize( LibSpotify_Backend& lsBackend )
{
    std::lock_guard lg( mutex_ );
    pLsBackend_ = &lsBackend;
}

void PlayCallbacks::Finalize()
{
    std::lock_guard lg( mutex_ );
    pLsBackend_ = nullptr;
}

unsigned PlayCallbacks::get_flags()
{
    return ( flag_on_playback_stop | flag_on_playback_pause );
}

void PlayCallbacks::on_playback_pause( bool isPaused )
{
    std::lock_guard lg( mutex_ );

    if ( !pLsBackend_ )
    {
        return;
    }

    auto pSession = pLsBackend_->GetWhateverSpSession();
    pLsBackend_->ExecSpMutex( [&] {
        sp_session_player_play( pSession, !isPaused );
    } );
}

void PlayCallbacks::on_playback_stop( play_control::t_stop_reason reason )
{
    if ( play_control::stop_reason_starting_another == reason )
    {
        return;
    }

    std::lock_guard lg( mutex_ );

    if ( !pLsBackend_ )
    {
        return;
    }

    auto pSession = pLsBackend_->GetWhateverSpSession();
    pLsBackend_->ExecSpMutex( [&] {
        sp_session_player_unload( pSession );
    } );
}

} // namespace sptf::fb2k

namespace
{

play_callback_static_factory_t<sptf::fb2k::PlayCallbacks> g_play_callback_static;

}


================================================
FILE: foo_spotify/fb2k/playback.h
================================================
#pragma once

#include <mutex>

namespace sptf
{

class LibSpotify_Backend;

}

namespace sptf::fb2k
{

class PlayCallbacks
    : public play_callback_static
{
public:
    PlayCallbacks();
    ~PlayCallbacks();

    static void Initialize( LibSpotify_Backend& lsBackend );
    static void Finalize();

    // play_callback_static
    unsigned get_flags() override;
    void on_playback_pause( bool isPaused ) override;
    void on_playback_stop( play_control::t_stop_reason reason ) override;

    void on_playback_starting( play_control::t_track_command p_command, bool p_paused ) override{};
    void on_playback_new_track( metadb_handle_ptr p_track ) override{};
    void on_playback_seek( double p_time ) override{};
    void on_playback_edited( metadb_handle_ptr p_track ) override{};
    void on_playback_dynamic_info( const file_info& p_info ) override{};
    void on_playback_dynamic_info_track( const file_info& p_info ) override{};
    void on_playback_time( double p_time ) override{};
    void on_volume_change( float p_new_val ) override{};

private:
    static std::mutex mutex_;
    static LibSpotify_Backend* pLsBackend_;
};

} // namespace sptf::fb2k


================================================
FILE: foo_spotify/fb2k/playlist.cpp
================================================
#include <stdafx.h>

#include <backend/spotify_instance.h>
#include <backend/spotify_object.h>
#include <backend/webapi_backend.h>
#include <backend/webapi_objects/webapi_media_objects.h>

#include <qwr/abort_callback.h>
#include <qwr/thread_pool.h>

using namespace sptf;

namespace
{

class PlaylistCallbackSpotify : public playlist_callback_static
{
public:
    unsigned get_flags() override;
    void on_default_format_changed() override
    {
    }
    void on_item_ensure_visible( t_size p_playlist, t_size p_idx ) override
    {
    }
    void on_item_focus_change( t_size p_playlist, t_size p_from, t_size p_to ) override
    {
    }
    void on_items_added( t_size p_playlist, t_size p_start, metadb_handle_list_cref p_data, const pfc::bit_array& p_selection ) override
    {
    }
    void on_items_removing( t_size p_playlist, const pfc::bit_array& p_mask, t_size p_old_count, t_size p_new_count ) override
    {
    }
    void on_items_removed( t_size p_playlist, const pfc::bit_array& p_mask, t_size p_old_count, t_size p_new_count ) override
    {
    }
    void on_items_reordered( t_size p_playlist, const t_size* p_order, t_size p_count ) override
    {
    }
    void on_items_replaced( t_size p_playlist, const pfc::bit_array& p_mask, const pfc::list_base_const_t<t_on_items_replaced_entry>& p_data ) override
    {
    }
    void on_items_selection_change( t_size p_playlist, const pfc::bit_array& p_affected, const pfc::bit_array& p_state ) override
    {
    }
    void on_items_modified( t_size p_playlist, const pfc::bit_array& p_mask ) override
    {
    }
    void on_items_modified_fromplayback( t_size p_playlist, const pfc::bit_array& p_mask, play_control::t_display_level p_level ) override
    {
    }
    void on_playback_order_changed( t_size p_new_index ) override
    {
    }
    void on_playlist_activate( t_size p_old, t_size p_new ) override;
    void on_playlist_created( t_size p_index, const char* p_name, t_size p_name_len ) override
    {
    }
    void on_playlist_locked( t_size p_playlist, bool p_locked ) override
    {
    }
    void on_playlist_renamed( t_size p_index, const char* p_new_name, t_size p_new_name_len ) override
    {
    }
    void on_playlists_removing( const pfc::bit_array& p_mask, t_size p_old_count, t_size p_new_count ) override
    {
    }
    void on_playlists_removed( const pfc::bit_array& p_mask, t_size p_old_count, t_size p_new_count ) override
    {
    }
    void on_playlists_reorder( const t_size* p_order, t_size p_count ) override
    {
    }
};

} // namespace

namespace
{

unsigned PlaylistCallbackSpotify::get_flags()
{
    return flag_on_playlist_activate;
}

void PlaylistCallbackSpotify::on_playlist_activate( t_size p_old, t_size p_new )
{
    if ( p_old == p_new )
    {
        return;
    }

    metadb_handle_list items;
    playlist_manager::get()->playlist_get_all_items( p_new, items );

    std::vector<std::string> trackIds;
    for ( const auto& pMeta: qwr::pfc_x::Make_Stl_CRef( items ) )
    {
        const char* path = pMeta->get_location().get_path();
        if ( !SpotifyFilteredTrack::IsValid( path, false ) )
        {
            continue;
        }
        trackIds.emplace_back( SpotifyFilteredTrack::Parse( path ).Id() );
    }

    if ( trackIds.empty() )
    {
        return;
    }

    auto& threadPool = SpotifyInstance::Get().GetThreadPool();
    threadPool.AddTask( [trackIds = std::move( trackIds )] {
        try
        {
            auto& waBackend = SpotifyInstance::Get().GetWebApi_Backend();

            // pre-cache tracks
            qwr::TimedAbortCallback tac1;
            const auto tracks = waBackend.GetTracks( trackIds, tac1 );

            const auto artistIds =
                tracks
                | ranges::views::transform( []( const auto& pTrack ) -> std::string { return pTrack->artists[0]->id; } )
                | ranges::to_vector;

            // pre-cache artists
            qwr::TimedAbortCallback tac2;
            waBackend.RefreshCacheForArtists( artistIds, tac2 );
        }
        catch ( const std::exception& e )
        {
            FB2K_console_formatter() << SPTF_UNDERSCORE_NAME " (error):\n"
                                     << "Failed to refresh tracks:\n"
                                     << e.what();
        }
    } );
}

} // namespace

namespace
{

service_factory_single_t<PlaylistCallbackSpotify> g_playlist_callback_static;

}


================================================
FILE: foo_spotify/fb2k/playlist_loader.cpp
================================================
#include <stdafx.h>

#include <backend/spotify_instance.h>
#include <backend/spotify_object.h>
#include <backend/webapi_backend.h>
#include <backend/webapi_objects/webapi_media_objects.h>
#include <fb2k/file_info_filler.h>

#include <qwr/error_popup.h>
#include <qwr/string_helpers.h>

using namespace std::literals::string_view_literals;

using namespace sptf;

namespace
{

class PlaylistLoaderSpotify : public playlist_loader
{
public:
    PlaylistLoaderSpotify() = default;

public:
    // playlist_loader

    //! Parses specified playlist file into list of playable locations. Throws exception_io or derivatives on failure, exception_aborted on abort. If specified file is not a recognized playlist file, exception_io_unsupported_format is thrown.
    //! @param p_path Path of playlist file to parse. Used for relative path handling purposes (p_file parameter is used for actual file access).
    //! @param p_file File interface to use for reading. Read/write pointer must be set to beginning by caller before calling.
    //! @param p_callback Callback object receiving enumerated playable item locations.
    void open( const char* p_path, const service_ptr_t<file>& p_file, playlist_loader_callback::ptr p_callback, abort_callback& p_abort ) override;
    //! Writes a playlist file containing specific item list to specified file. Will fail (pfc::exception_not_implemented) if specified playlist_loader is read-only (can_write() returns false).
    //! @param p_path Path of playlist file to write. Used for relative path handling purposes (p_file parameter is used for actual file access).
    //! @param p_file File interface to use for writing. Caller should ensure that the file is empty (0 bytes long) before calling.
    //! @param p_data List of items to save to playlist file.
    //! @param p_abort abort_callback object signaling user aborting the operation. Note that aborting a save playlist operation will most likely leave user with corrupted/incomplete file.
    void write( const char* p_path, const service_ptr_t<file>& p_file, metadb_handle_list_cref p_data, abort_callback& p_abort ) override;
    //! Returns extension of file format handled by this playlist_loader implementation (a UTF-8 encoded null-terminated string).
    const char* get_extension() override;
    //! Returns whether this playlist_loader implementation supports writing. If can_write() returns false, all write() calls will fail.
    bool can_write() override;
    //! Returns whether specified content type is one of playlist types supported by this playlist_loader implementation or not.
    //! @param p_content_type Content type to query, a UTF-8 encoded null-terminated string.
    bool is_our_content_type( const char* p_content_type ) override;
    //! Returns whether playlist format extension supported by this implementation should be listed on file types associations page.
    bool is_associatable() override;

    /*
    //! Attempts to load a playlist file from specified filesystem path. Throws exception_io or derivatives on failure, exception_aborted on abort. If specified file is not a recognized playlist file, exception_io_unsupported_format is thrown. \n
    //! Equivalent to g_load_playlist_filehint(NULL,p_path,p_callback).
    //! @param p_path Filesystem path to load playlist from, a UTF-8 encoded null-terminated string.
    //! @param p_callback Callback object receiving enumerated playable item locations as well as signaling user aborting the operation.
    static void g_load_playlist( const char* p_path, playlist_loader_callback::ptr p_callback, abort_callback& p_abort );

    //! Attempts to load a playlist file from specified filesystem path. Throws exception_io or derivatives on failure, exception_aborted on abort. If specified file is not a recognized playlist file, exception_io_unsupported_format is thrown.
    //! @param p_path Filesystem path to load playlist from, a UTF-8 encoded null-terminated string.
    //! @param p_callback Callback object receiving enumerated playable item locations as well as signaling user aborting the operation.
    //! @param fileHint File object to read from, can be NULL if not available.
    static void g_load_playlist_filehint( file::ptr fileHint, const char* p_path, playlist_loader_callback::ptr p_callback, abort_callback& p_abort );

    //! Attempts to load a playlist file from specified filesystem path. Throws exception_io or derivatives on failure, exception_aborted on abort. If specified file is not a recognized playlist file, returns false; returns true upon successful playlist load.
    //! @param p_path Filesystem path to load playlist from, a UTF-8 encoded null-terminated string.
    //! @param p_callback Callback object receiving enumerated playable item locations as well as signaling user aborting the operation.
    //! @param fileHint File object to read from, can be NULL if not available.
    static bool g_try_load_playlist( file::ptr fileHint, const char* p_path, playlist_loader_callback::ptr p_callback, abort_callback& p_abort );

    //! Saves specified list of locations into a playlist file. Throws exception_io or derivatives on failure, exception_aborted on abort.
    //! @param p_path Filesystem path to save playlist to, a UTF-8 encoded null-terminated string.
    //! @param p_data List of items to save to playlist file.
    //! @param p_abort abort_callback object signaling user aborting the operation. Note that aborting a save playlist operation will most likely leave user with corrupted/incomplete file.
    static void g_save_playlist( const char* p_path, metadb_handle_list_cref p_data, abort_callback& p_abort );

    //! Processes specified path to generate list of playable items. Includes recursive directory/archive enumeration. \n
    //! Does not touch playlist files encountered - use g_process_path_ex() if specified path is possibly a playlist file; playlist files found inside directories or archives are ignored regardless.\n
    //! Warning: caller must handle exceptions which will occur in case of I/O failure.
    //! @param p_path Filesystem path to process; a UTF-8 encoded null-terminated string.
    //! @param p_callback Callback object receiving enumerated playable item locations as well as signaling user aborting the operation.
    //! @param p_type Origin of p_path string. Reserved for internal use in recursive calls, should be left at default value; it controls various internal behaviors.
    static void g_process_path( const char* p_path, playlist_loader_callback::ptr p_callback, abort_callback& p_abort, playlist_loader_callback::t_entry_type p_type = playlist_loader_callback::entry_user_requested );

    //! Calls attempts to process specified path as a playlist; if that fails (i.e. not a playlist), calls g_process_path with same parameters. See g_process_path for parameter descriptions. \n
    //! Warning: caller must handle exceptions which will occur in case of I/O failure or playlist parsing failure.
    //! @returns True if specified path was processed as a playlist file, false otherwise (relevant in some scenarios where output is sorted after loading, playlist file contents should not be sorted).
    static bool g_process_path_ex( const char* p_path, playlist_loader_callback::ptr p_callback, abort_callback& p_abort, playlist_loader_callback::t_entry_type p_type = playlist_loader_callback::entry_user_requested );
    */
};

} // namespace

namespace
{

struct SkippedTrack
{
    std::string name;
    std::string reason;
};

std::vector<SkippedTrack>
TransformToSkippedTracks( nonstd::span<const std::unique_ptr<const WebApi_LocalTrack>> tracks )
{
    return ranges::views::transform( tracks,
                                     [&]( const auto& pTrack ) -> SkippedTrack {
                                         return { ( pTrack->name ? *pTrack->name : pTrack->uri ), "local track" };
                                     } )
           | ranges::to_vector;
}

std::tuple<std::vector<std::unique_ptr<const sptf::WebApi_Track>>, std::vector<SkippedTrack>>
GetTracks( const SpotifyObject spotifyObject, abort_callback& p_abort )
{
    auto& waBackend = SpotifyInstance::Get().GetWebApi_Backend();

    const auto preCacheArtists = [&waBackend]( const auto& tracks, auto& p_abort ) {
        const auto artistIds =
            tracks
            | ranges::views::transform( []( const auto& pTrack ) -> std::string { return pTrack->artists[0]->id; } )
            | ranges::to_vector;

        waBackend.RefreshCacheForArtists( artistIds, p_abort );
    };

    if ( spotifyObject.type == "album" )
    {
        auto tracks = waBackend.GetTracksFromAlbum( spotifyObject.id, p_abort );
        preCacheArtists( tracks, p_abort );

        return { std::move( tracks ), std::vector<SkippedTrack>{} };
    }
    else if ( spotifyObject.type == "playlist" )
    {
        auto [tracks, localTracks] = waBackend.GetTracksFromPlaylist( spotifyObject.id, p_abort );
        preCacheArtists( tracks, p_abort );

        // ??? Dunno why this is required. Smth to do with structured bindings and RVO.
        return { std::move( tracks ), TransformToSkippedTracks( localTracks ) };
    }
    else if ( spotifyObject.type == "artist" )
    {
        return { waBackend.GetTopTracksForArtist( spotifyObject.id, p_abort ), std::vector<SkippedTrack>{} };
    }
    else if ( spotifyObject.type == "track" )
    {
        std::vector<std::unique_ptr<const WebApi_Track>> tmp;
        tmp.emplace_back( waBackend.GetTrack( spotifyObject.id, p_abort ) );

        return { std::move( tmp ), std::vector<SkippedTrack>{} };
    }
    else if ( spotifyObject.type == "local" )
    {
        std::vector<SkippedTrack> tmp;
        tmp.emplace_back( SkippedTrack{ spotifyObject.id, "local track" } );

        return { std::vector<std::unique_ptr<const sptf::WebApi_Track>>{}, tmp };
    }
    else
    {
        throw qwr::QwrException( "Unexpected Spotify object type: {}", spotifyObject.type );
    }
}

void ReportSkippedTracks( nonstd::span<const SkippedTrack> skippedTracks )
{
    if ( skippedTracks.empty() )
    {
        return;
    }

    const auto formatedSkippedTracks = ranges::views::transform( skippedTracks,
                                                                 [&]( const auto& track ) -> std::string {
                                                                     return fmt::format( "{}: {}", track.name, track.reason );
                                                                 } )
                                       | ranges::to_vector;
    const auto msg = fmt::format( "Failed to add the following tracks:\n"
                                  "  {}\n",
                                  fmt::join( formatedSkippedTracks, "\n  " ) );

    qwr::ReportErrorWithPopup( SPTF_UNDERSCORE_NAME, msg );
}

} // namespace

namespace
{

void PlaylistLoaderSpotify::open( const char* p_path, const service_ptr_t<file>& p_file, playlist_loader_callback::ptr p_callback, abort_callback& p_abort )
{
    const auto spotifyObject = [&] {
        try
        {
            return SpotifyObject( p_path );
        }
        catch ( const qwr::QwrException& )
        {
            throw exception_io_unsupported_format();
        }
    }();

    p_callback->on_progress( p_path );

    auto& waBackend = SpotifyInstance::Get().GetWebApi_Backend();

    auto [tracks, skippedTracks] = GetTracks( spotifyObject, p_abort );
    std::vector<std::string> relinkedTracks;

    const auto tracksMeta = waBackend.GetMetaForTracks( tracks );
    for ( const auto& [track, trackMeta]: ranges::views::zip( tracks, tracksMeta ) )
    {
        file_info_impl f_info;
        sptf::fb2k::FillFileInfoWithMeta( trackMeta, f_info );

        metadb_handle_ptr f_handle;
        p_callback->handle_create( f_handle, make_playable_location( SpotifyFilteredTrack( track->id ).ToSchema().c_str(), 0 ) );
        p_callback->on_entry_info( f_handle, playlist_loader_callback::entry_user_requested, filestats_invalid, f_info, false );
    }

    ReportSkippedTracks( skippedTracks );
}

void PlaylistLoaderSpotify::write( const char* p_path, const service_ptr_t<file>& p_file, metadb_handle_list_cref p_data, abort_callback& p_abort )
{
    throw pfc::exception_not_implemented();
}

const char* PlaylistLoaderSpotify::get_extension()
{
    return "";
}

bool PlaylistLoaderSpotify::can_write()
{
    return false;
}

bool PlaylistLoaderSpotify::is_our_content_type( const char* p_content_type )
{
    constexpr auto mime = "text/html; charset=utf-8"sv;
    const auto lowerContentType = [&p_content_type]() {
        // Content type should not contain anything other than ASCII
        return std::string_view{ p_content_type }
               | ranges::views::transform( []( auto i ) { return static_cast<char>( ::tolower( i ) ); } )
               | ranges::to<std::string>;
    }();

    return ( mime == lowerContentType );
}

bool PlaylistLoaderSpotify::is_associatable()
{
    return false;
}

} // namespace

namespace
{

playlist_loader_factory_t<PlaylistLoaderSpotify> g_playlist_loader;

} // namespace


================================================
FILE: foo_spotify/foo_spotify.rc
================================================
// Microsoft Visual C++ generated resource script.
//
#include "resource.h"

#define APSTUDIO_READONLY_SYMBOLS
/////////////////////////////////////////////////////////////////////////////
//
// Generated from the TEXTINCLUDE 2 resource.
//
#define APSTUDIO_HIDDEN_SYMBOLS
#include "windows.h"
#undef APSTUDIO_HIDDEN_SYMBOLS

#include <atlres.h>
#include <component_defines.h>

/////////////////////////////////////////////////////////////////////////////
#undef APSTUDIO_READONLY_SYMBOLS

/////////////////////////////////////////////////////////////////////////////
// English (United States) resources

#if !defined(AFX_RESOURCE_DLL) || defined(AFX_TARG_ENU)
LANGUAGE LANG_ENGLISH, SUBLANG_ENGLISH_US
#pragma code_page(1252)

/////////////////////////////////////////////////////////////////////////////
//
// Dialog
//

IDD_NOT_AUTH DIALOGEX 0, 0, 249, 78
STYLE DS_SETFONT | DS_MODALFRAME | DS_FIXEDSYS | WS_POPUP | WS_CAPTION | WS_SYSMENU
CAPTION "Dialog"
FONT 8, "MS Shell Dlg", 400, 0, 0x1
BEGIN
    DEFPUSHBUTTON   "OK",IDOK,30,56,78,14
    PUSHBUTTON      "Authenticate...",IDC_BTN_OPEN_PREF,141,56,78,14
    LTEXT           "Static",IDC_STATIC_NOT_AUTH,7,7,235,41
END

IDD_PREF_TAB_HOST DIALOGEX 0, 0, 334, 288
STYLE DS_SETFONT | DS_FIXEDSYS | WS_CHILD | WS_CLIPSIBLINGS
EXSTYLE WS_EX_CONTROLPARENT
FONT 8, "MS Shell Dlg", 400, 0, 0x0
BEGIN
    CONTROL         "Tabs",IDC_TAB_HOST,"SysTabControl32",WS_TABSTOP,0,0,332,287
END

IDD_PREF_TAB_AUTH DIALOGEX 0, 0, 327, 268
STYLE DS_SETFONT | DS_FIXEDSYS | DS_CONTROL | WS_CHILD
FONT 8, "MS Shell Dlg", 400, 0, 0x0
BEGIN
    GROUPBOX        "LibSpotify",IDC_STATIC,11,13,282,40
    PUSHBUTTON      "LS Login",IDC_BTN_LOGIN_LIBSPOTIFY,17,28,50,14
    LTEXT           "LS status:",IDC_STATIC_LIBSPOTIFY_STATUS,72,30,217,19
    GROUPBOX        "WebAPI",IDC_STATIC,11,61,282,40
    PUSHBUTTON      "WA Login",IDC_BTN_LOGIN_WEBAPI,17,76,50,14
    LTEXT           "WA status:",IDC_STATIC_WEBAPI_STATUS,72,78,217,19
END

IDD_PREF_TAB_PLAYBACK DIALOGEX 0, 0, 327, 268
STYLE DS_SETFONT | DS_FIXEDSYS | DS_CONTROL | WS_CHILD
FONT 8, "MS Shell Dlg", 400, 0, 0x0
BEGIN
    GROUPBOX        "Playback",IDC_STATIC,11,13,285,87
    LTEXT           "Prefered bitrate",IDC_STATIC,22,28,52,8
    COMBOBOX        IDC_COMBO_BITRATE,22,39,126,30,CBS_DROPDOWNLIST | WS_VSCROLL | WS_TABSTOP
    CONTROL         "Enable volume normalization",IDC_CHECK_NORMALIZE,"Button",BS_AUTOCHECKBOX | WS_TABSTOP,24,62,106,10
    CONTROL         "Enable private mode",IDC_CHECK_PRIVATE,"Button",BS_AUTOCHECKBOX | WS_TABSTOP,24,77,81,10
    GROUPBOX        "Cache",IDC_STATIC,11,114,285,99
    LTEXT           "Maximum size in MB (0 - disabled)",IDC_STATIC,29,132,107,8
    CONTROL         "",IDC_SLIDER_CACHE_MB,"msctls_trackbar32",TBS_AUTOTICKS | TBS_TOOLTIPS | TBS_NOTIFYBEFOREMOVE | WS_TABSTOP,19,142,148,15
    EDITTEXT        IDC_EDIT_CACHE_MB,170,141,40,14,ES_AUTOHSCROLL | ES_NUMBER
    LTEXT           "Maximum size in % of total free space (0 - disabled)",IDC_STATIC,29,169,122,8
    CONTROL         "",IDC_SLIDER_CACHE_PERCENT,"msctls_trackbar32",TBS_AUTOTICKS | TBS_TOOLTIPS | TBS_NOTIFYBEFOREMOVE | WS_TABSTOP,19,179,148,15
    EDITTEXT        IDC_EDIT_CACHE_PERCENT,170,178,40,14,ES_AUTOHSCROLL | ES_NUMBER
END


/////////////////////////////////////////////////////////////////////////////
//
// DESIGNINFO
//

#ifdef APSTUDIO_INVOKED
GUIDELINES DESIGNINFO
BEGIN
    IDD_NOT_AUTH, DIALOG
    BEGIN
        LEFTMARGIN, 7
        RIGHTMARGIN, 242
        TOPMARGIN, 7
        BOTTOMMARGIN, 70
    END

    IDD_PREF_TAB_HOST, DIALOG
    BEGIN
    END

    IDD_PREF_TAB_AUTH, DIALOG
    BEGIN
    END

    IDD_PREF_TAB_PLAYBACK, DIALOG
    BEGIN
    END
END
#endif    // APSTUDIO_INVOKED


/////////////////////////////////////////////////////////////////////////////
//
// AFX_DIALOG_LAYOUT
//

IDD_PREF_TAB_HOST AFX_DIALOG_LAYOUT
BEGIN
    0
END

IDD_NOT_AUTH AFX_DIALOG_LAYOUT
BEGIN
    0
END

IDD_PREF_TAB_AUTH AFX_DIALOG_LAYOUT
BEGIN
    0
END

IDD_PREF_TAB_PLAYBACK AFX_DIALOG_LAYOUT
BEGIN
    0
END


#ifdef APSTUDIO_INVOKED
/////////////////////////////////////////////////////////////////////////////
//
// TEXTINCLUDE
//

1 TEXTINCLUDE 
BEGIN
    "resource.h\0"
END

2 TEXTINCLUDE 
BEGIN
    "#define APSTUDIO_HIDDEN_SYMBOLS\r\n"
    "#include ""windows.h""\r\n"
    "#undef APSTUDIO_HIDDEN_SYMBOLS\r\n"
    "\r\n"
    "#include <atlres.h>\r\n"
    "#include <component_defines.h>\r\n"
    "\0"
END

3 TEXTINCLUDE 
BEGIN
    "#include ""foo_spotify.rc2""\0"
END

#endif    // APSTUDIO_INVOKED

#endif    // English (United States) resources
/////////////////////////////////////////////////////////////////////////////



#ifndef APSTUDIO_INVOKED
/////////////////////////////////////////////////////////////////////////////
//
// Generated from the TEXTINCLUDE 3 resource.
//
#include "foo_spotify.rc2"
/////////////////////////////////////////////////////////////////////////////
#endif    // not APSTUDIO_INVOKED



================================================
FILE: foo_spotify/foo_spotify.rc2
================================================
//
// foo_spotify.rc2 - resources Microsoft Visual C++ does not edit directly
//

#ifdef APSTUDIO_INVOKED
   #error this file is not editable by Microsoft Visual C++
#endif  // APSTUDIO_INVOKED

#include <component_defines.h>

#if !defined( AFX_RESOURCE_DLL ) || defined( AFX_TARG_ENU )
LANGUAGE LANG_ENGLISH, SUBLANG_ENGLISH_US
#    pragma code_page( 1252 )

/////////////////////////////////////////////////////////////////////////////
//
// Version
//

VS_VERSION_INFO VERSIONINFO
 FILEVERSION SPTF_VERSION_MAJOR,SPTF_VERSION_MINOR,SPTF_VERSION_PATCH,0
 PRODUCTVERSION SPTF_VERSION_MAJOR,SPTF_VERSION_MINOR,SPTF_VERSION_PATCH,0
 FILEFLAGSMASK 0x3fL
#ifdef _DEBUG
#ifdef SPTF_VERSION_PRERELEASE_TEXT
 FILEFLAGS 0x3L
#else
 FILEFLAGS 0x1L
#endif
#else
#ifdef SPTF_VERSION_PRERELEASE_TEXT
 FILEFLAGS 0x2L
#else
 FILEFLAGS 0x0L
#endif
#endif
 FILEOS 0x40004L
 FILETYPE 0x2L
 FILESUBTYPE 0x0L
BEGIN
    BLOCK "StringFileInfo"
    BEGIN
        BLOCK "040904b0"
        BEGIN
            VALUE "FileDescription", SPTF_NAME " component for foobar2000"
            VALUE "FileVersion", SPTF_VERSION
            VALUE "InternalName", SPTF_DLL_NAME
            VALUE "LegalCopyright", "Copyright (C) 2020 Yuri Shutenko"
            VALUE "OriginalFilename", SPTF_DLL_NAME
            VALUE "ProductName", SPTF_NAME
            VALUE "ProductVersion", SPTF_VERSION
        END
    END
    BLOCK "VarFileInfo"
    BEGIN
        VALUE "Translation", 0x409, 1200
    END
END

#endif 


================================================
FILE: foo_spotify/foo_spotify.vcxproj
================================================
<?xml version="1.0" encoding="utf-8"?>
<Project DefaultTargets="Build" ToolsVersion="14.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <Import Project="..\workspaces\packages\Microsoft.SourceLink.GitHub.1.0.0\build\Microsoft.SourceLink.GitHub.props" Condition="Exists('..\workspaces\packages\Microsoft.SourceLink.GitHub.1.0.0\build\Microsoft.SourceLink.GitHub.props')" />
  <Import Project="..\workspaces\packages\Microsoft.SourceLink.Common.1.0.0\build\Microsoft.SourceLink.Common.props" Condition="Exists('..\workspaces\packages\Microsoft.SourceLink.Common.1.0.0\build\Microsoft.SourceLink.Common.props')" />
  <Import Project="..\workspaces\packages\Microsoft.Build.Tasks.Git.1.0.0\build\Microsoft.Build.Tasks.Git.props" Condition="Exists('..\workspaces\packages\Microsoft.Build.Tasks.Git.1.0.0\build\Microsoft.Build.Tasks.Git.props')" />
  <ItemGroup Label="ProjectConfigurations">
    <ProjectConfiguration Include="Debug|Win32">
      <Configuration>Debug</Configuration>
      <Platform>Win32</Platform>
    </ProjectConfiguration>
    <ProjectConfiguration Include="Release|Win32">
      <Configuration>Release</Configuration>
      <Platform>Win32</Platform>
    </ProjectConfiguration>
  </ItemGroup>
  <PropertyGroup Label="Globals">
    <RootNamespace>foo_spotify</RootNamespace>
    <WindowsTargetPlatformVersion>10.0.18362.0</WindowsTargetPlatformVersion>
    <ProjectGuid>{FB107A12-DEFC-4782-97FB-EC155B13550C}</ProjectGuid>
    <VcpkgTriplet>x86-windows-static</VcpkgTriplet>
  </PropertyGroup>
  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
  <PropertyGroup Label="Configuration">
    <ConfigurationType>DynamicLibrary</ConfigurationType>
    <CharacterSet>Unicode</CharacterSet>
    <PlatformToolset>v142</PlatformToolset>
  </PropertyGroup>
  <PropertyGroup Condition="'$(Configuration)'=='Release'" Label="Configuration">
    <WholeProgramOptimization>true</WholeProgramOptimization>
  </PropertyGroup>
  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
  <ImportGroup Label="ExtensionSettings">
  </ImportGroup>
  <ImportGroup Label="PropertySheets">
    <Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" />
    <Import Project="$(SolutionDir)\..\props\submodules\submodules.props" />
    <Import Project="$(SolutionDir)\..\props\submodules\fb2k_utils.props" />
    <Import Project="$(QwrFb2kUtilsPropsDir)env\BuildEnvCommon.props" />
    <Import Project="$(QwrFb2kUtilsPropsDir)env\BuildEnvCpp.props" />
    <Import Project="$(QwrFb2kUtilsPropsDir)env\StaticRuntime.props" />
    <Import Project="$(QwrFb2kUtilsPropsDir)submodules\fmt.props" />
    <Import Project="$(QwrFb2kUtilsPropsDir)submodules\foobar2000_sdk.props" />
    <Import Project="$(QwrFb2kUtilsPropsDir)submodules\json.props" />
    <Import Project="$(QwrFb2kUtilsPropsDir)submodules\range.props" />
    <Import Project="$(QwrFb2kUtilsPropsDir)submodules\ring_span.props" />
    <Import Project="$(QwrFb2kUtilsPropsDir)submodules\pfc.props" />
    <Import Project="$(QwrFb2kUtilsPropsDir)submodules\span.props" />
    <Import Project="$(QwrFb2kUtilsPropsDir)submodules\wtl.props" />
    <Import Project="$(SolutionDir)\..\props\local_dependencies\libspotify.props" />
  </ImportGroup>
  <PropertyGroup Label="UserMacros" />
  <PropertyGroup Condition="'$(Configuration)'=='Debug'">
    <LinkIncremental>true</LinkIncremental>
  </PropertyGroup>
  <PropertyGroup>
    <CAExcludePath>$(IncludePath);$(CAExcludePath)</CAExcludePath>
  </PropertyGroup>
  <ItemDefinitionGroup>
    <ClCompile>
      <AdditionalIncludeDirectories>$(ProjectDir);$(IncludePath);%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
      <LanguageStandard>stdcpp17</LanguageStandard>
      <AdditionalOptions>/Zm200 /Zc:__cplusplus /Zc:preprocessor /experimental:newLambdaProcessor %(AdditionalOptions)</AdditionalOptions>
      <PrecompiledHeader>Use</PrecompiledHeader>
      <DisableSpecificWarnings>5105</DisableSpecificWarnings>
      <TreatWarningAsError>true</TreatWarningAsError>
      <EnforceTypeConversionRules>true</EnforceTypeConversionRules>
      <RuntimeTypeInfo>false</RuntimeTypeInfo>
      <ConformanceMode>true</ConformanceMode>
      <DebugInformationFormat>ProgramDatabase</DebugInformationFormat>
      <AdditionalOptions>-await %(AdditionalOptions)</AdditionalOptions>
    </ClCompile>
    <Link>
      <AdditionalDependencies>credui.lib;%(AdditionalDependencies)</AdditionalDependencies>
      <SubSystem>Windows</SubSystem>
      <AdditionalOptions>/SOURCELINK:$(IndependentGeneratedDir)source_link.json %(AdditionalOptions)</AdditionalOptions>
    </Link>
  </ItemDefinitionGroup>
  <ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
    <ClCompile>
      <PreprocessorDefinitions>_WINDOWS;_USRDLL;%(PreprocessorDefinitions)</PreprocessorDefinitions>
      <BasicRuntimeChecks>EnableFastChecks</BasicRuntimeChecks>
    </ClCompile>
    <Link>
      <TargetMachine>MachineX86</TargetMachine>
      <ImageHasSafeExceptionHandlers>false</ImageHasSafeExceptionHandlers>
    </Link>
  </ItemDefinitionGroup>
  <ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">
    <ClCompile>
      <PreprocessorDefinitions>_WINDOWS;_USRDLL;_CRT_SECURE_NO_WARNINGS;_CRT_NON_CONFORMING_SWPRINTFS;%(PreprocessorDefinitions)</PreprocessorDefinitions>
      <StringPooling>true</StringPooling>
      <BufferSecurityCheck>false</BufferSecurityCheck>
      <FloatingPointModel>Fast</FloatingPointModel>
    </ClCompile>
    <ResourceCompile>
      <Culture>0x0409</Culture>
    </ResourceCompile>
    <Link>
      <OptimizeReferences>true</OptimizeReferences>
      <EnableCOMDATFolding>true</EnableCOMDATFolding>
      <TargetMachine>MachineX86</TargetMachine>
    </Link>
  </ItemDefinitionGroup>
  <ItemGroup>
    <ClCompile Include="backend\audio_buffer.cpp" />
    <ClCompile Include="backend\libspotify_backend.cpp" />
    <ClCompile Include="backend\spotify_instance.cpp" />
    <ClCompile Include="backend\spotify_object.cpp" />
    <ClCompile Include="backend\webapi_auth.cpp" />
    <ClCompile Include="backend\webapi_auth_scopes.cpp" />
    <ClCompile Include="backend\webapi_backend.cpp" />
    <ClCompile Include="backend\webapi_cache.cpp" />
    <ClCompile Include="backend\webapi_objects\webapi_album.cpp" />
    <ClCompile Include="backend\webapi_objects\webapi_artist.cpp" />
    <ClCompile Include="backend\webapi_objects\webapi_image.cpp" />
    <ClCompile Include="backend\webapi_objects\webapi_paging_object.cpp" />
    <ClCompile Include="backend\webapi_objects\webapi_playlist_track.cpp" />
    <ClCompile Include="backend\webapi_objects\webapi_restriction.cpp" />
    <ClCompile Include="backend\webapi_objects\webapi_track.cpp" />
    <ClCompile Include="backend\webapi_objects\webapi_track_link.cpp" />
    <ClCompile Include="backend\webapi_objects\webapi_user.cpp" />
    <ClCompile Include="component_paths.cpp" />
    <ClCompile Include="dllmain.cpp" />
    <ClCompile Include="fb2k\acfu_integration.cpp" />
    <ClCompile Include="fb2k\advanced_config.cpp" />
    <ClCompile Include="fb2k\album_art.cpp" />
    <ClCompile Include="fb2k\config.cpp" />
    <ClCompile Include="fb2k\filesystem.cpp" />
    <ClCompile Include="fb2k\file_info_filler.cpp" />
    <ClCompile Include="fb2k\input.cpp" />
    <ClCompile Include="fb2k\playback.cpp" />
    <ClCompile Include="fb2k\playlist.cpp" />
    <ClCompile Include="fb2k\playlist_loader.cpp" />
    <ClCompile Include="stdafx.cpp">
      <PrecompiledHeader>Create</PrecompiledHeader>
      <PrecompiledHeaderFile>stdafx.h</PrecompiledHeaderFile>
    </ClCompile>
    <ClCompile Include="ui\ui_not_auth.cpp" />
    <ClCompile Include="ui\ui_pref_tab_auth.cpp" />
    <ClCompile Include="ui\ui_pref_tab_manager.cpp" />
    <ClCompile Include="ui\ui_pref_tab_playback.cpp" />
    <ClCompile Include="utils\abort_manager.cpp" />
    <ClCompile Include="utils\cred_prompt.cpp" />
    <ClCompile Include="utils\rps_limiter.cpp" />
    <ClCompile Include="utils\sleeper.cpp" />
  </ItemGroup>
  <ItemGroup>
    <ClInclude Include="backend\audio_buffer.h" />
    <ClInclude Include="backend\libspotify_key.h" />
    <ClInclude Include="backend\libspotify_backend_user.h" />
    <ClInclude Include="backend\libspotify_wrapper.h" />
    <ClInclude Include="backend\libspotify_backend.h" />
    <ClInclude Include="backend\spotify_instance.h" />
    <ClInclude Include="backend\spotify_object.h" />
    <ClInclude Include="backend\webapi_auth.h" />
    <ClInclude Include="backend\webapi_auth_scopes.h" />
    <ClInclude Include="backend\webapi_backend.h" />
    <ClInclude Include="backend\webapi_objects\webapi_image.h" />
    <ClInclude Include="backend\webapi_objects\webapi_album.h" />
    <ClInclude Include="backend\webapi_objects\webapi_artist.h" />
    <ClInclude Include="backend\webapi_objects\webapi_media_objects.h" />
    <ClInclude Include="backend\webapi_objects\webapi_paging_object.h" />
    <ClInclude Include="backend\webapi_objects\webapi_playlist_track.h" />
    <ClInclude Include="backend\webapi_objects\webapi_restriction.h" />
    <ClInclude Include="backend\webapi_objects\webapi_track.h" />
    <ClInclude Include="backend\webapi_cache.h" />
    <ClInclude Include="backend\webapi_objects\webapi_track_link.h" />
    <ClInclude Include="backend\webapi_objects\webapi_user.h" />
    <ClInclude Include="component_defines.h" />
    <ClInclude Include="component_guids.h" />
    <ClInclude Include="component_paths.h" />
    <ClInclude Include="component_urls.h" />
    <ClInclude Include="fb2k\advanced_config.h" />
    <ClInclude Include="fb2k\config.h" />
    <ClInclude Include="fb2k\file_info_filler.h" />
    <ClInclude Include="fb2k\playback.h" />
    <ClInclude Include="resource.h" />
    <ClInclude Include="stdafx.h" />
    <ClInclude Include="ui\ui_ipref_tab.h" />
    <ClInclude Include="ui\ui_not_auth.h" />
    <ClInclude Include="ui\ui_pref_tab_auth.h" />
    <ClInclude Include="ui\ui_pref_tab_manager.h" />
    <ClInclude Include="ui\ui_pref_tab_playback.h" />
    <ClInclude Include="utils\abort_manager.h" />
    <ClInclude Include="utils\async_mutex.hpp" />
    <ClInclude Include="utils\cred_prompt.h" />
    <ClInclude Include="utils\json_macro_fix.h" />
    <ClInclude Include="utils\json_std_extenders.h" />
    <ClInclude Include="utils\rps_limiter.h" />
    <ClInclude Include="utils\secure_vector.h" />
    <ClInclude Include="utils\sleeper.h" />
  </ItemGroup>
  <ItemGroup>
    <ProjectReference Include="..\submodules\fb2k_utils\src\fb2k_utils.vcxproj">
      <Project>{ee3bf4f9-2014-4cff-96c8-44cfb85e0571}</Project>
    </ProjectReference>
    <ProjectReference Include="..\submodules\foobar2000\foobar2000_component_client\foobar2000_component_client.vcxproj">
      <Project>{71ad2674-065b-48f5-b8b0-e1f9d3892081}</Project>
    </ProjectReference>
    <ProjectReference Include="..\submodules\foobar2000\SDK\foobar2000_SDK.vcxproj">
      <Project>{e8091321-d79d-4575-86ef-064ea1a4a20d}</Project>
    </ProjectReference>
    <ProjectReference Include="..\submodules\pfc\pfc.vcxproj">
      <Project>{ebfffb4e-261d-44d3-b89c-957b31a0bf9c}</Project>
    </ProjectReference>
  </ItemGroup>
  <ItemGroup>
    <ResourceCompile Include="foo_spotify.rc" />
  </ItemGroup>
  <ItemGroup>
    <None Include="foo_spotify.rc2" />
  </ItemGroup>
  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.targets" />
  <ImportGroup Label="ExtensionTargets">
    <Import Project="..\workspaces\packages\Microsoft.Build.Tasks.Git.1.0.0\build\Microsoft.Build.Tasks.Git.targets" Condition="Exists('..\workspaces\packages\Microsoft.Build.Tasks.Git.1.0.0\build\Microsoft.Build.Tasks.Git.targets')" />
    <Import Project="..\workspaces\packages\Microsoft.SourceLink.Common.1.0.0\build\Microsoft.SourceLink.Common.targets" Condition="Exists('..\workspaces\packages\Microsoft.SourceLink.Common.1.0.0\build\Microsoft.SourceLink.Common.targets')" />
    <Import Project="..\workspaces\packages\Microsoft.SourceLink.GitHub.1.0.0\build\Microsoft.SourceLink.GitHub.targets" Condition="Exists('..\workspaces\packages\Microsoft.SourceLink.GitHub.1.0.0\build\Microsoft.SourceLink.GitHub.targets')" />
  </ImportGroup>
  <Target Name="EnsureNuGetPackageBuildImports" BeforeTargets="PrepareForBuild">
    <PropertyGroup>
      <ErrorText>This project references NuGet package(s) that are missing on this computer. Use NuGet Package Restore to download them.  For more information, see http://go.microsoft.com/fwlink/?LinkID=322105. The missing file is {0}.</ErrorText>
    </PropertyGroup>
    <Error Condition="!Exists('..\workspaces\packages\Microsoft.Build.Tasks.Git.1.0.0\build\Microsoft.Build.Tasks.Git.props')" Text="$([System.String]::Format('$(ErrorText)', '..\workspaces\packages\Microsoft.Build.Tasks.Git.1.0.0\build\Microsoft.Build.Tasks.Git.props'))" />
    <Error Condition="!Exists('..\workspaces\packages\Microsoft.Build.Tasks.Git.1.0.0\build\Microsoft.Build.Tasks.Git.targets')" Text="$([System.String]::Format('$(ErrorText)', '..\workspaces\packages\Microsoft.Build.Tasks.Git.1.0.0\build\Microsoft.Build.Tasks.Git.targets'))" />
    <Error Condition="!Exists('..\workspaces\packages\Microsoft.SourceLink.Common.1.0.0\build\Microsoft.SourceLink.Common.props')" Text="$([System.String]::Format('$(ErrorText)', '..\workspaces\packages\Microsoft.SourceLink.Common.1.0.0\build\Microsoft.SourceLink.Common.props'))" />
    <Error Condition="!Exists('..\workspaces\packages\Microsoft.SourceLink.Common.1.0.0\build\Microsoft.SourceLink.Common.targets')" Text="$([System.String]::Format('$(ErrorText)', '..\workspaces\packages\Microsoft.SourceLink.Common.1.0.0\build\Microsoft.SourceLink.Common.targets'))" />
    <Error Condition="!Exists('..\workspaces\packages\Microsoft.SourceLink.GitHub.1.0.0\build\Microsoft.SourceLink.GitHub.props')" Text="$([System.String]::Format('$(ErrorText)', '..\workspaces\packages\Microsoft.SourceLink.GitHub.1.0.0\build\Microsoft.SourceLink.GitHub.props'))" />
    <Error Condition="!Exists('..\workspaces\packages\Microsoft.SourceLink.GitHub.1.0.0\build\Microsoft.SourceLink.GitHub.targets')" Text="$([System.String]::Format('$(ErrorText)', '..\workspaces\packages\Microsoft.SourceLink.GitHub.1.0.0\build\Microsoft.SourceLink.GitHub.targets'))" />
  </Target>
</Project>

================================================
FILE: foo_spotify/foo_spotify.vcxproj.filters
================================================
<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <ItemGroup>
    <ClCompile Include="stdafx.cpp" />
    <ClCompile Include="dllmain.cpp" />
    <ClCompile Include="fb2k\input.cpp">
      <Filter>fb2k</Filter>
    </ClCompile>
    <ClCompile Include="backend\libspotify_backend.cpp">
      <Filter>backend</Filter>
    </ClCompile>
    <ClCompile Include="utils\cred_prompt.cpp">
      <Filter>utils</Filter>
    </ClCompile>
    <ClCompile Include="fb2k\album_art.cpp">
      <Filter>fb2k</Filter>
    </ClCompile>
    <ClCompile Include="fb2k\playback.cpp">
      <Filter>fb2k</Filter>
    </ClCompile>
    <ClCompile Include="backend\webapi_auth.cpp">
      <Filter>backend</Filter>
    </ClCompile>
    <ClCompile Include="component_paths.cpp" />
    <ClCompile Include="backend\webapi_backend.cpp">
      <Filter>backend</Filter>
    </ClCompile>
    <ClCompile Include="fb2k\playlist_loader.cpp">
      <Filter>fb2k</Filter>
    </ClCompile>
    <ClCompile Include="backend\webapi_objects\webapi_image.cpp">
      <Filter>backend\webapi_objects</Filter>
    </ClCompile>
    <ClCompile Include="backend\webapi_objects\webapi_track.cpp">
      <Filter>backend\webapi_objects</Filter>
    </ClCompile>
    <ClCompile Include="backend\webapi_objects\webapi_album.cpp">
      <Filter>backend\webapi_objects</Filter>
    </ClCompile>
    <ClCompile Include="backend\webapi_objects\webapi_artist.cpp">
      <Filter>backend\webapi_objects</Filter>
    </ClCompile>
    <ClCompile Include="fb2k\advanced_config.cpp">
      <Filter>fb2k</Filter>
    </ClCompile>
    <ClCompile Include="backend\webapi_cache.cpp">
      <Filter>backend</Filter>
    </ClCompile>
    <ClCompile Include="backend\spotify_object.cpp">
      <Filter>backend</Filter>
    </ClCompile>
    <ClCompile Include="fb2k\file_info_filler.cpp">
      <Filter>fb2k</Filter>
    </ClCompile>
    <ClCompile Include="backend\webapi_objects\webapi_playlist_track.cpp">
      <Filter>backend\webapi_objects</Filter>
    </ClCompile>
    <ClCompile Include="utils\abort_manager.cpp">
      <Filter>utils</Filter>
    </ClCompile>
    <ClCompile Include="backend\webapi_objects\webapi_user.cpp">
      <Filter>backend\webapi_objects</Filter>
    </ClCompile>
    <ClCompile Include="backend\spotify_instance.cpp">
      <Filter>backend</Filter>
    </ClCompile>
    <ClCompile Include="ui\ui_not_auth.cpp">
      <Filter>ui</Filter>
    </ClCompile>
    <ClCompile Include="fb2k\acfu_integration.cpp">
      <Filter>fb2k</Filter>
    </ClCompile>
    <ClCompile Include="fb2k\config.cpp">
      <Filter>fb2k</Filter>
    </ClCompile>
    <ClCompile Include="backend\audio_buffer.cpp">
      <Filter>backend</Filter>
    </ClCompile>
    <ClCompile Include="fb2k\filesystem.cpp">
      <Filter>fb2k</Filter>
    </ClCompile>
    <ClCompile Include="backend\webapi_auth_scopes.cpp">
      <Filter>backend</Filter>
    </ClCompile>
    <ClCompile Include="backend\webapi_objects\webapi_restriction.cpp">
      <Filter>backend\webapi_objects</Filter>
    </ClCompile>
    <ClCompile Include="backend\webapi_objects\webapi_track_link.cpp">
      <Filter>backend\webapi_objects</Filter>
    </ClCompile>
    <ClCompile Include="utils\sleeper.cpp">
      <Filter>utils</Filter>
    </ClCompile>
    <ClCompile Include="ui\ui_pref_tab_manager.cpp">
      <Filter>ui</Filter>
    </ClCompile>
    <ClCompile Include="ui\ui_pref_tab_auth.cpp">
      <Filter>ui</Filter>
    </ClCompile>
    <ClCompile Include="ui\ui_pref_tab_playback.cpp">
      <Filter>ui</Filter>
    </ClCompile>
    <ClCompile Include="utils\rps_limiter.cpp">
      <Filter>utils</Filter>
    </ClCompile>
    <ClCompile Include="fb2k\playlist.cpp">
      <Filter>fb2k</Filter>
    </ClCompile>
    <ClCompile Include="backend\webapi_objects\webapi_paging_object.cpp">
      <Filter>backend\webapi_objects</Filter>
    </ClCompile>
  </ItemGroup>
  <ItemGroup>
    <ClInclude Include="component_defines.h" />
    <ClInclude Include="component_guids.h" />
    <ClInclude Include="stdafx.h" />
    <ClInclude Include="utils\secure_vector.h">
      <Filter>utils</Filter>
    </ClInclude>
    <ClInclude Include="backend\audio_buffer.h">
      <Filter>backend</Filter>
    </ClInclude>
    <ClInclude Include="backend\libspotify_wrapper.h">
      <Filter>backend</Filter>
    </ClInclude>
    <ClInclude Include="backend\libspotify_backend.h">
      <Filter>backend</Filter>
    </ClInclude>
    <ClInclude Include="utils\cred_prompt.h">
      <Filter>utils</Filter>
    </ClInclude>
    <ClInclude Include="backend\libspotify_backend_user.h">
      <Filter>backend</Filter>
    </ClInclude>
    <ClInclude Include="backend\libspotify_key.h">
      <Filter>backend</Filter>
    </ClInclude>
    <ClInclude Include="backend\webapi_auth.h">
      <Filter>backend</Filter>
    </ClInclude>
    <ClInclude Include="utils\async_mutex.hpp">
      <Filter>utils</Filter>
    </ClInclude>
    <ClInclude Include="component_paths.h" />
    <ClInclude Include="component_urls.h" />
    <ClInclude Include="backend\webapi_backend.h">
      <Filter>backend</Filter>
    </ClInclude>
    <ClInclude Include="backend\spotify_object.h">
      <Filter>backend</Filter>
    </ClInclude>
    <ClInclude Include="backend\webapi_objects\webapi_track.h">
      <Filter>backend\webapi_objects</Filter>
    </ClInclude>
    <ClInclude Include="backend\webapi_objects\webapi_album.h">
      <Filter>backend\webapi_objects</Filter>
    </ClInclude>
    <ClInclude Include="backend\webapi_objects\webapi_artist.h">
      <Filter>backend\webapi_objects</Filter>
    </ClInclude>
    <ClInclude Include="backend\webapi_objects\webapi_image.h">
      <Filter>backend\webapi_objects</Filter>
    </ClInclude>
    <ClInclude Include="utils\json_std_extenders.h">
      <Filter>utils</Filter>
    </ClInclude>
    <ClInclude Include="utils\json_macro_fix.h">
      <Filter>utils</Filter>
    </ClInclude>
    <ClInclude Include="fb2k\advanced_config.h">
      <Filter>fb2k</Filter>
    </ClInclude>
    <ClInclude Include="backend\webapi_cache.h">
      <Filter>backend</Filter>
    </ClInclude>
    <ClInclude Include="fb2k\file_info_filler.h">
      <Filter>fb2k</Filter>
    </ClInclude>
    <ClInclude Include="utils\abort_manager.h">
      <Filter>utils</Filter>
    </ClInclude>
    <ClInclude Include="resource.h">
      <Filter>resources</Filter>
    </ClInclude>
    <ClInclude Include="backend\webapi_objects\webapi_playlist_track.h">
      <Filter>backend\webapi_objects</Filter>
    </ClInclude>
    <ClInclude Include="backend\webapi_objects\webapi_user.h">
      <Filter>backend\webapi_objects</Filter>
    </ClInclude>
    <ClInclude Include="backend\spotify_instance.h">
      <Filter>backend</Filter>
    </ClInclude>
    <ClInclude Include="fb2k\playback.h">
      <Filter>fb2k</Filter>
    </ClInclude>
    <ClInclude Include="ui\ui_not_auth.h">
      <Filter>ui</Filter>
    </ClInclude>
    <ClInclude Include="fb2k\config.h">
      <Filter>fb2k</Filter>
    </ClInclude>
    <ClInclude Include="backend\webapi_auth_scopes.h">
      <Filter>backend</Filter>
    </ClInclude>
    <ClInclude Include="backend\webapi_objects\webapi_restriction.h">
      <Filter>backend\webapi_objects</Filter>
    </ClInclude>
    <ClInclude Include="backend\webapi_objects\webapi_media_objects.h">
      <Filter>backend\webapi_objects</Filter>
    </ClInclude>
    <ClInclude Include="backend\webapi_objects\webapi_track_link.h">
      <Filter>backend\webapi_objects</Filter>
    </ClInclude>
    <ClInclude Include="utils\sleeper.h">
      <Filter>utils</Filter>
    </ClInclude>
    <ClInclude Include="ui\ui_pref_tab_manager.h">
      <Filter>ui</Filter>
    </ClInclude>
    <ClInclude Include="ui\ui_pref_tab_auth.h">
      <Filter>ui</Filter>
    </ClInclude>
    <ClInclude Include="ui\ui_ipref_tab.h">
      <Filter>ui</Filter>
    </ClInclude>
    <ClInclude Include="ui\ui_pref_tab_playback.h">
      <Filter>ui</Filter>
    </ClInclude>
    <ClInclude Include="utils\rps_limiter.h">
      <Filter>utils</Filter>
    </ClInclude>
    <ClInclude Include="backend\webapi_objects\webapi_paging_object.h">
      <Filter>backend\webapi_objects</Filter>
    </ClInclude>
  </ItemGroup>
  <ItemGroup>
    <Filter Include="utils">
      <UniqueIdentifier>{39367257-b161-4f23-b132-bcf2bc7a7b1e}</UniqueIdentifier>
    </Filter>
    <Filter Include="backend">
      <UniqueIdentifier>{b367b073-47b1-4060-9fb1-165c7d6558c8}</UniqueIdentifier>
    </Filter>
    <Filter Include="fb2k">
      <UniqueIdentifier>{a36e2bb9-5034-4b8e-9275-aac759906267}</UniqueIdentifier>
    </Filter>
    <Filter Include="backend\webapi_objects">
      <UniqueIdentifier>{9f4d57e0-bdd7-495d-a54d-0c753b8c738e}</UniqueIdentifier>
    </Filter>
    <Filter Include="ui">
      <UniqueIdentifier>{20a66e7a-1826-4915-8807-e86a5c3df4f8}</UniqueIdentifier>
    </Filter>
    <Filter Include="resources">
      <UniqueIdentifier>{4cc30a63-061e-4a1c-a2f1-8ecc63d6f357}</UniqueIdentifier>
    </Filter>
  </ItemGroup>
  <ItemGroup>
    <ResourceCompile Include="foo_spotify.rc">
      <Filter>resources</Filter>
    </ResourceCompile>
  </ItemGroup>
  <ItemGroup>
    <None Include="foo_spotify.rc2">
      <Filter>resources</Filter>
    </None>
  </ItemGroup>
</Project>

================================================
FILE: foo_spotify/packages.config
================================================
<?xml version="1.0" encoding="utf-8"?>
<packages>
  <package id="Microsoft.Build.Tasks.Git" version="1.0.0" targetFramework="native" developmentDependency="true" />
  <package id="Microsoft.SourceLink.Common" version="1.0.0" targetFramework="native" developmentDependency="true" />
  <package id="Microsoft.SourceLink.GitHub" version="1.0.0" targetFramework="native" developmentDependency="true" />
</packages>

================================================
FILE: foo_spotify/resource.h
================================================
//{{NO_DEPENDENCIES}}
// Microsoft Visual C++ generated include file.
// Used by foo_spotify.rc
//
#define VS_VERSION_INFO              1
#define IDD_PREF_TAB_HOST            101
#define IDD_NOT_AUTH                 102
#define IDD_PREF_TAB_AUTH            103
#define IDD_PREF_TAB_PLAYBACK        104
#define IDC_BTN_LOGIN_LIBSPOTIFY     1003
#define IDC_BTN_LOGIN_WEBAPI         1004
#define IDC_STATIC_LIBSPOTIFY_STATUS 1005
#define IDC_STATIC_WEBAPI_STATUS     1006
#define IDC_BTN_OPEN_PREF            1007
#define IDC_STATIC_NOT_AUTH          1008
#define IDC_COMBO_BITRATE            1009
#define IDC_CHECK_NORMALIZE          1010
#define IDC_CHECK_PRIVATE            1011
#define IDC_TAB_HOST                 1012
#define IDC_SLIDER_CACHE_MB          1013
#define IDC_SLIDER_CACHE_PERCENT     1014
#define IDC_EDIT_CACHE_MB            1015
#define IDC_EDIT_CACHE_PERCENT       1016

// Next default values for new objects
//
#ifdef APSTUDIO_INVOKED
#    ifndef APSTUDIO_READONLY_SYMBOLS
#        define _APS_NEXT_RESOURCE_VALUE 105
#        define _APS_NEXT_COMMAND_VALUE  40001
#        define _APS_NEXT_CONTROL_VALUE  1017
#        define _APS_NEXT_SYMED_VALUE    101
#    endif
#endif


================================================
FILE: foo_spotify/stdafx.cpp
================================================
#include <stdafx.h>


================================================
FILE: foo_spotify/stdafx.h
================================================
#pragma once

// clang-format off
// !!! Include order is important here (esp. for Win headers) !!!

// Support only Windows 7 and newer
#define _WIN32_WINNT _WIN32_WINNT_WIN7
#define WINVER _WIN32_WINNT_WIN7

// Fix std min max conflicts
#define NOMINMAX
#include <WinSock2.h>
#include <Windows.h>

// ATL/WTL
/// atlstr.h (includes atlbase.h) must be included first for CString to LPTSTR conversion to work.
#include <atlstr.h> 
#include <atlapp.h>
#include <atlcom.h>
#include <atlcrack.h>
#include <atlctrls.h>
#include <atlddx.h>
#include <atldlgs.h>
#include <atlfind.h>
#include <atlframe.h>
#include <atltheme.h>
#include <atltypes.h>
#include <atlwin.h>

// foobar2000 SDK
#pragma warning( push, 0 )
#   include <foobar2000/SDK/foobar2000.h>
#pragma warning( pop ) 

// fmt
#define FMT_HEADER_ONLY
#include <fmt/format.h>

// nlohmann json
#include <nlohmann/json.hpp>

// range v3
#include <range/v3/all.hpp>

#if not __cpp_char8_t
// Dummy type
#include <string>

using char8_t = char;
namespace std // NOLINT(cert-dcl58-cpp)
{
using u8string = basic_string<char8_t, char_traits<char8_t>, allocator<char8_t>>;
using u8string_view = basic_string_view<char8_t>;
}
#endif

// Additional PFC wrappers
#include <qwr/pfc_helpers_cnt.h>
#include <qwr/pfc_helpers_stream.h>

#include <qwr/unicode.h>
#include <qwr/qwr_exception.h>

#include <utils/json_macro_fix.h>

#include <component_defines.h>
#include <component_guids.h>
#include <component_paths.h>

// clang-format on


================================================
FILE: foo_spotify/ui/ui_ipref_tab.h
================================================
#pragma once

namespace sptf::ui
{

class IPrefTab
{
public:
    virtual ~IPrefTab() = default;

    virtual HWND CreateTab( HWND hParent ) = 0;
    virtual CDialogImplBase& Dialog() = 0;
    virtual const wchar_t* Name() const = 0;

    // preferences_page_instance

    //! @returns a combination of preferences_state constants.
    virtual uint32_t get_state() = 0;
    //! @returns the window handle.
    //! Applies preferences changes.
    virtual void apply() = 0;
    //! Resets this page's content to the default values. Does not apply any changes - lets user preview the changes before hitting "apply".
    virtual void reset() = 0;
};

} // namespace sptf::ui


================================================
FILE: foo_spotify/ui/ui_not_auth.cpp
================================================
#include <stdafx.h>

#include "ui_not_auth.h"

#include <qwr/hook_handler.h>

namespace sptf::ui
{

NotAuth::NotAuth( std::function<void()> onDestroyCallback )
    : onDestroyCallback_( onDestroyCallback )
{
}

BOOL NotAuth::OnInitDialog( HWND hwndFocus, LPARAM lParam )
{
    hookId_ = qwr::HookHandler::GetInstance().RegisterHook(
        [hParent = m_hWnd]( int code, WPARAM wParam, LPARAM lParam ) {
            GetMsgProc( code, wParam, lParam, hParent );
        } );

    SetWindowText( TEXT( SPTF_NAME ) );

    CStatic text( GetDlgItem( IDC_STATIC_NOT_AUTH ) );
    text.SetWindowText( fmt::format(
                            L"{} ({}) requires Spotify Premium account.\n"
                            L"Open the corresponding foobar2000 Preferences page to authorize.",
                            TEXT( SPTF_NAME ),
                            TEXT( SPTF_UNDERSCORE_NAME ) )
                            .c_str() );

    return TRUE; // set focus to default control
}

void NotAuth::OnDestroy()
{
    if ( hookId_ )
    {
        qwr::HookHandler::GetInstance().UnregisterHook( hookId_ );
        hookId_ = 0;
    }
}

void NotAuth::OnCloseCmd( UINT uNotifyCode, int nID, CWindow wndCtl )
{
    DestroyWindow();
}

void NotAuth::OnOpenPrefClick( UINT uNotifyCode, int nID, CWindow wndCtl )
{
    ::fb2k::inMainThread( [] { ui_control::get()->show_preferences( sptf::guid::preferences ); } );
    DestroyWindow();
}

void NotAuth::OnFinalMessage( _In_ HWND /*hWnd*/ )
{
    onDestroyCallback_();
    delete this;
}

void NotAuth::GetMsgProc( int, WPARAM, LPARAM lParam, HWND hParent )
{
    if ( auto pMsg = reinterpret_cast<LPMSG>( lParam );
         pMsg->message >= WM_KEYFIRST && pMsg->message <= WM_KEYLAST )
    { // Only react to keypress events
        HWND hWndFocus = ::GetFocus();
        if ( hWndFocus != nullptr && ( ( hParent == hWndFocus ) || ::IsChild( hParent, hWndFocus ) ) )
        {
            if ( ::IsDialogMessage( hParent, pMsg ) )
            {
                pMsg->message = WM_NULL;
            }
        }
    }
}

NotAuthHandler& NotAuthHandler::Get()
{
    static NotAuthHandler nah;
    return nah;
}

void NotAuthHandler::ShowDialog()
{
    assert( core_api::is_main_thread() );
    if ( !pNotAuth_ )
    {
        pNotAuth_ = new ui::NotAuth( [&] {
            assert( core_api::is_main_thread() );
            pNotAuth_ = nullptr;
        } );
        if ( !pNotAuth_->Create( core_api::get_main_window() ) )
        {
            delete pNotAuth_;
            pNotAuth_ = nullptr;
            return;
        }

        pNotAuth_->SetActiveWindow();
        pNotAuth_->CenterWindow( core_api::get_main_window() );
        pNotAuth_->ShowWindow( SW_SHOW );
    }
    else
    {
        pNotAuth_->SetActiveWindow();
        pNotAuth_->ShowWindow( SW_SHOW );
    }
}

void NotAuthHandler::CloseDialog()
{
    assert( core_api::is_main_thread() );
    if ( pNotAuth_ )
    {
        pNotAuth_->DestroyWindow();
    }
}

} // namespace sptf::ui

================================================
FILE: foo_spotify/ui/ui_not_auth.h
================================================
#pragma once

#include <resource.h>

#include <mutex>

namespace sptf::ui
{

class NotAuth
    : public CDialogImpl<NotAuth>
{
public:
    enum
    {
        IDD = IDD_NOT_AUTH
    };

    NotAuth( std::function<void()> onDestroyCallback );
    ~NotAuth() = default;

protected:
    BEGIN_MSG_MAP( NotAuth )
        MSG_WM_INITDIALOG( OnInitDialog )
        MSG_WM_DESTROY( OnDestroy )
        COMMAND_RANGE_HANDLER_EX( IDOK, IDCANCEL, OnCloseCmd )
        COMMAND_HANDLER_EX( IDC_BTN_OPEN_PREF, BN_CLICKED, OnOpenPrefClick )
    END_MSG_MAP()

private:
    BOOL OnInitDialog( HWND hwndFocus, LPARAM lParam );
    void OnDestroy();

    void OnCloseCmd( UINT uNotifyCode, int nID, CWindow wndCtl );
    void OnOpenPrefClick( UINT uNotifyCode, int nID, CWindow wndCtl );

    void OnFinalMessage( _In_ HWND hWnd ) override;

    static void GetMsgProc( int code, WPARAM wParam, LPARAM lParam, HWND hParent );

private:
    uint32_t hookId_ = 0;
    std::function<void()> onDestroyCallback_;
};

class NotAuthHandler
{
public:
    ~NotAuthHandler() = default;
    static NotAuthHandler& Get();

    void ShowDialog();
    void CloseDialog();

private:
    NotAuthHandler() = default;

private:
    std::mutex authMutex_;
    sptf::ui::NotAuth* pNotAuth_ = nullptr;
};

} // namespace sptf::ui


================================================
FILE: foo_spotify/ui/ui_pref_tab_auth.cpp
================================================
#include <stdafx.h>

#include "ui_pref_tab_auth.h"

#include <backend/libspotify_backend.h>
#include <backend/spotify_instance.h>
#include <backend/webapi_auth.h>
#include <backend/webapi_auth_scopes.h>
#include <backend/webapi_backend.h>
#include <backend/webapi_objects/webapi_user.h>
#include <fb2k/config.h>
#include <ui/ui_pref_tab_manager.h>

#include <component_urls.h>

#include <qwr/abort_callback.h>
#include <qwr/error_popup.h>
#include <qwr/string_helpers.h>

namespace sptf::ui
{

PreferenceTabAuth::PreferenceTabAuth( PreferenceTabManager* pParent )
    : pParent_( pParent )
    , ddxOptions_( {} )
{
}

PreferenceTabAuth::~PreferenceTabAuth()
{
    for ( auto& ddxOpt: ddxOptions_ )
    {
        ddxOpt->Option().Revert();
    }
}

HWND PreferenceTabAuth::CreateTab( HWND hParent )
{
    return Create( hParent );
}

CDialogImplBase& PreferenceTabAuth::Dialog()
{
    return *this;
}

const wchar_t* PreferenceTabAuth::Name() const
{
    return L"Authorization";
}

t_uint32 PreferenceTabAuth::get_state()
{
    const bool hasChanged =
        ddxOptions_.cend() != std::find_if( ddxOptions_.cbegin(), ddxOptions_.cend(), []( const auto& ddxOpt ) {
            return ddxOpt->Option().HasChanged();
        } );

    return ( preferences_state::resettable | ( hasChanged ? preferences_state::changed : 0 ) );
}

void PreferenceTabAuth::apply()
{
    for ( auto& ddxOpt: ddxOptions_ )
    {
        ddxOpt->Option().Apply();
    }

    pParent_->OnDataChanged();
}

void PreferenceTabAuth::reset()
{
    for ( auto& ddxOpt: ddxOptions_ )
    {
        ddxOpt->Option().ResetToDefault();
    }
    UpdateUiFromCfg();

    pParent_->OnDataChanged();
}

BOOL PreferenceTabAuth::OnInitDialog( HWND hwndFocus, LPARAM lParam )
{
    btnLibSpotify_ = GetDlgItem( IDC_BTN_LOGIN_LIBSPOTIFY );
    btnWebApi_ = GetDlgItem( IDC_BTN_LOGIN_WEBAPI );

    textLibSpotify_ = GetDlgItem( IDC_STATIC_LIBSPOTIFY_STATUS );
    textWebApi_ = GetDlgItem( IDC_STATIC_WEBAPI_STATUS );

    for ( auto& ddxOpt: ddxOptions_ )
    {
        ddxOpt->Ddx().SetHwnd( m_hWnd );
    }
    UpdateUiFromCfg();

    pStatusThread_ = std::make_unique<std::thread>( [this] {
        const auto lsStatus = [] {
            qwr::TimedAbortCallback tac( fmt::format( "{}: {}", SPTF_UNDERSCORE_NAME, "LibSpotify relogin" ) );
            return SpotifyInstance::Get().GetLibSpotify_Backend().Relogin( tac );
        }();
        const auto waStatus = [&] {
            auto& auth = SpotifyInstance::Get().GetWebApi_Backend().GetAuthorizer();
            if ( !auth.HasRefreshToken() )
            {
                return false;
            }
            try
            {
                qwr::TimedAbortCallback tac( fmt::format( "{}: {}", SPTF_UNDERSCORE_NAME, "WebApi relogin" ) );
                auth.UpdateRefreshToken( tac );
                return true;
            }
            catch ( const std::exception& )
            {
                return false;
            }
        }();

        ::PostMessage( m_hWnd, kOnStatusUpdateFinish, WPARAM( lsStatus ), LPARAM( waStatus ) );
    } );

    UpdateLibSpotifyUi();
    UpdateWebApiUi();

    return TRUE; // set focus to default control
}

void PreferenceTabAuth::OnDestroy()
{
    auto& auth = SpotifyInstance::Get().GetWebApi_Backend().GetAuthorizer();
    if ( webApiStatus_ == LoginStatus::logged_in )
    {
        auth.AuthenticateClean_Cleanup();
    }
    else
    {
        auth.CancelAuth();
    }

    if ( pStatusThread_ )
    {
        if ( pStatusThread_->joinable() )
        {
            pStatusThread_->join();
        }
        pStatusThread_.reset();
    }
}

HBRUSH PreferenceTabAuth::OnCtlColorStatic( CDCHandle dc, CStatic wndStatic )
{
    const auto id = wndStatic.GetDlgCtrlID();
    if ( id == IDC_STATIC_LIBSPOTIFY_STATUS
         || id == IDC_STATIC_WEBAPI_STATUS )
    {
        const auto getColour = []( auto loginStatus ) {
            switch ( loginStatus )
            {
            case LoginStatus::logged_out:
            {
                return RGB( 0x8B, 0x00, 0x00 );
            }
            case LoginStatus::logged_in:
            {
                return RGB( 0x2F, 0x4F, 0x4f );
            }
            default:
                return RGB( 0xFF, 0x7F, 0x50 );
            }
        };

        ::SetTextColor( dc, getColour( id == IDC_STATIC_LIBSPOTIFY_STATUS ? libSpotifyStatus_ : webApiStatus_ ) );
        ::SetBkColor( dc, GetSysColor( COLOR_WINDOW ) );
        return (HBRUSH)GetStockObject( HOLLOW_BRUSH );
    }

    SetMsgHandled( FALSE );

    return 0;
}

void PreferenceTabAuth::OnDdxChange( UINT uNotifyCode, int nID, CWindow wndCtl )
{
    auto it = std::find_if( ddxOptions_.begin(), ddxOptions_.end(), [nID]( auto& val ) {
        return val->Ddx().IsMatchingId( nID );
    } );

    if ( ddxOptions_.end() != it )
    {
        ( *it )->Ddx().ReadFromUi();
        pParent_->OnDataChanged();
    }
}

void PreferenceTabAuth::OnLibSpotifyLoginClick( UINT uNotifyCode, int nID, CWindow wndCtl )
{
    (void)uNotifyCode;
    (void)nID;
    (void)wndCtl;

    auto& lsBackend = SpotifyInstance::Get().GetLibSpotify_Backend();
    if ( libSpotifyStatus_ == LoginStatus::logged_out )
    {
        libSpotifyStatus_ = ( lsBackend.LoginWithUI( m_hWnd ) ? LoginStatus::logged_in : LoginStatus::logged_out );
    }
    else
    {
        qwr::TimedAbortCallback tac( fmt::format( "{}: {}", SPTF_UNDERSCORE_NAME, "LibSpotify logout" ) );
        lsBackend.LogoutAndForget( tac );
        libSpotifyStatus_ = LoginStatus::logged_out;
    }

    UpdateLibSpotifyUi();
}

void PreferenceTabAuth::OnWebApiLoginClick( UINT uNotifyCode, int nID, CWindow wndCtl )
{
    (void)uNotifyCode;
    (void)nID;
    (void)wndCtl;

    auto& auth = SpotifyInstance::Get().GetWebApi_Backend().GetAuthorizer();
    if ( webApiStatus_ == LoginStatus::logged_out )
    {
        // this operation is async
        webApiStatus_ = LoginStatus::login_in_progress;
        UpdateWebApiUi();

        try
        {
            const auto authScopes = qwr::unicode::ToWide( static_cast<std::string>( config::webapi_auth_scopes ) );
            const auto authScopesSplit = qwr::string::Split<wchar_t>( authScopes, L' ' );
            // TODO: remove me
            WebApiAuthScopes tmp( authScopesSplit );
            tmp.user_read_private = true;
            auth.AuthenticateClean( tmp, [&] { ::PostMessage( m_hWnd, kOnWebApiLoginResponse, 0, 0 ); } );
        }
        catch ( const std::exception& e )
        {
            qwr::ReportErrorWithPopup( SPTF_UNDERSCORE_NAME, fmt::format( "WebAPI login failed:\n{}", e.what() ) );

            webApiStatus_ = LoginStatus::logged_out;
            UpdateWebApiUi();
        }
    }
    else
    {
        auth.ClearAuth();

        webApiStatus_ = LoginStatus::logged_out;
        UpdateWebApiUi();
    }
}

LRESULT PreferenceTabAuth::OnWebApiLoginResponse( UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL& bHandled )
{
    (void)uMsg;
    (void)wParam;
    (void)lParam;

    bHandled = TRUE;

    auto& auth = SpotifyInstance::Get().GetWebApi_Backend().GetAuthorizer();

    webApiStatus_ = ( auth.HasRefreshToken() ? LoginStatus::logged_in : LoginStatus::logged_out );
    UpdateWebApiUi();

    return 0;
}

LRESULT PreferenceTabAuth::OnStatusUpdateFinish( UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL& bHandled )
{
    (void)uMsg;

    bHandled = TRUE;

    libSpotifyStatus_ = ( wParam ? LoginStatus::logged_in : LoginStatus::logged_out );
    webApiStatus_ = ( lParam ? LoginStatus::logged_in : LoginStatus::logged_out );
    UpdateLibSpotifyUi();
    UpdateWebApiUi();

    return 0;
}

void PreferenceTabAuth::UpdateUiFromCfg()
{
    if ( !this->m_hWnd )
    {
        return;
    }

    for ( auto& ddxOpt: ddxOptions_ )
    {
        ddxOpt->Ddx().WriteToUi();
    }
}

void PreferenceTabAuth::UpdateLibSpotifyUi()
{
    const auto getUsername = [] {
        return SpotifyInstance::Get().GetLibSpotify_Backend().GetLoggedInUserName();
    };
    UpdateBackendUi( libSpotifyStatus_, btnLibSpotify_, textLibSpotify_, getUsername );
}

void PreferenceTabAuth::UpdateWebApiUi()
{
    const auto getUsername = [] {
        qwr::TimedAbortCallback tac( fmt::format( "{}: {}", SPTF_UNDERSCORE_NAME, "WebApi get username" ) );
        try
        {
            auto& waBackend = SpotifyInstance::Get().GetWebApi_Backend();
            const auto pUser = waBackend.GetUser( tac );
            return pUser->display_name.value_or( pUser->uri );
        }
        catch ( const std::exception& e )
        {
            return fmt::format( "<error: user name could not be fetched - {}>", e.what() );
        }
    };
    UpdateBackendUi( webApiStatus_, btnWebApi_, textWebApi_, getUsername );
}

void PreferenceTabAuth::UpdateBackendUi( LoginStatus loginStatus, CButton& btn, CStatic& text, std::function<std::string()> getUserNameFn )
{
    Invalidate(); ///< needed to clear static text

    switch ( loginStatus )
    {
    case LoginStatus::fetching_login_status:
    {
        if ( btn.IsWindowEnabled() )
        {
            btn.EnableWindow( FALSE );
        }
        btn.SetWindowText( L"Log in" );
        text.SetWindowText( L"status: verifying login status" );
        break;
    }
    case LoginStatus::logged_out:
    {
        if ( !btn.IsWindowEnabled() )
        {
            btn.EnableWindow( TRUE );
        }
        btn.SetWindowText( L"Log in" );
        text.SetWindowText( L"status: logged out" );
        break;
    }
    case LoginStatus::login_in_progress:
    {
        if ( btn.IsWindowEnabled() )
        {
            btn.EnableWindow( FALSE );
        }
        btn.SetWindowText( L"Log in" );
        text.SetWindowText( L"status: login in progress..." );
        break;
    }
    case LoginStatus::logged_in:
    {
        if ( !btn.IsWindowEnabled() )
        {
            btn.EnableWindow( TRUE );
        }
        btn.SetWindowText( L"Log out" );
        text.SetWindowText( qwr::unicode::ToWide( fmt::format( "status: logged in as `{}`", getUserNameFn() ) ).c_str() );
        break;
    }
    default:
        break;
    }
}

} // namespace sptf::ui


================================================
FILE: foo_spotify/ui/ui_pref_tab_auth.h
================================================
#pragma once

#include <fb2k/config.h>
#include <ui/ui_ipref_tab.h>

#include <resource.h>

#include <qwr/fb2k_config_ui_option.h>
#include <qwr/macros.h>
#include <qwr/ui_ddx_option.h>

#include <thread>

namespace sptf::ui
{

class PreferenceTabManager;

class PreferenceTabAuth
    : public CDialogImpl<PreferenceTabAuth>
    , public IPrefTab
{
private:
    enum class LoginStatus
    {
        fetching_login_status,
        logged_out,
        login_in_progress,
        logged_in,
    };

public:
    enum
    {
        IDD = IDD_PREF_TAB_AUTH
    };

    PreferenceTabAuth( PreferenceTabManager* pParent );
    ~PreferenceTabAuth() override;

    // IPrefTab
    HWND CreateTab( HWND hParent ) override;
    CDialogImplBase& Dialog() override;
    const wchar_t* Name() const override;

    t_uint32 get_state() override;
    void apply() override;
    void reset() override;

protected:
    static constexpr int kOnWebApiLoginResponse = WM_USER + 1;
    static constexpr int kOnStatusUpdateFinish = WM_USER + 2;

    BEGIN_MSG_MAP( PreferenceTabAuth )
        MSG_WM_INITDIALOG( OnInitDialog )
        MSG_WM_DESTROY( OnDestroy )
        MSG_WM_CTLCOLORSTATIC( OnCtlColorStatic )
        COMMAND_HANDLER_EX( IDC_BTN_LOGIN_LIBSPOTIFY, BN_CLICKED, OnLibSpotifyLoginClick )
        COMMAND_HANDLER_EX( IDC_BTN_LOGIN_WEBAPI, BN_CLICKED, OnWebApiLoginClick )
        MESSAGE_HANDLER( kOnWebApiLoginResponse, OnWebApiLoginResponse )
        MESSAGE_HANDLER( kOnStatusUpdateFinish, OnStatusUpdateFinish )
    END_MSG_MAP()

private:
    BOOL OnInitDialog( HWND hwndFocus, LPARAM lParam );
    void OnDestroy();

    HBRUSH OnCtlColorStatic( CDCHandle dc, CStatic wndStatic );

    void OnDdxChange( UINT uNotifyCode, int nID, CWindow wndCtl );
    void OnLibSpotifyLoginClick( UINT uNotifyCode, int nID, CWindow wndCtl );
    void OnWebApiLoginClick( UINT uNotifyCode, int nID, CWindow wndCtl );
    LRESULT OnWebApiLoginResponse( UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL& bHandled );
    LRESULT OnStatusUpdateFinish( UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL& bHandled );

private:
    void UpdateUiFromCfg();
    void UpdateLibSpotifyUi();
    void UpdateWebApiUi();
    void UpdateBackendUi( LoginStatus loginStatus, CButton& btn, CStatic& text, std::function<std::string()> getUserNameFn );

private:
    PreferenceTabManager* pParent_ = nullptr;

    //qwr::ui::UiOption<decltype( config::preferred_bitrate )> preferred_bitrate_;
    std::array<std::unique_ptr<qwr::ui::IUiDdxOption>, 0> ddxOptions_;

    CButton btnLibSpotify_;
    CButton btnWebApi_;

    CStatic textLibSpotify_;
    CStatic textWebApi_;

    LoginStatus libSpotifyStatus_ = LoginStatus::fetching_login_status;
    LoginStatus webApiStatus_ = LoginStatus::fetching_login_status;

    std::unique_ptr<std::thread> pStatusThread_;
};

} // namespace sptf::ui


================================================
FILE: foo_spotify/ui/ui_pref_tab_manager.cpp
================================================
#include <stdafx.h>

#include "ui_pref_tab_manager.h"

#include <fb2k/config.h>
#include <ui/ui_pref_tab_auth.h>
#include <ui/ui_pref_tab_playback.h>

#include <component_urls.h>

namespace
{

using namespace sptf;

class preferences_page_impl
    : public preferences_page_v3
{
public:
    const char* get_name() override
    {
        return SPTF_NAME;
    }

    GUID get_guid() override
    {
        return guid::preferences;
    }

    GUID get_parent_guid() override
    {
        return preferences_page::guid_tools;
    }

    bool get_help_url( pfc::string_base& p_out ) override
    {
        p_out << qwr::unicode::ToU8( std::wstring_view( url::homepage ) );
        return true;
    }

    preferences_page_instance::ptr instantiate( HWND parent, preferences_page_callback::ptr callback ) override
    {
        auto p = ::fb2k::service_new<ui::PreferenceTabManager>( callback );
        p->Create( parent );
        return p;
    }
};

preferences_page_factory_t<preferences_page_impl> g_pref;

} // namespace

namespace sptf::ui
{

using namespace config;

PreferenceTabManager::PreferenceTabManager( preferences_page_callback::ptr callback )
    : callback_( callback )
    , tabs_( { std::make_unique<PreferenceTabAuth>( this ),
               std::make_unique<PreferenceTabPlayback>( this ) } )
{
}

void PreferenceTabManager::OnDataChanged()
{
    callback_->on_state_changed();
}

HWND PreferenceTabManager::get_wnd()
{
    return m_hWnd;
}

t_uint32 PreferenceTabManager::get_state()
{
    uint32_t state = preferences_state::resettable;
    for ( auto& tab: tabs_ )
    {
        state |= tab->get_state();
    }

    return state;
}

void PreferenceTabManager::apply()
{
    for ( auto& tab: tabs_ )
    {
        tab->apply();
    }

    OnDataChanged();
}

void PreferenceTabManager::reset()
{
    for ( auto& tab: tabs_ )
    {
        tab->reset();
    }

    OnDataChanged();
}

BOOL PreferenceTabManager::OnInitDialog( HWND hwndFocus, LPARAM lParam )
{
    cTabs_ = GetDlgItem( IDC_TAB_HOST );

    for ( const auto& [i, pTab]: ranges::views::enumerate( tabs_ ) )
    {
        cTabs_.InsertItem( i, pTab->Name() );
    }

    cTabs_.SetCurSel( activeTabIdx_ );
    CreateTab();

    return TRUE; // set focus to default control
}

void PreferenceTabManager::OnParentNotify( UINT message, UINT nChildID, LPARAM lParam )
{
    if ( WM_DESTROY == message && pcCurTab_ && reinterpret_cast<HWND>( lParam ) == static_cast<HWND>( *pcCurTab_ ) )
    {
        pcCurTab_ = nullptr;
    }
}

LRESULT PreferenceTabManager::OnSelectionChanged( LPNMHDR pNmhdr )
{
    activeTabIdx_ = TabCtrl_GetCurSel( GetDlgItem( IDC_TAB_HOST ) );
    CreateTab();

    return 0;
}

LRESULT PreferenceTabManager::OnWindowPosChanged( UINT, WPARAM, LPARAM lp, BOOL& bHandled )
{
    auto lpwp = reinterpret_cast<LPWINDOWPOS>( lp );
    // Temporary workaround for various bugs that occur due to foobar2000 1.0+
    // having a dislike for destroying preference pages
    if ( lpwp->flags & SWP_HIDEWINDOW )
    {
        DestroyTab();
    }
    else if ( lpwp->flags & SWP_SHOWWINDOW && !pcCurTab_ )
    {
        CreateTab();
    }

    bHandled = FALSE;

    return 0;
}

void PreferenceTabManager::CreateTab()
{
    DestroyTab();

    RECT tabRc;

    cTabs_.GetWindowRect( &tabRc );
    ::MapWindowPoints( HWND_DESKTOP, m_hWnd, (LPPOINT)&tabRc, 2 );

    cTabs_.AdjustRect( FALSE, &tabRc );

    if ( activeTabIdx_ >= tabs_.size() )
    {
        activeTabIdx_ = 0;
    }

    auto& pCurTab = tabs_[activeTabIdx_];
    pcCurTab_ = &pCurTab->Dialog();
    pCurTab->CreateTab( m_hWnd );

    EnableThemeDialogTexture( *pcCurTab_, ETDT_ENABLETAB );

    pcCurTab_->SetWindowPos( nullptr, tabRc.left, tabRc.top, tabRc.right - tabRc.left, tabRc.bottom - tabRc.top, SWP_NOZORDER );
    cTabs_.SetWindowPos( HWND_BOTTOM, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE );

    pcCurTab_->ShowWindow( SW_SHOWNORMAL );
}

void PreferenceTabManager::DestroyTab()
{
    if ( pcCurTab_ && *pcCurTab_ )
    {
        pcCurTab_->ShowWindow( SW_HIDE );
        pcCurTab_->DestroyWindow();
    }
}

} // namespace sptf::ui


================================================
FILE: foo_spotify/ui/ui_pref_tab_manager.h
================================================
#pragma once

#include <ui/ui_ipref_tab.h>

#include <resource.h>

#include <array>

namespace sptf::ui
{

class PreferenceTabMain;

class PreferenceTabManager
    : public CDialogImpl<PreferenceTabManager>
    , public CWinDataExchange<PreferenceTabManager>
    , public preferences_page_instance
{
public:
    enum
    {
        IDD = IDD_PREF_TAB_HOST
    };

    BEGIN_MSG_MAP( PreferenceTabManager )
        MSG_WM_INITDIALOG( OnInitDialog )
        MSG_WM_PARENTNOTIFY( OnParentNotify )
        MESSAGE_HANDLER( WM_WINDOWPOSCHANGED, OnWindowPosChanged )
        NOTIFY_HANDLER_EX( IDC_TAB_HOST, TCN_SELCHANGE, OnSelectionChanged )
    END_MSG_MAP()

public:
    PreferenceTabManager( preferences_page_callback::ptr callback );

    void OnDataChanged();

    // preferences_page_instance
    HWND get_wnd() override;
    t_uint32 get_state() override;
    void apply() override;
    void reset() override;

private:
    BOOL OnInitDialog( HWND hwndFocus, LPARAM lParam );
    void OnParentNotify( UINT message, UINT nChildID, LPARAM lParam );
    LRESULT OnWindowPosChanged( UINT, WPARAM, LPARAM lp, BOOL& bHandled );
    LRESULT OnSelectionChanged( LPNMHDR pNmhdr );

    void CreateTab();
    void DestroyTab();

private:
    preferences_page_callback::ptr callback_;

    CTabCtrl cTabs_;
    CDialogImplBase* pcCurTab_ = nullptr;

    size_t activeTabIdx_ = 0;
    std::array<std::unique_ptr<IPrefTab>, 2> tabs_;
};

} // namespace sptf::ui


================================================
FILE: foo_spotify/ui/ui_pref_tab_playback.cpp
================================================
#include <stdafx.h>

#include "ui_pref_tab_playback.h"

#include <backend/libspotify_backend.h>
#include <backend/spotify_instance.h>
#include <backend/webapi_auth.h>
#include <backend/webapi_auth_scopes.h>
#include <backend/webapi_backend.h>
#include <backend/webapi_objects/webapi_user.h>
#include <fb2k/config.h>
#include <ui/ui_pref_tab_manager.h>

#include <component_urls.h>

#include <qwr/abort_callback.h>
#include <qwr/error_popup.h>
#include <qwr/final_action.h>
#include <qwr/string_helpers.h>

namespace
{

int GetNearestScrollPos( float curValue, int direction )
{
    if ( auto curShift = curValue - std::floor( curValue );
         !curShift )
    {
        return (int)( curValue + direction );
    }
    else
    {
        if ( direction < 0 )
        {
            return (int)std::floor( curValue );
        }
        else if ( direction > 0 )
        {
            return (int)std::ceil( curValue );
        }
        else
        {
            return (int)std::round( curValue );
        }
    }
}

} // namespace

namespace sptf::ui
{

PreferenceTabPlayback::PreferenceTabPlayback( PreferenceTabManager* pParent )
    : pParent_( pParent )
    , trackToEdit_( { { IDC_SLIDER_CACHE_PERCENT, IDC_EDIT_CACHE_PERCENT },
                      { IDC_SLIDER_CACHE_MB, IDC_EDIT_CACHE_MB } } )
    , editToTrack_( { { IDC_EDIT_CACHE_PERCENT, IDC_SLIDER_CACHE_PERCENT },
                      { IDC_EDIT_CACHE_MB, IDC_SLIDER_CACHE_MB } } )
    , enable_normalization_( config::enable_normalization )
    , enable_private_mode_( config::enable_private_mode )
    , libspotify_cache_size_in_percent_( config::libspotify_cache_size_in_percent )
    , libspotify_cache_size_in_mb_( config::libspotify_cache_size_in_mb )
    , preferred_bitrate_(
          config::preferred_bitrate,
          { { config::BitrateSettings::Bitrate96k, 0 },
            { config::BitrateSettings::Bitrate160k, 1 },
            { config::BitrateSettings::Bitrate320k, 2 } } )
    , ddxOptions_(
          { qwr::ui::CreateUiDdxOption<qwr::ui::UiDdx_CheckBox>( enable_normalization_, IDC_CHECK_NORMALIZE ),
            qwr::ui::CreateUiDdxOption<qwr::ui::UiDdx_CheckBox>( enable_private_mode_, IDC_CHECK_PRIVATE ),
            qwr::ui::CreateUiDdxOption<qwr::ui::UiDdx_TrackBar>( libspotify_cache_size_in_percent_, IDC_SLIDER_CACHE_PERCENT ),
            qwr::ui::CreateUiDdxOption<qwr::ui::UiDdx_TrackBar>( libspotify_cache_size_in_mb_, IDC_SLIDER_CACHE_MB ),
            qwr::ui::CreateUiDdxOption<qwr::ui::UiDdx_ComboBox>( preferred_bitrate_, IDC_COMBO_BITRATE ) } )
{
}

PreferenceTabPlayback::~PreferenceTabPlayback()
{
    for ( auto& ddxOpt: ddxOptions_ )
    {
        ddxOpt->Option().Revert();
    }
}

HWND PreferenceTabPlayback::CreateTab( HWND hParent )
{
    return Create( hParent );
}

CDialogImplBase& PreferenceTabPlayback::Dialog()
{
    return *this;
}

const wchar_t* PreferenceTabPlayback::Name() const
{
    return L"Playback";
}

t_uint32 PreferenceTabPlayback::get_state()
{
    const bool hasChanged =
        ddxOptions_.cend() != std::find_if( ddxOptions_.cbegin(), ddxOptions_.cend(), []( const auto& ddxOpt ) {
            return ddxOpt->Option().HasChanged();
        } );

    return ( preferences_state::resettable | ( hasChanged ? preferences_state::changed : 0 ) );
}

void PreferenceTabPlayback::apply()
{
    for ( auto& ddxOpt: ddxOptions_ )
    {
        ddxOpt->Option().Apply();
    }

    RefreshLibSpotifySettings();

    pParent_->OnDataChanged();
}

void PreferenceTabPlayback::reset()
{
    for ( auto& ddxOpt: ddxOptions_ )
    {
        ddxOpt->Option().ResetToDefault();
    }
    DoFullDdxToUi();

    pParent_->OnDataChanged();
}

BOOL PreferenceTabPlayback::OnInitDialog( HWND hwndFocus, LPARAM lParam )
{
    CComboBox comboBitrate( GetDlgItem( IDC_COMBO_BITRATE ) );
    comboBitrate.AddString( L"96 kbit/s" );
    comboBitrate.AddString( L"160 kbit/s" );
    comboBitrate.AddString( L"320 kbit/s" );

    CTrackBarCtrl trackCacheMb( GetDlgItem( IDC_SLIDER_CACHE_MB ) );
    trackCacheMb.SetRangeMin( 0 );
    trackCacheMb.SetRangeMax( 8192 );
    trackCacheMb.SetTicFreq( 512 );

    CTrackBarCtrl trackCachePercent( GetDlgItem( IDC_SLIDER_CACHE_PERCENT ) );
    trackCachePercent.SetRangeMin( 0 );
    trackCachePercent.SetRangeMax( 100 );
    trackCachePercent.SetTicFreq( 5 );

    for ( auto& ddxOpt: ddxOptions_ )
    {
        ddxOpt->Ddx().SetHwnd( m_hWnd );
    }
    DoFullDdxToUi();

    this->SetDlgItemInt( IDC_EDIT_CACHE_MB, libspotify_cache_size_in_mb_, false );
    this->SetDlgItemInt( IDC_EDIT_CACHE_PERCENT, libspotify_cache_size_in_percent_, false );

    suppressUiDdx_ = false;

    return TRUE; // set focus to default control
}

void PreferenceTabPlayback::OnDdxUiChange( UINT uNotifyCode, int nID, CWindow wndCtl )
{
    if ( suppressUiDdx_ )
    {
        return;
    }

    auto it = std::find_if( ddxOptions_.begin(), ddxOptions_.end(), [nID]( auto& val ) {
        return val->Ddx().IsMatchingId( nID );
    } );

    if ( ddxOptions_.end() != it )
    {
        ( *it )->Ddx().ReadFromUi();
        pParent_->OnDataChanged();
    }
}

void PreferenceTabPlayback::OnDdxValueChange( int nID )
{
    // avoid triggering loopback ddx
    suppressUiDdx_ = true;
    const qwr::final_action autoSuppress( [&] { suppressUiDdx_ = false; } );

    auto it = std::find_if( ddxOptions_.begin(), ddxOptions_.end(), [nID]( auto& val ) {
        return val->Ddx().IsMatchingId( nID );
    } );

    assert( ddxOptions_.end() != it );
    ( *it )->Ddx().WriteToUi();
}

LRESULT PreferenceTabPlayback::OnTrackBarPosChangedNotify( LPNMHDR pnmh )
{
    auto pNMTR = reinterpret_cast<NMTRBTHUMBPOSCHANGING*>( pnmh );
    if ( pNMTR->nReason == TB_ENDTRACK )
    {
        return 1;
    }

    if ( suppressUiDdx_ )
    {
        return 1;
    }

    const auto id = pNMTR->hdr.idFrom;

    CTrackBarCtrl trackBar( GetDlgItem( id ) );
    const auto tickCount = trackBar.GetNumTics() - 1;
    const auto rangeMin = trackBar.GetRangeMin();
    const auto rangeMax = trackBar.GetRangeMax();
    const auto tickFreq = ( rangeMax - rangeMin ) / tickCount;
    const auto prevPos = trackBar.GetPos();
    const auto pos = pNMTR->dwPos;

    auto adjustedPos = [&] {
        const auto ticks = (float)pos / tickFreq;
        const auto diffSign = ( (int)pos - (int)prevPos < 0 ? -1 : 1 );
        switch ( pNMTR->nReason )
        {
        case TB_PAGEUP:
        case TB_PAGEDOWN:
        {
            const auto diffTicks = std::abs( (int)pos - (int)prevPos ) / (int)tickFreq;
            return ( GetNearestScrollPos( ticks, diffSign ) + diffSign * diffTicks ) * (int)tickFreq;
        }
        case TB_LINEUP:
        case TB_LINEDOWN:
        {
            return GetNearestScrollPos( ticks, diffSign ) * (int)tickFreq;
        }
        case TB_THUMBTRACK:
        case TB_THUMBPOSITION:
        { // snap to the closest
            return GetNearestScrollPos( ticks, 0 ) * (int)tickFreq;
        }
        default:
        {
            return (int)pos;
        }
        }
    }();
    adjustedPos = std::clamp( adjustedPos, rangeMin, rangeMax );

    tracksRedrawing_.emplace( id );
    trackBar.SetPos( adjustedPos );
    OnDdxUiChange( 0, id, nullptr );

    // avoid triggering ddx for linked edit
    suppressUiDdx_ = true;
    const qwr::final_action autoSuppress( [&] { suppressUiDdx_ = false; } );

    this->SetDlgItemInt( trackToEdit_.at( id ), adjustedPos, false );

    return 1;
}

void PreferenceTabPlayback::OnTrackBarHScroll( UINT nSBCode, UINT nPos, CTrackBarCtrl trackBar )
{
    if ( nSBCode == TB_ENDTRACK )
    {
        return;
    }

    const auto trackId = trackBar.GetDlgCtrlID();
    if ( tracksRedrawing_.count( trackId ) )
    {
        tracksRedrawing_.erase( trackId );
        return;
    }

    // some events are not processed by TRBN_THUMBPOSCHANGING

    const auto pos = trackBar.GetPos();
    OnDdxUiChange( 0, trackId, nullptr );

    // avoid triggering ddx for linked edit
    suppressUiDdx_ = true;
    const qwr::final_action autoSuppress( [&] { suppressUiDdx_ = false; } );

    this->SetDlgItemInt( trackToEdit_.at( trackId ), pos, false );
}

void PreferenceTabPlayback::OnTrackBarEdit( UINT uNotifyCode, int nID, CWindow wndCtl )
{
    if ( suppressUiDdx_ )
    {
        return;
    }

    BOOL lpTrans;
    const auto editPosRaw = this->GetDlgItemInt( nID, &lpTrans, false );
    if ( !lpTrans )
    {
        return;
    }

    const auto trackId = editToTrack_.at( nID );
    CTrackBarCtrl trackbar( GetDlgItem( trackId ) );
    const auto editPos = std::clamp<int>( editPosRaw, trackbar.GetRangeMin(), trackbar.GetRangeMax() );
    if ( editPos != editPosRaw )
    {
        this->SetDlgItemInt( nID, editPos, false );
    }

    if ( trackbar.GetPos() == editPos )
    {
        return;
    }

    switch ( trackId )
    {
    case IDC_SLIDER_CACHE_MB:
        libspotify_cache_size_in_mb_ = editPos;
        break;
    case IDC_SLIDER_CACHE_PERCENT:
        libspotify_cache_size_in_percent_ = editPos;
        break;
    default:
        assert( false );
        break;
    }

    OnDdxValueChange( trackId );
}

void PreferenceTabPlayback::DoFullDdxToUi()
{
    if ( !this->m_hWnd )
    {
        return;
    }

    for ( auto& ddxOpt: ddxOptions_ )
    {
        ddxOpt->Ddx().WriteToUi();
    }
}

void PreferenceTabPlayback::RefreshLibSpotifySettings()
{
    auto& lsBackend = SpotifyInstance::Get().GetLibSpotify_Backend();
    lsBackend.RefreshBitrate();
    lsBackend.RefreshNormalization();
    lsBackend.RefreshPrivateMode();
    lsBackend.RefreshCacheSize();
}

} // namespace sptf::ui


================================================
FILE: foo_spotify/ui/ui_pref_tab_playback.h
================================================
#pragma once

#include <fb2k/config.h>
#include <ui/ui_ipref_tab.h>

#include <resource.h>

#include <qwr/fb2k_config_ui_option.h>
#include <qwr/macros.h>
#include <qwr/ui_ddx_option.h>

#include <thread>
#include <unordered_map>
#include <unordered_set>

namespace sptf::ui
{

class PreferenceTabManager;

class PreferenceTabPlayback
    : public CDialogImpl<PreferenceTabPlayback>
    , public IPrefTab
{
public:
    enum
    {
        IDD = IDD_PREF_TAB_PLAYBACK
    };

    PreferenceTabPlayback( PreferenceTabManager* pParent );
    ~PreferenceTabPlayback() override;

    // IPrefTab
    HWND CreateTab( HWND hParent ) override;
    CDialogImplBase& Dialog() override;
    const wchar_t* Name() const override;

    t_uint32 get_state() override;
    void apply() override;
    void reset() override;

protected:
    BEGIN_MSG_MAP( PreferenceTabPlayback )
        MSG_WM_INITDIALOG( OnInitDialog )
        MSG_WM_HSCROLL( OnTrackBarHScroll )
        COMMAND_HANDLER_EX( IDC_COMBO_BITRATE, CBN_SELCHANGE, OnDdxUiChange )
        COMMAND_HANDLER_EX( IDC_CHECK_NORMALIZE, BN_CLICKED, OnDdxUiChange )
        COMMAND_HANDLER_EX( IDC_CHECK_PRIVATE, BN_CLICKED, OnDdxUiChange )
        NOTIFY_HANDLER_EX( IDC_SLIDER_CACHE_MB, TRBN_THUMBPOSCHANGING, OnTrackBarPosChangedNotify )
        NOTIFY_HANDLER_EX( IDC_SLIDER_CACHE_PERCENT, TRBN_THUMBPOSCHANGING, OnTrackBarPosChangedNotify )
        COMMAND_HANDLER_EX( IDC_EDIT_CACHE_MB, EN_CHANGE, OnTrackBarEdit )
        COMMAND_HANDLER_EX( IDC_EDIT_CACHE_PERCENT, EN_CHANGE, OnTrackBarEdit )
    END_MSG_MAP()

private:
    BOOL OnInitDialog( HWND hwndFocus, LPARAM lParam );

    void OnDdxUiChange( UINT uNotifyCode, int nID, CWindow wndCtl );
    void OnDdxValueChange( int nID );

    LRESULT OnTrackBarPosChangedNotify( LPNMHDR pnmh );
    void OnTrackBarHScroll( UINT nSBCode, UINT nPos, CTrackBarCtrl trackBar );
    void OnTrackBarEdit( UINT uNotifyCode, int nID, CWindow wndCtl );

    void DoFullDdxToUi();

    void RefreshLibSpotifySettings();

private:
    PreferenceTabManager* pParent_ = nullptr;

    std::unordered_map<int, int> trackToEdit_;
    std::unordered_map<int, int> editToTrack_;
    std::unordered_set<int> tracksRedrawing_;

    bool suppressUiDdx_ = true;

#define SPTF_DEFINE_UI_OPTION( name ) \
    qwr::ui::UiOption<decltype( config::name )> name##_;

#define SPTF_DEFINE_UI_OPTIONS( ... ) \
    QWR_EXPAND( QWR_PASTE( SPTF_DEFINE_UI_OPTION, __VA_ARGS__ ) )

    SPTF_DEFINE_UI_OPTIONS( enable_normalization,
                            enable_private_mode,
                            libspotify_cache_size_in_percent,
                            libspotify_cache_size_in_mb,
                            preferred_bitrate )

#undef SPTF_DEFINE_OPTIONS
#undef SPTF_DEFINE_OPTION

    std::array<std::unique_ptr<qwr::ui::IUiDdxOption>, 5> ddxOptions_;
};

} // namespace sptf::ui


================================================
FILE: foo_spotify/utils/abort_manager.cpp
================================================
#include <stdafx.h>

#include "abort_manager.h"

#include <qwr/thread_helpers.h>

namespace sptf
{

AbortManager::AbortManager()
{
    StartThread();
}

void AbortManager::Finalize()
{
    StopThread();
}

void AbortManager::RemoveTask( uint32_t taskId )
{
    std::unique_lock lock( mutex_ );

    const auto itTask = idToTask_.find( taskId );
    assert( itTask != idToTask_.cend() );
    const auto pAbort = itTask->second.pAbort;
    idToTask_.erase( itTask );

    const auto itIds = abortToIds_.find( pAbort );
    assert( itIds != abortToIds_.cend() );
    auto& ids = itIds->second;

    const auto itId = std::find( ids.rbegin(), ids.rend(), taskId );
    assert( itId != ids.rend() );

    ids.erase( std::next( itId ).base() );
    if ( ids.empty() )
    {
        abortToIds_.erase( itIds );
    }

    assert( abortToIds_.size() <= idToTask_.size() );
}

void AbortManager::StartThread()
{
    pThread_ = std::make_unique<std::thread>( &AbortManager::EventLoop, this );
    qwr::SetThreadName( *pThread_, "SPTF Abort Handler" );
}

void AbortManager::StopThread()
{
    if ( !pThread_ )
    {
        return;
    }

    {
        std::unique_lock lock( mutex_ );
        isTimeToDie_ = true;
    }
    eventCv_.notify_all();

    if ( pThread_->joinable() )
    {
        pThread_->join();
    }

    pThread_.reset();
}

void AbortManager::EventLoop()
{
    while ( true )
    {
        std::unique_lock lock( mutex_ );

        do
        {
            eventCv_.wait_for( lock, std::chrono::seconds( 2 ) );
        } while ( !isTimeToDie_ && abortToIds_.empty() );

        if ( isTimeToDie_ )
        {
            for ( auto& [id, task]: idToTask_ )
            {
                std::invoke( *( task.task ) );
            }
            return;
        }

        for ( const auto& [pAbort, ids]: abortToIds_ )
        {
            if ( pAbort->is_aborting() )
            {
                for ( const auto& id: ranges::views::reverse( ids ) )
                {
                    assert( idToTask_.count( id ) );
                    std::invoke( *( idToTask_[id].task ) );
                }
            }
        }
    }
}

AbortManager::AbortableScope::AbortableScope( size_t taskId, AbortManager& parent )
    : parent_( parent )
    , taskId_( taskId )
{
}

AbortManager::AbortableScope::AbortableScope( AbortableScope&& other )
    : parent_( other.parent_ )
    , isValid_( other.isValid_ )
    , taskId_( other.taskId_ )
{
    other.isValid_ = false;
}

AbortManager::AbortableScope::~AbortableScope()
{
    if ( isValid_ )
    {
        parent_.RemoveTask( taskId_ );
    }
}

} // namespace sptf


================================================
FILE: foo_spotify/utils/abort_manager.h
================================================
#pragma once

#include <condition_variable>
#include <functional>
#include <mutex>

namespace sptf
{

class AbortManager
{
private:
    using Task = std::function<void()>;

    struct AbortableTask
    {
        std::unique_ptr<Task> task;
        abort_callback* pAbort;
    };

public:
    class AbortableScope
    {
        friend class AbortManager;

    public:
        AbortableScope( AbortableScope&& other );
        ~AbortableScope();

    private:
        AbortableScope( size_t taskId, AbortManager& parent );

    private:
        AbortManager& parent_;
        bool isValid_ = true;
        size_t taskId_;
    };

public:
    AbortManager();
    AbortManager( const AbortManager& other ) = delete;
    AbortManager( AbortManager&& other ) = delete;
    ~AbortManager() = default;

    void Finalize();

    template <typename T>
    AbortableScope GetAbortableScope( T&& task, abort_callback& abort )
    {
        return AbortableScope( AddTask( std::forward<T>( task ), abort ), *this );
    }

private:
    void StartThread();
    void StopThread();

    void EventLoop();

    template <typename T>
    size_t AddTask( T&& task, abort_callback& abort )
    {
        static_assert( std::is_invocable_v<T> );
        static_assert( std::is_move_constructible_v<T> || std::is_copy_constructible_v<T> );

        const auto taskId = [&] {
            std::unique_lock lock( mutex_ );

            const auto taskId = [&] {
                auto id = idCounter_;
                while ( idToTask_.count( id ) )
                {
                    id = ++idCounter_;
                }
                return id;
            }();

            if constexpr ( !std::is_copy_constructible_v<T> && std::is_move_constructible_v<T> )
            {
                auto taskLambda = [taskWrapper = std::make_shared<T>( std::forward<T>( task ) )] {
                    std::invoke( *taskWrapper );
                };
                idToTask_.try_emplace( taskId, AbortableTask{ std::make_unique<Task>( taskLambda ), &abort } );
            }
            else
            {
                idToTask_.try_emplace( taskId, AbortableTask{ std::make_unique<Task>( std::forward<T>( task ) ), &abort } );
            }

            return abortToIds_[&abort].emplace_back( taskId );
        }();

        eventCv_.notify_all();

        return taskId;
    }

    void RemoveTask( uint32_t taskId );

private:
    std::unique_ptr<std::thread> pThread_;

    std::mutex mutex_;
    std::condition_variable eventCv_;
    bool isTimeToDie_ = false;

    size_t idCounter_ = 0;
    std::unordered_map<size_t, AbortableTask> idToTask_;
    std::unordered_map<abort_callback*, std::vector<size_t>> abortToIds_;
};

} // namespace sptf


================================================
FILE: foo_spotify/utils/async_mutex.hpp
================================================
///////////////////////////////////////////////////////////////////////////////
// Copyright (c) Lewis Baker
// Licenced under MIT license. See LICENSE.txt for details.
///////////////////////////////////////////////////////////////////////////////
#ifndef CPPCORO_ASYNC_MUTEX_HPP_INCLUDED
#define CPPCORO_ASYNC_MUTEX_HPP_INCLUDED

#include <atomic>
#include <cstdint>
#include <mutex> // for std::adopt_lock_t

#include <experimental/coroutine>

namespace cppcoro
{
class async_mutex_lock;
class async_mutex_lock_operation;
class async_mutex_scoped_lock_operation;

/// \brief
/// A mutex that can be locked asynchronously using 'co_await'.
///
/// Ownership of the mutex is not tied to any particular thread.
/// This allows the coroutine owning the lock to transition from
/// one thread to another while holding a lock.
///
/// Implementation is lock-free, using only std::atomic values for
/// synchronisation. Awaiting coroutines are suspended without blocking
/// the current thread if the lock could not be acquired synchronously.
class async_mutex
{
public:
    /// \brief
    /// Construct to a mutex that is not currently locked.
    async_mutex() noexcept;

    /// Destroys the mutex.
    ///
    /// Behaviour is undefined if there are any outstanding coroutines
    /// still waiting to acquire the lock.
    ~async_mutex();

    /// \brief
    /// Attempt to acquire a lock on the mutex without blocking.
    ///
    /// \return
    /// true if the lock was acquired, false if the mutex was already locked.
    /// The caller is responsible for ensuring unlock() is called on the mutex
    /// to release the lock if the lock was acquired by this call.
    bool try_lock() noexcept;

    /// \brief
    /// Acquire a lock on the mutex asynchronously.
    ///
    /// If the lock could not be acquired synchronously then the awaiting
    /// coroutine will be suspended and later resumed when the lock becomes
    /// available. If suspended, the coroutine will be resumed inside the
    /// call to unlock() from the previous lock owner.
    ///
    /// \return
    /// An operation object that must be 'co_await'ed to wait until the
    /// lock is acquired. The result of the 'co_await m.lock_async()'
    /// expression has type 'void'.
    async_mutex_lock_operation lock_async() noexcept;

    /// \brief
    /// Acquire a lock on the mutex asynchronously, returning an object that
    /// will call unlock() automatically when it goes out of scope.
    ///
    /// If the lock could not be acquired synchronously then the awaiting
    /// coroutine will be suspended and later resumed when the lock becomes
    /// available. If suspended, the coroutine will be resumed inside the
    /// call to unlock() from the previous lock owner.
    ///
    /// \return
    /// An operation object that must be 'co_await'ed to wait until the
    /// lock is acquired. The result of the 'co_await m.scoped_lock_async()'
    /// expression returns an 'async_mutex_lock' object that will call
    /// this->mutex() when it destructs.
    async_mutex_scoped_lock_operation scoped_lock_async() noexcept;

    /// \brief
    /// Unlock the mutex.
    ///
    /// Must only be called by the current lock-holder.
    ///
    /// If there are lock operations waiting to acquire the
    /// mutex then the next lock operation in the queue will
    /// be resumed inside this call.
    void unlock();

private:
    friend class async_mutex_lock_operation;

    static constexpr std::uintptr_t not_locked = 1;

    // assume == reinterpret_cast<std::uintptr_t>(static_cast<void*>(nullptr))
    static constexpr std::uintptr_t locked_no_waiters = 0;

    // This field provides synchronisation for the mutex.
    //
    // It can have three kinds of values:
    // - not_locked
    // - locked_no_waiters
    // - a pointer to the head of a singly linked list of recently
    //   queued async_mutex_lock_operation objects. This list is
    //   in most-recently-queued order as new items are pushed onto
    //   the front of the list.
    std::atomic<std::uintptr_t> m_state;

    // Linked list of async lock operations that are waiting to acquire
    // the mutex. These operations will acquire the lock in the order
    // they appear in this list. Waiters in this list will acquire the
    // mutex before waiters added to the m_newWaiters list.
    async_mutex_lock_operation* m_waiters;
};

/// \brief
/// An object that holds onto a mutex lock for its lifetime and
/// ensures that the mutex is unlocked when it is destructed.
///
/// It is equivalent to a std::lock_guard object but requires
/// that the result of co_await async_mutex::lock_async() is
/// passed to the constructor rather than passing the async_mutex
/// object itself.
class async_mutex_lock
{
public:
    explicit async_mutex_lock( async_mutex& mutex, std::adopt_lock_t ) noexcept
        : m_mutex( &mutex )
    {
    }

    async_mutex_lock( async_mutex_lock&& other ) noexcept
        : m_mutex( other.m_mutex )
    {
        other.m_mutex = nullptr;
    }

    async_mutex_lock( const async_mutex_lock& other ) = delete;
    async_mutex_lock& operator=( const async_mutex_lock& other ) = delete;

    // Releases the lock.
    ~async_mutex_lock()
    {
        if ( m_mutex != nullptr )
        {
            m_mutex->unlock();
        }
    }

private:
    async_mutex* m_mutex;
};

class async_mutex_lock_operation
{
public:
    explicit async_mutex_lock_operation( async_mutex& mutex ) noexcept
        : m_mutex( mutex )
    {
    }

    bool await_ready() const noexcept
    {
        return false;
    }
    bool await_suspend( std::experimental::coroutine_handle<> awaiter ) noexcept;
    void await_resume() const noexcept
    {
    }

protected:
    friend class async_mutex;

    async_mutex& m_mutex;

private:
    async_mutex_lock_operation* m_next;
    std::experimental::coroutine_handle<> m_awaiter;
};

class async_mutex_scoped_lock_operation : public async_mutex_lock_operation
{
public:
    using async_mutex_lock_operation::async_mutex_lock_operation;

    [[nodiscard]] async_mutex_lock await_resume() const noexcept
    {
        return async_mutex_lock{ m_mutex, std::adopt_lock };
    }
};
} // namespace cppcoro

#endif


================================================
FILE: foo_spotify/utils/cred_prompt.cpp
================================================
#include <stdafx.h>

#include "cred_prompt.h"

#include <Ntsecapi.h>
#include <WinCred.h>

namespace sptf
{

std::unique_ptr<CredentialsResult> ShowCredentialsDialog( HWND hWnd, const char* msg )
{
    const auto wMsg = [msg]
    {
        if (msg)
        {
            auto ret = qwr::unicode::ToWide( std::string_view{ msg } );
            if ( ret.size() > CREDUI_MAX_MESSAGE_LENGTH )
            {
                ret.resize( CREDUI_MAX_MESSAGE_LENGTH );
                ret[CREDUI_MAX_MESSAGE_LENGTH - 3] = L'.';
                ret[CREDUI_MAX_MESSAGE_LENGTH - 2] = L'.';
                ret[CREDUI_MAX_MESSAGE_LENGTH - 1] = L'.';
            }
            return ret;
        }
        else
        {
            return std::wstring( L"Please enter your Spotify username and password." );
        }
    }();

    CREDUI_INFOW cui{};
    cui.cbSize = sizeof( CREDUI_INFO );
    cui.hwndParent = hWnd;
    //  Ensure that MessageText and CaptionText identify what credentials
    //  to use and which application requires them.
    cui.pszMessageText = wMsg.c_str();
    cui.pszCaptionText = L"Sign in to Spotify";
    BOOL fSave = FALSE;

    SecureVector<wchar_t> pszName( CREDUI_MAX_USERNAME_LENGTH + 1 );
    SecureVector<wchar_t> pszPwd( CREDUI_MAX_PASSWORD_LENGTH + 1 );

    const DWORD dwErr = CredUIPromptForCredentialsW(
        &cui,                              // CREDUI_INFO structure
        TEXT( SPTF_UNDERSCORE_NAME ),      // Target for credentials
        nullptr,                           // Reserved
        0,                                 // Reason
        pszName.data(),                    // User name
        pszName.size(),                    // Max number of char for user name
        pszPwd.data(),                     // Password
        pszPwd.size(),                     // Max number of char for password
        &fSave,                            // State of save check box
        CREDUI_FLAGS_GENERIC_CREDENTIALS | // flags
            CREDUI_FLAGS_ALWAYS_SHOW_UI | CREDUI_FLAGS_DO_NOT_PERSIST );

    auto cpr = std::make_unique<CredentialsResult>();
    if ( dwErr == NO_ERROR )
    {
        const auto wtou = []( const auto& in, auto& out ) {
            size_t stringLen = WideCharToMultiByte( CP_UTF8, 0, in.data(), in.size(), nullptr, 0, nullptr, nullptr );
            out.resize( stringLen );

            stringLen = WideCharToMultiByte( CP_UTF8, 0, in.data(), in.size(), out.data(), out.size(), nullptr, nullptr );
            out.resize( stringLen );
        };

        wtou( pszName, cpr->un );
        wtou( pszPwd, cpr->pw );
    }
    else if ( dwErr == ERROR_CANCELLED )
    {
        cpr->cancelled = true;
    }
    return cpr;
}

} // namespace sptf


================================================
FILE: foo_spotify/utils/cred_prompt.h
================================================
#pragma once

#include <utils/secure_vector.h>

namespace sptf
{

struct CredentialsResult
{
    SecureVector<char> un;
    SecureVector<char> pw;
    bool cancelled = false;
};

std::unique_ptr<CredentialsResult> ShowCredentialsDialog( HWND hWnd, const char* msg );

} // namespace sptf


================================================
FILE: foo_spotify/utils/json_macro_fix.h
================================================
#pragma once

// same as the stock one, but without `inline`
#define SPTF_NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE( Type, ... )                           \
    void to_json( nlohmann::json& nlohmann_json_j, const Type& nlohmann_json_t )       \
    {                                                                                  \
        NLOHMANN_JSON_EXPAND( NLOHMANN_JSON_PASTE( NLOHMANN_JSON_TO, __VA_ARGS__ ) )   \
    }                                                                                  \
    void from_json( const nlohmann::json& nlohmann_json_j, Type& nlohmann_json_t )     \
    {                                                                                  \
        NLOHMANN_JSON_EXPAND( NLOHMANN_JSON_PASTE( NLOHMANN_JSON_FROM, __VA_ARGS__ ) ) \
    }


================================================
FILE: foo_spotify/utils/json_std_extenders.h
================================================
#include <memory>

namespace nlohmann
{
template <typename T>
struct adl_serializer<std::unique_ptr<T>>
{
    static void to_json( nlohmann::json& j, const std::unique_ptr<T>& value )
    {
        if ( !value )
        {
            throw nlohmann::json::type_error::create( 302, "type must not be null, but is" );
        }

        j = *value;
    }

    static void from_json( const nlohmann::json& j, std::unique_ptr<T>& p )
    {
        if ( j.is_null() )
        {
            throw nlohmann::json::type_error::create( 302, "type must not be null, but is" );
        }

        p = std::make_unique<T>( j.get<T>() );
    }
};

template <typename T>
struct adl_serializer<std::shared_ptr<T>>
{
    static void to_json( nlohmann::json& j, const std::shared_ptr<T>& value )
    {
        if ( !value )
        {
            throw nlohmann::json::type_error::create( 302, "type must not be null, but is" );
        }

        j = *value;
    }

    static void from_json( const nlohmann::json& j, std::shared_ptr<T>& p )
    {
        if ( j.is_null() )
        {
            throw nlohmann::json::type_error::create( 302, "type must not be null, but is" );
        }

        p = std::make_shared<T>( j.get<T>() );
    }
};

template <typename T>
struct adl_serializer<std::optional<T>>
{
    static void to_json( nlohmann::json& j, const std::optional<T>& value )
    {
        if ( !value )
        {
            j = nlohmann::json();
        }
        else
        {
            j = *value;
        }
    }

    static void from_json( const nlohmann::json& j, std::optional<T>& p )
    {
        if ( j.is_null() )
        {
            p = std::nullopt;
        }
        else
        {
            p = j.get<T>();
        }
    }
};

template <>
struct adl_serializer<std::wstring>
{
    static void to_json( json& j, const std::wstring& value )
    {
        j = qwr::unicode::ToU8( value );
    }

    static void from_json( const json& j, std::wstring& value )
    {
        value = qwr::unicode::ToWide( j.get<std::string>() );
    }
};

} // namespace nlohmann


================================================
FILE: foo_spotify/utils/rps_limiter.cpp
================================================

#include <stdafx.h>

#include "rps_limiter.h"

#include <backend/spotify_instance.h>
#include <fb2k/advanced_config.h>
#include <utils/abort_manager.h>
#include <utils/sleeper.h>

#include <qwr/final_action.h>

namespace
{

std::chrono::milliseconds GetTimestampInMs()
{
    return std::chrono::time_point_cast<std::chrono::milliseconds>( std::chrono::system_clock::now() ).time_since_epoch();
}

} // namespace

namespace sptf
{

RpsLimiter::RpsLimiter( size_t limit, std::chrono::seconds limitPeriod )
    : shouldLogWebApiDebug_( config::advanced::logging_webapi_debug )
    , limitPeriod_( limitPeriod )
    , limitCount_( limit )
    , timeStampsContainer_( limit, GetTimestampInMs() - 2 * limitPeriod )
    , timeStamps_( timeStampsContainer_.begin(), timeStampsContainer_.end(), timeStampsContainer_.begin(), timeStampsContainer_.size() )
{
}

void RpsLimiter::WaitForRequestAvailability( abort_callback& abort )
{
    if ( abort.is_aborting() )
    {
        return;
    }

    std::atomic_bool timeToDie = false;
    auto& am = SpotifyInstance::Get().GetAbortManager();
    const auto abortableScope = am.GetAbortableScope( [&] {
        timeToDie = true;
        cv_.notify_all();
    },
                                                      abort );

    std::unique_lock lock( mutex_ );

    const auto nowInMs = GetTimestampInMs();
    auto nextAvailableTime = timeStamps_.front() + limitPeriod_;
    if ( incomingRequests_.empty() && nowInMs >= nextAvailableTime )
    {
        timeStamps_.emplace_back( nowInMs );
        return;
    }

    auto waitTime = nextAvailableTime - nowInMs;

    const auto requestIdx = curRequestIdx_++;
    incomingRequests_.emplace_back( requestIdx );
    const auto curIt = std::prev( incomingRequests_.end() );
    const qwr::final_action autoEraseRequest( [&] {
        incomingRequests_.erase( curIt );
    } );

    while ( true )
    {
        if ( shouldLogWebApiDebug_ )
        {
            FB2K_console_formatter() << SPTF_UNDERSCORE_NAME " (debug):\n"
                                     << fmt::format( "throttling for {} milliseconds", waitTime.count() );
        }

        bool hasEvent = cv_.wait_for( lock, waitTime, [&] {
            return timeToDie || ( incomingRequests_.front() == requestIdx && GetTimestampInMs() >= nextAvailableTime );
        } );

        if ( hasEvent )
        {
            if ( !timeToDie )
            {
                timeStamps_.emplace_back( GetTimestampInMs() );
            }
            return;
        }

        nextAvailableTime = GetTimestampInMs() + limitPeriod_ / limitCount_;
        waitTime = limitPeriod_ / limitCount_;
    }
}

} // namespace sptf


================================================
FILE: foo_spotify/utils/rps_limiter.h
================================================
#pragma once

#include <nonstd/ring_span.hpp>

#include <chrono>
#include <list>
#include <mutex>
#include <vector>

namespace sptf
{

class RpsLimiter
{
public:
    RpsLimiter( size_t limit, std::chrono::seconds limitPeriod = std::chrono::seconds( 1 ) );
    ~RpsLimiter() = default;

    void WaitForRequestAvailability( abort_callback& abort );

private:
    const bool shouldLogWebApiDebug_;

    const std::chrono::seconds limitPeriod_;
    const size_t limitCount_;

    std::mutex mutex_;
    std::condition_variable cv_;

    std::vector<std::chrono::milliseconds> timeStampsContainer_;
    nonstd::ring_span<
        std::chrono::milliseconds,
        nonstd::null_popper<std::chrono::milliseconds>>
        timeStamps_;

    size_t curRequestIdx_ = 0;
    // TODO: replace list with queue
    std::list<size_t> incomingRequests_;
};

} // namespace sptf


================================================
FILE: foo_spotify/utils/secure_vector.h
================================================
#pragma once

#include <vector>

namespace sptf
{

template <class T>
class SecureAllocator
{
public:
    static_assert( !std::is_const<T>::value,
                   "The C++ Standard forbids containers of const elements "
                   "because allocator<const T> is ill-formed." );

    using value_type = T;
    using propagate_on_container_move_assignment = std::true_type;
    using is_always_equal = std::true_type;

    constexpr SecureAllocator() noexcept
    {
    }

    constexpr SecureAllocator( const SecureAllocator& ) noexcept = default;

    template <class OtherT>
    constexpr SecureAllocator( const SecureAllocator<OtherT>& ) noexcept
    {
    }

    void deallocate( T* const ptr, const size_t count )
    {
        SecureZeroMemory( reinterpret_cast<uint8_t*>( ptr ), count * sizeof( T ) );
        baseAllocator_.deallocate( ptr, count );
    }

    [[nodiscard]] T* allocate( const size_t count )
    {
        return baseAllocator_.allocate( count );
    }

private:
    std::allocator<T> baseAllocator_;
};

template <class T, class OtherT>
[[nodiscard]] inline bool operator==( const SecureAllocator<T>&,
                                      const SecureAllocator<OtherT>& ) noexcept
{
    return true;
}

template <class T, class OtherT>
[[nodiscard]] inline bool operator!=( const SecureAllocator<T>&,
                                      const SecureAllocator<OtherT>& ) noexcept
{
    return false;
}

template <class T>
using SecureVector = std::vector<T, SecureAllocator<T>>;

} // namespace sptf


================================================
FILE: foo_spotify/utils/sleeper.cpp
================================================
#include <stdafx.h>

#include "sleeper.h"

#include <backend/spotify_instance.h>
#include <utils/abort_manager.h>

#include <condition_variable>
#include <mutex>

namespace sptf
{

bool SleepFor( const std::chrono::milliseconds& duration, abort_callback& abort )
{
    std::mutex mtx;
    std::condition_variable cv;
    bool timeToDie = false;

    auto& am = SpotifyInstance::Get().GetAbortManager();
    auto abortableScope = am.GetAbortableScope( [&] {
        {
            std::lock_guard lock( mtx );
            timeToDie = true;
        }
        cv.notify_all();
    },
                                                abort );

    std::unique_lock lock( mtx );
    return !cv.wait_for( lock, duration, [&] { return timeToDie; } );
}

} // namespace sptf


================================================
FILE: foo_spotify/utils/sleeper.h
================================================
#pragma once

#include <chrono>

namespace sptf
{

bool SleepFor( const std::chrono::milliseconds& duration, abort_callback& abort );

} // namespace sptf


================================================
FILE: libspotify/ChangeLog
================================================
Version 12

	Added Android support.

	Added functionality for controlling scrobbling.

	Added function sp_session_user_name, suitable for using
	in conjunction with the credentials_blob_updated callback.

	Added connectionstate_updated callback.

	Added support for low- and high-res images.

	Fixed a bug where libspotify would crash on reusing credentials
	when password had been changed.

	Fixed a bug where sp_search_total_playlists would always return 0.

	Fixed apparently random crash on multi-core ARM devices.

	Various bug fixes.

Version 11

	The end_of_track() callback in session has changed and is now
	invoked on the main thread. Depending on how your application
	use this callback some change might be necessary.

	Artist browse when used in SP_ARTISTBROWSE_NO_TRACKS or
	SP_ARTISTBROWSE_NO_ALBUMS also includes a list of top tracks for the
	Artist.

	The SP_ARTISTBROWSE_FULL mode has been deprecated and will be
	removed in a future release.

	Artist browse have been improved with tophit tracks.
	See sp_artistbrowse_tophit_track() and
	sp_artistbrowse_num_tophit_tracks()

	New method sp_session_flush_caches().  This will make libspotify
	write all data that is meant to be stored on disk to the disk
	immediately. Libspotify does this periodically by itself and also
	on logout. So under normal conditions this should never need to be
	used.

	Removed support for Mac OS X - PowerPC.

	New callback, credentials_blob_updated() has been added.
	This callback will be invoked when a login blob has been received
	by the client. You can use this blob to relogin a user (via
	sp_session_login()) much like the remember_me argument.
	The difference between remember_me and the blob callback is that
	the blob callback allows multiple users to be relogged in by
	having the application store a blob for each user.
	Useful if your application supports multiple users

	sp_track_get_playable() will return the track that would actually
	be played if a track is "linked". Linked tracks are redirect
	from an unplayable track to a track on a different album (which is
	available in the currently logged in user's region)
	Normally, your application does not need to worry about this but
	the function is here for completeness.

	The radio has been removed. The reason for this is that the
	radio features have been redesigned in the Spotify backend.

	A new feature have been added that allows a user to see
	the number of new tracks added on a subscribed playlist.
	sp_playlistcontainer_get_unseen_tracks() returns number of new
	tracks (and optionally the tracks themselves)
	sp_playlistcontainer_clear_unseen_tracks() can be used to clear
	the unseen track counter.
	This feature is not available in the desktop client yet.

Version 10

	sp_track_is_available() has been renamed to sp_track_get_availability()
	This new function returns more detailed information about why a track
	is not streamable.

	Add error code SP_ERROR_NETWORK_DISABLED

	Add error code SP_ERROR_INVALID_DEVICE_ID

	Add sp_track_offline_get_status() to return offline status of a track.

	Add sp_track_is_placeholder() that indicates if a track is a
	placeholder track. Placeholder tracks are used to store items in
	playlists that are not tracks but rather than changing the entire
	API to support arbitrary items the sp_track object will act as a
	proxy object. The placeholder track object only contains the URI
	to the real object. IE. after having determined that a track
	is a placeholder track the API user should use
	sp_link_create_from_track() to get an URI to the real object
	and continue to resolve the object from there.

	Modify sp_artistbrowse_create() to take a type argument.
	Prior to this release sp_artistbrowse_create() queried
	Spotify's backend servers for all tracks related to an artist
	and doing an artist browse. This consumes a lot of memory
	on the host and for various embedded platforms this could
	result in a crash. This new version of sp_artistbrowse_create()
	offers a way to only query for the albums when using
	'SP_ARTISTBROWSE_NO_TRACKS' (this would typically
	result in 95% less memory used) or just data about the artist
	itself 'SP_ARTISTBROWSE_NO_ALBUMS'. As most user interfaces
	list albums when browsing an artist 'SP_ARTISTBROWSE_NO_TRACKS'
	should almost always be used.

	Add support for controlling volume normalization.
	Note that volume normalization is not enabled on some targets.
	In particular that includes all arm-targets and all target without
	fast floating point (where libspotify uses fixed point vorbis
	decoder instead)

	A couple of functions ending with _backend_request_duration()
	has been added. These functions can be used when analyzing
	performance in an application to see how much time is spent
	on waiting for a request to be served by the Spotify backend

	A new session callback offline_error has been added that
	is called if there is some general problems with offline
	synchronization of tracks.
	libspotifys social integration requires a HTTPS client.
	This needs to be supplied by the application.
	For an example of how to do this (using libcurl) see the
	spshell example (spshell.c)

Version 9

	SPOTIFY_API_VERSION is bumped to 9.

	Package version numbers have changed.

	The distributed package (and the is so versioning where
	applicable) is now versioned like this:

	libspotify-X.Y.Z

	X - Major version. Always same as SPOTIFY_API_VERSION.
	    libraries with different major versions are not ABI compatible

	Y - Minor version.
	    Is 0 during development. 1 for the first public release, etc

	Z - Patch version. Incremented for each change of the codebase

	libspotify can now remember user credentials.
	This should be used to automatically login the user.
	The application MUST NEVER store the user's password.

        - A fourth parameter has been added to sp_session_login() that
	will tell libspotify to remember the login credentials in an
	encrypted form stored in the settings_location as specified when
	creating the session.

	- To relogin a user, the application should invoke
	sp_session_relogin() instead of sp_session_login().  If no
	credentials are stored, SP_ERROR_NO_CREDENTIALS will be returned

	- To clear stored credentials, use sp_session_forget_me()

	- To get username of currently stored credentials use
	sp_session_remembered_user()


	Add sp_session_offline_time_left() that returns time left until
	the user is required to reconnect to Spotify in order to
	revalidate the offline keys.

	The logged in state has been updated to include
	SP_CONNECTION_STATE_OFFLINE, which indicates that the user is
	logged in to the Spotify service in offline mode.

	The SP_ERROR_RESOURCE_NOT_LOADED, which was only used by
	sp_session_player_load(), has been replaced with SP_ERROR_IS_LOADING
	which means the same thing.

	The documentation has been updated to fix a few minor errors.

	callback connection_error() will no longer be invoked if the error
	parameter has value SP_ERROR_OK, as it isn't an error.

	sp_track_set_starred and sp_playlist_add_tracks got their list
	arguments const property changed from (const**) to (*const*).

	sp_link_create_from_artist_portrait() renamed to
	sp_link_create_from_artistbrowse_portrait() which is more appropriate.

	Introduced sp_artist_portrait() and
	sp_link_create_from_artist_portrait() to get one artist portrait
	from an artist object. This should be used to get artist portraits
	when doing search and top list browse queries.

	Introduced sp_build_id() - This could be useful to display
	somewhere deep down in the user interface in case you (or Spotify)
	would like to know the exact version running.

Version 0.0.8

	SPOTIFY_API_VERSION is bumped to 8.

	Added support for offline mode.
	Users of libspotify can now request playlists to be offline
	synchronized just as Spotify's desktop and mobile applications.
	For example of how to do this, please see cmd_playlist_offline()
	in playlist.c in the spshell example.

	Added sp_playlistcontainer_is_loaded() which can be used to
	check if a playlistcontainer is loaded. This value will be true
	after the container_loaded() callback is invoked.

	Added support for spotify:image: linktype. If your application
	needs an abstract way to refer to coverarts, artist portraits, etc
	this is what you should use.

	Add sp_session_user_country() that returns the currently logged in
	users registered country. This is the country that should be used
	to get toplists localized for the user.

	bugfix: LocalTrack URI handling (sp_link) was broken. This has now
	been fixed

	bufix: libspotify was unable to link on 10.4 and 10.5. This has
	now been fixed

Version 0.0.7

	SPOTIFY_API_VERSION is bumped to 7.

	IMPORTANT BEHAVIOR CHANGE: Prior to 0.0.7 libspotify would remove
	all notification callbacks the user had registered on a playlist
	if the playlist was removed from the root container.  This caused
	a problem such that if a playlist was still visible in a user
	interface and got removed from the root container no further
	updates to the list would be visible. There is really no good
	reason to have such behavior and therefore libspotify no longer
	remove the registered notifications. So to be compatible with
	libspotify 0.0.7 and maintain the previous behavior an
	application MUST unregister the callbacks it has registered
	when the sp_playlistcontainer_callbacks::playlist_removed
	notification is invoked. All the examples shipped with
	libspotify already do this so if you have followed them you
	should be OK.

	feature: libspotify is now available for ARMv5, ARMv6 and ARMv7 on
	Linux/glibc

	bugfix: In 0.0.6 sp_playlistcontainer_playlist_folder_name()
	returned a pointer to free'd memory as the folder names are
	internally generated on the fly. Now the caller will have to
	provide a buffer to store the string instead.

	bugfix: If sp_playlistcontainer_add_callbacks() was called before
	login had succeed libspotify would crash. This was a regression
	in 0.0.6

	bugfix: sp_session_publishedcontainer_for_user() did not
	initialize the playlist subsystem internally in the lib resulting
	in a crash.  This could be circumvented by invoking another
	playlist related API call before calling
	sp_session_publishedcontainer_for_user().

	bugfix: sp_session_publishedcontainer_for_user() has been removed
	in favor of sp_session_publishedcontainer_for_user_create() which
	creates a new object that the caller own and thus needs to release
	using sp_playlistcontainer_release(). In 0.0.6 the
	sp_session_publishedcontainer_for_user() function did not claim
	a reference for the container internally and thus the container
	would eventually be flushed by the playlist garbage collector
	resulting in a crash.

	All functions that return errors now have documentation that
	describers the errors they can return.

	SP_ERROR_NO_CACHE and SP_ERROR_NO_SUCH_USER error codes have
	been added.

	Inbox functionality now have support for messages attached to
	each track.

	Add support for creating playlist folders. See notes in
	sp_playlistcontainer_add_folder() for how to delete and rename
	folders.

	Make it possible to modify seen status of tracks in playlist.
	See sp_playlist_track_set_seen()

	Add support for playlist subscription information.
	See sp_playlist_update_subscribers()

	The 'tiny_settings' session configuration flag has been removed
	in favor of more granular flags. See documentation in
	sp_session_config for more details.

	Add support for moving playlists out of RAM and store bulk
	of the information on disk. See sp_playlist_is_in_ram() documentation
	for more details.

	The spshell example did not initialize unused fields in
	sp_session_config to zero. This is good practice to avoid
	accidentally enabling features when compiling with a newer
	version of the lib.

	Playlist containers can now be properly reference counted.
	See sp_playlistcontainer_add_ref() and
	sp_playlistcontainer_release().





Version 0.0.6

	SPOTIFY_API_VERSION is bumped to 6.

	feature: Playlist folders. The folders are implemented as
	specialized playlists. Two specialized types of playlists can be
	used to push/pop depth in the a playlist container view.  See
	sp_playlist_type and sp_playlistcontainer_playlist_type().

	feature: Auto linking of tracks, see sp_track_is_autolinked().

	feature: Add support for extracting playlist description and
	playlist images.

	feature: Make it possible to query if a track is a local track.
	See sp_track_is_local().

	feature: sp_session_release() is now available and thus,
	sp_session_init() has been renamed to sp_session_create()

	feature: Improved audio delivery handling.

	An application may choose to implement a callback in the session
	struct that allows libspotify to query the application audio buffer
	statistics.  The application should return number of samples
	currently in its buffer and also if it has experienced any audio
	dropouts (stutters) since the last query. The query
	callback (get_audio_buffer_stats) will be invoked ca 10 times per
	second.

	If an application implements the get_audio_buffer_stats() it may
	also choose to implement the start_playback() and stop_playback()
	callbacks.  The start_playback() callback will be invoked when
	there is enough samples in the buffer and the session player is in
	play mode,see sp_session_player_play()

	The stop_playback() callback will be invoked when playback is
	paused and when a track ends.

	If an application reports that it has experienced stutter it may
	put itself in paused state and wait for start_playback() to be
	invoked. This will happen once libspotify is satisfied with the
	buffer fullness.  No stop_playback() will be invoked in this case.

	feature: Prefetching of tracks has been added. See
	sp_session_player_prefetch(). Note that prefetch only works if
	the caching is enabled.

	feature: A new session configuration variable 'tiny_settings' is
	available that, when set, tries to minimize the data store in the
	settings dir as much as possible without affecting the user
	experience too much. Set this if free disk space is precious.


Version 0.0.5

	SPOTIFY_API_VERSION is bumped to 5.

	feature: The cache size can now be explicitly configured.  See
	sp_session_set_cache_size().

	feature: Support for getting create user and time for playlist entries.
	See sp_playlist_track_creator() sp_playlist_track_create_time() and the
	track_created_changed callback.

	feature: Support for loading currently logged in user's Inbox.  See
	sp_session_inbox(), sp_playlist_track_seen() and the track_seen_changed
	playlist callback.

	feature: Three new link types SP_LINKTYPE_PROFILE,
	SP_LINKTYPE_STARRED and SP_LINKTYPE_LOCALTRACK

	feature: Support for browsing other users toplists. See
	sp_toplistbrowse_create().

	feature: Support for browsing published lists. See
	sp_session_publishedcontainer_for_user() and
	sp_session_publishedcontainer_for_user_release(), also you can
	get the user object for a playlistcontainer using
	sp_playlistcontainer_owner.

	feature: Support creating local tracks. See sp_localtrack_create().

	ABI change: sp_track_is_available() & sp_track_is_starred() now need
	sp_session to be passed as an argument.

Version 0.0.4

	SPOTIFY_API_VERSION is bumped to 4.

	feature: libspotify is now available for Win32 and OS/X platforms.

	feature: Add support for starred tracks. See sp_track_is_starred(),
	sp_track_set_starred() and sp_session_starred_create().

	feature: Add support for radio. See sp_radio_search_create().

	feature: Add support for loading playlist without adding them to
	the users's playlist container. See sp_playlist_create().

	feature: Add support for 320kb/s streaming. See
	sp_session_preferred_bitrate().

	feature: Added new session callback streaming_error() that is invoked
	if the library is unable to play the requested track.

	feature: Add new session callback userinfo_updated() that is invoked
	when one or more sp_user entries have been updated.

	ABI change: Due to internal changes, the sp_playlist_add_tracks()
	needs sp_session to be passed as an argument.

	API change: The include file has been renamed from spotify/api.h to
	libspotify/api.h for coherency reasons.

Version 0.0.3

	SPOTIFY_API_VERSION is bumped to 3.

	feature: libspotify is now available for 64-bit x86 Linux platforms

	feature: sp_artistbrowse_num_albums() and sp_artistbrowse_album()
	have been added so users of the API can list all albums returned
	in an artist browse.

	bugfix: SP_ERROR_OTHER_PERMAMENT renamed to SP_ERROR_OTHER_PERMANENT

	feature: The sp_image API has changed. libspotify now exposes the
	source image data via the API. See sp_image_data() and
	sp_image_format()

	feature: Playlistcontainer have a new callback container_loaded()
	that is invoked after the container has been initially
	synchronized from the server.

	feature: Added support for toplists. See the sp_toplistbrowse API
	functions.

	feature: Add sp_link_as_track_and_offset() for getting play start
	offset encoded in URIs.

Version 0.0.2

	SPOTIFY_API_VERSION is bumped to 2.

	feature: sp_search_create() has been extended with offset and
	limit for album and artist results.

	bugfix: libspotify contained a bug that caused it to hang if a
	playlist was removed when libspotify was running.

	feature: sp_track_is_available() has been added to allow the user
	to query if a track can be played or not due to regional
	restrictions.

	feature: sp_album_is_available() has been added to allow the user
	to query if a album is available or not due to regional
	restrictions.

	feature: playlist_metadata_updated() per-playlist callback has
	been added, allowing the user to refresh metadata for tracks in a
	playlist.

	feature: sp_album_type() has been added to allow the user to find
	out the album type. See the sp_albumtype enum for the available
	types.

	feature: An end_of_track() session callback has been added. Prior
	to this release the music_delivery() callback would be invoked
	with num_frames set to 0 both to indicate audio discontinuity (as
	a result of a seek from the main thread) and also to indicate
	end-of-track.  To ease application development, end_of_track() is
	now invoked at the end of a track and music_delivery() is only
	invoked with num_frames set to 0 as a result of a seek.


Version 0.0.1

	Initial release


================================================
FILE: libspotify/LICENSE
================================================
For the current terms and conditions, please read:

http://developer.spotify.com/en/libspotify/terms-of-use/


================================================
FILE: libspotify/README
================================================

                                 libspotify 12.1.51
                   ----------------------------------------

                       Copyright  2006-2012 Spotify Ltd



1.  INTRODUCTION

    This is the libspotify C API package.  With it, you can write applications
    that utilize the Spotify music streaming service.


2.  PACKAGE STRUCTURE

    The package is structured as follows:

      libspotify\
        README.txt                     This README file
        LICENSE.txt                    License governing the library,
                                       and associated files
        ChangeLog.txt                  Contains description of new and changed
                                       functionality in libspotify
        licenses.xhtml                 License governing third party libraries
                                       included in libspotify.
        include\libspotify\api.h       Header file for the library
        lib\
          libspotify.dll               libspotify DLL file
          libspotify.lib               Import library
        doc\
          html\                        Documentation in HTML format
                                       This information is also available online.
          images\                      Graphics for use with applications
                                       using libspotify. See section 6 below.
        examples\                      Root directory for the example
                                       source code

3.  INSTALLATION

    You have probably unpacked the distribution zip archive already.

    To run the compiled examples you need to include the directory
    where libspotify.dll resides in your system PATH environment
    variable. For more details see this MSDN article about Windows DLL
    search paths:

    http://msdn.microsoft.com/en-us/library/7d83bc18.aspx
    

4.  APPLICATION KEYS

    The example programs require a file called appkey.c which is not present in
    the package.  You will need to request an application key at the
    developer website at http://developer.spotify.com/ before being able to
    run them.


5.  LOGOTYPES AND TRADEMARK

    The graphics found in the images/ subdirectory are available for use in
    applications using libspotify. The terms and conditions for the use of these
    are available on http://developer.spotify.com/.

    A text file is included in images/, containing the text to be used in
    non-graphical applications.


6.  LICENSE

    You should have received a separate LICENSE file together with this README.


================================================
FILE: libspotify/docs/html/annotated.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Data Structures</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li class="current"><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li class="current"><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="functions.html"><span>Data&nbsp;Fields</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="headertitle">
<h1>Data Structures</h1>  </div>
</div>
<div class="contents">
Here are the data structures with brief descriptions:<table>
  <tr><td class="indexkey"><a class="el" href="structsp__audio__buffer__stats.html">sp_audio_buffer_stats</a></td><td class="indexvalue"></td></tr>
  <tr><td class="indexkey"><a class="el" href="structsp__audioformat.html">sp_audioformat</a></td><td class="indexvalue"></td></tr>
  <tr><td class="indexkey"><a class="el" href="structsp__offline__sync__status.html">sp_offline_sync_status</a></td><td class="indexvalue"></td></tr>
  <tr><td class="indexkey"><a class="el" href="structsp__playlist__callbacks.html">sp_playlist_callbacks</a></td><td class="indexvalue"></td></tr>
  <tr><td class="indexkey"><a class="el" href="structsp__playlistcontainer__callbacks.html">sp_playlistcontainer_callbacks</a></td><td class="indexvalue"></td></tr>
  <tr><td class="indexkey"><a class="el" href="structsp__session__callbacks.html">sp_session_callbacks</a></td><td class="indexvalue"></td></tr>
  <tr><td class="indexkey"><a class="el" href="structsp__session__config.html">sp_session_config</a></td><td class="indexvalue"></td></tr>
  <tr><td class="indexkey"><a class="el" href="structsp__subscribers.html">sp_subscribers</a></td><td class="indexvalue"></td></tr>
</table>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/api_8h.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: api.h File Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="files.html"><span>File&nbsp;List</span></a></li>
      <li><a href="globals.html"><span>Globals</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#nested-classes">Data Structures</a> &#124;
<a href="#define-members">Defines</a> &#124;
<a href="#typedef-members">Typedefs</a> &#124;
<a href="#enum-members">Enumerations</a> &#124;
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<h1>api.h File Reference</h1>  </div>
</div>
<div class="contents">
<code>#include &lt;stddef.h&gt;</code><br/>
<code>#include &lt;stdint.h&gt;</code><br/>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="nested-classes"></a>
Data Structures</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__audioformat.html">sp_audioformat</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__audio__buffer__stats.html">sp_audio_buffer_stats</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__subscribers.html">sp_subscribers</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__offline__sync__status.html">sp_offline_sync_status</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html">sp_session_callbacks</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__config.html">sp_session_config</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__playlist__callbacks.html">sp_playlist_callbacks</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__playlistcontainer__callbacks.html">sp_playlistcontainer_callbacks</a></td></tr>
<tr><td colspan="2"><h2><a name="define-members"></a>
Defines</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga63b2309874193750ec3395f6cae32899">SPOTIFY_API_VERSION</a>&nbsp;&nbsp;&nbsp;12</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#gaa078b44491f976af43e4941fd1dd032c">SP_TOPLIST_REGION</a>(a, b)&nbsp;&nbsp;&nbsp;((a) &lt;&lt; 8 | (b))</td></tr>
<tr><td colspan="2"><h2><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga70dd19c6f824cf6a159575aa4c128b53"></a><!-- doxytag: member="api.h::sp_session" ref="ga70dd19c6f824cf6a159575aa4c128b53" args="" -->
typedef struct <a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Representation of a session. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga47bbd2262f0c8b5d7147af7d62198e48"></a><!-- doxytag: member="api.h::sp_track" ref="ga47bbd2262f0c8b5d7147af7d62198e48" args="" -->
typedef struct <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A track handle. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga6fd3e5de729c429fef3ff18ece6dcfad"></a><!-- doxytag: member="api.h::sp_album" ref="ga6fd3e5de729c429fef3ff18ece6dcfad" args="" -->
typedef struct <a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">An album handle. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga31764fbd69618c10be173c6c03d4c1bc"></a><!-- doxytag: member="api.h::sp_artist" ref="ga31764fbd69618c10be173c6c03d4c1bc" args="" -->
typedef struct <a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">An artist handle. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="gafd3d5aae485f1012ec91b7948e6f9f2b"></a><!-- doxytag: member="api.h::sp_artistbrowse" ref="gafd3d5aae485f1012ec91b7948e6f9f2b" args="" -->
typedef struct <a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A handle to an artist browse result. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga9c4550473a7a07790778ba870c31b4d9"></a><!-- doxytag: member="api.h::sp_albumbrowse" ref="ga9c4550473a7a07790778ba870c31b4d9" args="" -->
typedef struct <a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A handle to an album browse result. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga723de429cd073bcf5d13fb4e0f466ffd"></a><!-- doxytag: member="api.h::sp_toplistbrowse" ref="ga723de429cd073bcf5d13fb4e0f466ffd" args="" -->
typedef struct <a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A handle to a toplist browse result. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="gac95893a6b23d4b19f6f149eed6ead1fd"></a><!-- doxytag: member="api.h::sp_search" ref="gac95893a6b23d4b19f6f149eed6ead1fd" args="" -->
typedef struct <a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A handle to a search result. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="gaf90a23d6b662c96d52ac19f7f4bc1e39"></a><!-- doxytag: member="api.h::sp_link" ref="gaf90a23d6b662c96d52ac19f7f4bc1e39" args="" -->
typedef struct <a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A handle to the libspotify internal representation of a URI. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga61155ca7b1ba941e15490e417441917b"></a><!-- doxytag: member="api.h::sp_image" ref="ga61155ca7b1ba941e15490e417441917b" args="" -->
typedef struct <a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A handle to an image. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="gaed2dbaa1eebd6752f76613daad9158bc"></a><!-- doxytag: member="api.h::sp_user" ref="gaed2dbaa1eebd6752f76613daad9158bc" args="" -->
typedef struct <a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A handle to a user. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga1bcf54cbc117a20ab2c15e59eb3a8174"></a><!-- doxytag: member="api.h::sp_playlist" ref="ga1bcf54cbc117a20ab2c15e59eb3a8174" args="" -->
typedef struct <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A playlist handle. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga45a2febbe167483e48dab8d606d462d7"></a><!-- doxytag: member="api.h::sp_playlistcontainer" ref="ga45a2febbe167483e48dab8d606d462d7" args="" -->
typedef struct <a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A playlist container (playlist containing other playlists) handle. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="gaec0f2e5098cebc05ce56adfc9b346510"></a><!-- doxytag: member="api.h::sp_inbox" ref="gaec0f2e5098cebc05ce56adfc9b346510" args="" -->
typedef struct <a class="el" href="group__types.html#gaec0f2e5098cebc05ce56adfc9b346510">sp_inbox</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#gaec0f2e5098cebc05ce56adfc9b346510">sp_inbox</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Add to inbox request handle. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__session.html#gabf77bb5a124d5a6ee9a12c86abbc0d34">sp_connectionstate</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gac0fa3d4cc60bd2e3d666026f88980e8c">sp_connectionstate</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__session.html#ga087d21080010768316cfb55d938eb94d">sp_sampletype</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga5ef462e78d5a5af60dd0e7085b1ba512">sp_sampletype</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="structsp__audioformat.html">sp_audioformat</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga5338d4a10576ba8d6ab11b70892d503c">sp_audioformat</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__session.html#ga77ddd919314a7bb16140569af7a38fe2">sp_bitrate</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga83d3de45241a44e787410993c5fac0ea">sp_bitrate</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__session.html#gafdd7117213605e6f2671c4f289b44609">sp_playlist_type</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga86723f553db2db6a8f507cd748948ad4">sp_playlist_type</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__session.html#ga99e8e9176ce40fff08a9be8b944edb09">sp_search_type</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga647e4de81e5ac0a2e5d1193b1005ed3e">sp_search_type</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <br class="typebreak"/>
<a class="el" href="group__session.html#ga811fa52ed0fdb5cda732682e27e40417">sp_playlist_offline_status</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gac507efa32e8c122fbe9ea41d96180d06">sp_playlist_offline_status</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__session.html#gad7d9465769597b2a379ac704099adfdf">sp_availability</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga60c7ff53ddbc04c036a23181b7275d69">sp_track_availability</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <br class="typebreak"/>
<a class="el" href="group__session.html#gaeaa41aad3c0047409996a6ec3b03203f">sp_track_offline_status</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gae689044941537050de641a1dcd4c75d5">sp_track_offline_status</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__session.html#ga61bc424465d776af3ceeb69eee2bb492">sp_image_size</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gaca320fd41bd0556b7fa1f2fa6e14faee">sp_image_size</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef struct <br class="typebreak"/>
<a class="el" href="structsp__audio__buffer__stats.html">sp_audio_buffer_stats</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga25462859a596a247ba5cc1853fc32cca">sp_audio_buffer_stats</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="structsp__subscribers.html">sp_subscribers</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gafb515e30d134c61b8eaaff3177af0b5b">sp_subscribers</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__session.html#ga3e8773baeb94189b9a1ff27d6a5e3553">sp_connection_type</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga05a7dbb946a9c47bf011f3f3d77964c3">sp_connection_type</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__session.html#gad275d696685b2ad9ff1a2c3e16af6502">sp_connection_rules</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga24ee483cdceef9af3b415c020b197a75">sp_connection_rules</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__session.html#gac86504cc9e8cadbc30c8aa8dbf355034">sp_artistbrowse_type</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gab947eba77c176504c69cbb2f1de9830d">sp_artistbrowse_type</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef struct <br class="typebreak"/>
<a class="el" href="structsp__offline__sync__status.html">sp_offline_sync_status</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gaa7f24f13d6d105869c405045a4cc2a20">sp_offline_sync_status</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="structsp__session__callbacks.html">sp_session_callbacks</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gaf1d92302cd5d0d4a032e1408188c8fd5">sp_session_callbacks</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="structsp__session__config.html">sp_session_config</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga372b25a93da38d4d707b0c2eaa7b3ebb">sp_session_config</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#gabd76254f89048e6d368929015a0c739f">albumbrowse_complete_cb</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *result, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga8077aa18c043210e859479be2616a3e7">artistbrowse_complete_cb</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *result, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#ga713bef7c5dedba7d91b9710cd9b5faa4">image_loaded_cb</a> (<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#gabcd51c99a318b9f36dfe2948d8209bb1">search_complete_cb</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *result, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef struct <br class="typebreak"/>
<a class="el" href="structsp__playlist__callbacks.html">sp_playlist_callbacks</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga8249fe3d53c6dce0f154d0bfd3e80c6a">sp_playlist_callbacks</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef struct <br class="typebreak"/>
<a class="el" href="structsp__playlistcontainer__callbacks.html">sp_playlistcontainer_callbacks</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga8786e3840bb3774fc929183e3a9df281">sp_playlistcontainer_callbacks</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__user.html#ga6af84143c0622b6fc5539bb1ae111e5b">sp_relation_type</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__user.html#ga3a5dbf9aee629d8a9b43dfb24881a9b4">sp_relation_type</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#gafe8e94ae23133105f35c03b9e3836a0a">toplistbrowse_complete_cb</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *result, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__inbox.html#ga5084d6ab753294730402a0c43b82e60c">inboxpost_complete_cb</a> (<a class="el" href="group__types.html#gaec0f2e5098cebc05ce56adfc9b346510">sp_inbox</a> *result, void *userdata)</td></tr>
<tr><td colspan="2"><h2><a name="enum-members"></a>
Enumerations</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba16cb277dc84328e4b2c0cf6d5a0c0b8d">SP_ERROR_OK</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba17c588fa9648e3649185e595bdb88d6f">SP_ERROR_BAD_API_VERSION</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6bac8c438bd52975d14edf23d040e93d114">SP_ERROR_API_INITIALIZATION_FAILED</a> =  2, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba7b94fe2b53f58d91d4c3cda7bb706ff3">SP_ERROR_TRACK_NOT_PLAYABLE</a> =  3, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba2bad808a467ee4418adaa40f4844d059">SP_ERROR_BAD_APPLICATION_KEY</a> =  5, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba41052a4a158fa18bb1b8bfdd8c37f7dc">SP_ERROR_BAD_USERNAME_OR_PASSWORD</a> =  6, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba822f4031a82ab428cd04f2ecdc0e757f">SP_ERROR_USER_BANNED</a> =  7, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba9d11d66176b6ae95bf00486e9e39866b">SP_ERROR_UNABLE_TO_CONTACT_SERVER</a> =  8, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba995344026c012b3f59dc73e12c28b1ba">SP_ERROR_CLIENT_TOO_OLD</a> =  9, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba3f68775a5c001bd1de26afdf5ea4e09d">SP_ERROR_OTHER_PERMANENT</a> =  10, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baf3597d4af35adb4fc0d0793ea26f77b4">SP_ERROR_BAD_USER_AGENT</a> =  11, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6babb1116e69e1d651f9f175dbc8bb5fa32">SP_ERROR_MISSING_CALLBACK</a> =  12, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6bac9f65a7270391d35342ca9e6c01d519d">SP_ERROR_INVALID_INDATA</a> =  13, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba44b3f132578cbf9a43b5c048efcf63a2">SP_ERROR_INDEX_OUT_OF_RANGE</a> =  14, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba96c08adfcda17005c63142cd4e4cd9bb">SP_ERROR_USER_NEEDS_PREMIUM</a> =  15, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baf139c18351a543862bd9393ccebc5f91">SP_ERROR_OTHER_TRANSIENT</a> =  16, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba17f54c30d01baedc24547e62ed417cdd">SP_ERROR_IS_LOADING</a> =  17, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba71307cc7b8460042603f3f322d1096f4">SP_ERROR_NO_STREAM_AVAILABLE</a> =  18, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baaddac1f3b82e905711ab9ffe5b4b0329">SP_ERROR_PERMISSION_DENIED</a> =  19, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baa4bdf4298c9653549464d21ee528c881">SP_ERROR_INBOX_IS_FULL</a> =  20, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba3b8851ee3ba2bd7ad1fe377d94ac38c0">SP_ERROR_NO_CACHE</a> =  21, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baf8ade144869c958de534ecec9f9a36a9">SP_ERROR_NO_SUCH_USER</a> =  22, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba9ad34b997313d790f142f24e77e78e2d">SP_ERROR_NO_CREDENTIALS</a> =  23, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba8fda4dd3ee6ac931337a871fbee02978">SP_ERROR_NETWORK_DISABLED</a> =  24, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba846d94ada9e8db0c2bd5153f5801afa2">SP_ERROR_INVALID_DEVICE_ID</a> =  25, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6badb3af1736912156cbe0b1e39eaeee1c8">SP_ERROR_CANT_OPEN_TRACE_FILE</a> =  26, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba46c3b6173bb5b09445164402ac5ed81f">SP_ERROR_APPLICATION_BANNED</a> =  27, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba32fd1f63fd4dc7ec50bd11791f02953f">SP_ERROR_OFFLINE_TOO_MANY_TRACKS</a> =  31, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6bae6b9d9b013f1243548e4fbcf961559ff">SP_ERROR_OFFLINE_DISK_CACHE</a> =  32, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba7e16a1962fd4de081d73dc4a4e32eb04">SP_ERROR_OFFLINE_EXPIRED</a> =  33, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6bae102b46f4fae3b7b6b34e21ea80d656f">SP_ERROR_OFFLINE_NOT_ALLOWED</a> =  34, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba2c87afb46df21783f172a06b2c25d8f9">SP_ERROR_OFFLINE_LICENSE_LOST</a> =  35, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba9149b343017c0dea431839c8b4d9198c">SP_ERROR_OFFLINE_LICENSE_ERROR</a> =  36, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baf588c0f7a2d8d11acea28ac2a4de43c4">SP_ERROR_LASTFM_AUTH_ERROR</a> =  39, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba7f8be4d478e51d2b205157c7c538a3e5">SP_ERROR_INVALID_ARGUMENT</a> =  40, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba73d533e0f25f4ba4cecd6d2e2502b80b">SP_ERROR_SYSTEM_FAILURE</a> =  41
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gabf77bb5a124d5a6ee9a12c86abbc0d34">sp_connectionstate</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggabf77bb5a124d5a6ee9a12c86abbc0d34ae31e9958a98211ecff5ecbcf7041dfa5">SP_CONNECTION_STATE_LOGGED_OUT</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggabf77bb5a124d5a6ee9a12c86abbc0d34a88ae17b4168184e62e4c190c289c47c5">SP_CONNECTION_STATE_LOGGED_IN</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggabf77bb5a124d5a6ee9a12c86abbc0d34ad1a6eb721675af4613f823c091538a8c">SP_CONNECTION_STATE_DISCONNECTED</a> =  2, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggabf77bb5a124d5a6ee9a12c86abbc0d34a4ddf57518007eef86b06f496d7059484">SP_CONNECTION_STATE_UNDEFINED</a> =  3, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggabf77bb5a124d5a6ee9a12c86abbc0d34a63099ef9185ba287fcd2e77be3c47d8f">SP_CONNECTION_STATE_OFFLINE</a> =  4
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga087d21080010768316cfb55d938eb94d">sp_sampletype</a> { <a class="el" href="group__session.html#gga087d21080010768316cfb55d938eb94daa829b269d191cca95ecb02c2bc59da42">SP_SAMPLETYPE_INT16_NATIVE_ENDIAN</a> =  0
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga77ddd919314a7bb16140569af7a38fe2">sp_bitrate</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga77ddd919314a7bb16140569af7a38fe2a5b5c794224972f833a4b7eec9d7909c9">SP_BITRATE_160k</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga77ddd919314a7bb16140569af7a38fe2a9383c0dc9faefd2cbb38c3b9342c47e0">SP_BITRATE_320k</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga77ddd919314a7bb16140569af7a38fe2ad815a35af7e6bb5e2ef29418af62759b">SP_BITRATE_96k</a> =  2
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gafdd7117213605e6f2671c4f289b44609">sp_playlist_type</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggafdd7117213605e6f2671c4f289b44609a6bd6bf9b62018fa9bbf969835c2f3077">SP_PLAYLIST_TYPE_PLAYLIST</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggafdd7117213605e6f2671c4f289b44609a4d3266991787f9438deb9de83d9200da">SP_PLAYLIST_TYPE_START_FOLDER</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggafdd7117213605e6f2671c4f289b44609a3ec52ad1d99d8e32e1b9de31e3f5187a">SP_PLAYLIST_TYPE_END_FOLDER</a> =  2, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggafdd7117213605e6f2671c4f289b44609ad4f860ef76154e3e2c0d9da2f57a2784">SP_PLAYLIST_TYPE_PLACEHOLDER</a> =  3
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga99e8e9176ce40fff08a9be8b944edb09">sp_search_type</a> </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga811fa52ed0fdb5cda732682e27e40417">sp_playlist_offline_status</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga811fa52ed0fdb5cda732682e27e40417abef62e4e3a4af8827fed7fe3aa733ca0">SP_PLAYLIST_OFFLINE_STATUS_NO</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga811fa52ed0fdb5cda732682e27e40417affed38ac820e084b96fb48e3d1939584">SP_PLAYLIST_OFFLINE_STATUS_YES</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga811fa52ed0fdb5cda732682e27e40417abc999c70761d392b26753708e9a2cfa1">SP_PLAYLIST_OFFLINE_STATUS_DOWNLOADING</a> =  2, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga811fa52ed0fdb5cda732682e27e40417a7d929bbf4f1df3633b283e39b9c95919">SP_PLAYLIST_OFFLINE_STATUS_WAITING</a> =  3
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gad7d9465769597b2a379ac704099adfdf">sp_availability</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggad7d9465769597b2a379ac704099adfdfa44bc1e6f138910b3f8dbd309325e0077">SP_TRACK_AVAILABILITY_UNAVAILABLE</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggad7d9465769597b2a379ac704099adfdfa3b837ba6d740b5650b0113734a3b2ff7">SP_TRACK_AVAILABILITY_AVAILABLE</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggad7d9465769597b2a379ac704099adfdfae7b2cfafa10288ecc50df97621bbe940">SP_TRACK_AVAILABILITY_NOT_STREAMABLE</a> =  2, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggad7d9465769597b2a379ac704099adfdfaeb5d63e89c543f513cd3054969e50914">SP_TRACK_AVAILABILITY_BANNED_BY_ARTIST</a> =  3
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gaeaa41aad3c0047409996a6ec3b03203f">sp_track_offline_status</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203faad1a1cba82ce9f9be678f4d1042eddec">SP_TRACK_OFFLINE_NO</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa1fdd2a518dcdc072cfca27a0ca4f2581">SP_TRACK_OFFLINE_WAITING</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa7dcf6dfc56a8421200451d07a476f370">SP_TRACK_OFFLINE_DOWNLOADING</a> =  2, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fac54d46cbc73de7686a1ad8daf269532a">SP_TRACK_OFFLINE_DONE</a> =  3, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa86618798c266540bdc889dd037a52631">SP_TRACK_OFFLINE_ERROR</a> =  4, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa00fe430030fb6a8a49a46c11cca7326c">SP_TRACK_OFFLINE_DONE_EXPIRED</a> =  5, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa405a9b7a3fa489ad2dadbb108794e247">SP_TRACK_OFFLINE_LIMIT_EXCEEDED</a> =  6, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa5f3e19627de4509ae4a3864fd29edee6">SP_TRACK_OFFLINE_DONE_RESYNC</a> =  7
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga61bc424465d776af3ceeb69eee2bb492">sp_image_size</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga61bc424465d776af3ceeb69eee2bb492ad20c808fd1f8180d1f49f643975d1dd7">SP_IMAGE_SIZE_NORMAL</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga61bc424465d776af3ceeb69eee2bb492ab9340b1bcf2129c3ad1328ea617d547f">SP_IMAGE_SIZE_SMALL</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga61bc424465d776af3ceeb69eee2bb492a0a0b624afbb2a66ee3d7954202b89721">SP_IMAGE_SIZE_LARGE</a> =  2
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga3e8773baeb94189b9a1ff27d6a5e3553">sp_connection_type</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553af949fae9bc12f47b99ef290fa9b5d8a7">SP_CONNECTION_TYPE_UNKNOWN</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553aa7aae7ae3f7c471ece1c6aa2705d046c">SP_CONNECTION_TYPE_NONE</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553a3ca3e6a85ac9d497914c35620ad5179d">SP_CONNECTION_TYPE_MOBILE</a> =  2, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553a05b41bbfd369f9030a7daafc9395116e">SP_CONNECTION_TYPE_MOBILE_ROAMING</a> =  3, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553a31d2cad7379f1bc2eeedd24c40541cb9">SP_CONNECTION_TYPE_WIFI</a> =  4, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553a4f9f0c09e59af4114bb369ebcc474710">SP_CONNECTION_TYPE_WIRED</a> =  5
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gad275d696685b2ad9ff1a2c3e16af6502">sp_connection_rules</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggad275d696685b2ad9ff1a2c3e16af6502aa39a1c21c17c55cd1547bc900ae2d386">SP_CONNECTION_RULE_NETWORK</a> =  0x1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggad275d696685b2ad9ff1a2c3e16af6502af2772ba84ee7e410ad99708a11955670">SP_CONNECTION_RULE_NETWORK_IF_ROAMING</a> =  0x2, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggad275d696685b2ad9ff1a2c3e16af6502a91a946573c44de44d74e9d20dbce4c74">SP_CONNECTION_RULE_ALLOW_SYNC_OVER_MOBILE</a> =  0x4, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggad275d696685b2ad9ff1a2c3e16af6502a548f3734832ec65a992e598d8b91633d">SP_CONNECTION_RULE_ALLOW_SYNC_OVER_WIFI</a> =  0x8
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gac86504cc9e8cadbc30c8aa8dbf355034">sp_artistbrowse_type</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggac86504cc9e8cadbc30c8aa8dbf355034a2914168528aded818177c013a0dd7e87">SP_ARTISTBROWSE_FULL</a>, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggac86504cc9e8cadbc30c8aa8dbf355034afbad1e58606b3230dce5bc3320c95d12">SP_ARTISTBROWSE_NO_TRACKS</a>, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggac86504cc9e8cadbc30c8aa8dbf355034ac0032981f8dbf44c022e6a7ab1672167">SP_ARTISTBROWSE_NO_ALBUMS</a>
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#gabe9611f04086cdbed6e4e6e1fd913b98">sp_linktype</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a88b0098486cde586b4dcffb623ac6e63">SP_LINKTYPE_INVALID</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a5911dbb7258ed160b2f9c114cef152f1">SP_LINKTYPE_TRACK</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a7716eb95eed852d08300e6e64febc7f3">SP_LINKTYPE_ALBUM</a> =  2, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a4402b3b001aebb39fd55296f83c60b7e">SP_LINKTYPE_ARTIST</a> =  3, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98ad5909ab9b1cca702163e116b04b6ee8e">SP_LINKTYPE_SEARCH</a> =  4, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a2640ed065a64b6a9f67e71bbeb2af2dd">SP_LINKTYPE_PLAYLIST</a> =  5, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98ab7a356adce8b1ea34daf21532c7b50e6">SP_LINKTYPE_PROFILE</a> =  6, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98ab649bd86d0fc55ab3fafed3050261353">SP_LINKTYPE_STARRED</a> =  7, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a0698cd0123190c7af55daf79bb642805">SP_LINKTYPE_LOCALTRACK</a> =  8, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a1b20b8e2b8773df47b241dc7d28ea0e8">SP_LINKTYPE_IMAGE</a> =  9
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__album.html#ga019b49a9d1633b61daa79c80ea01d5c3">sp_albumtype</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__album.html#gga019b49a9d1633b61daa79c80ea01d5c3ad1693d93a2c05c053fc4fd77886af8dd">SP_ALBUMTYPE_ALBUM</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__album.html#gga019b49a9d1633b61daa79c80ea01d5c3a3b6f78b733f1bc18a5e4fa18c020fc73">SP_ALBUMTYPE_SINGLE</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__album.html#gga019b49a9d1633b61daa79c80ea01d5c3a8fee6ba46e8876037f4f2e46c6d6c6af">SP_ALBUMTYPE_COMPILATION</a> =  2, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__album.html#gga019b49a9d1633b61daa79c80ea01d5c3ad564ed5f1f0659929fe5ec700513873f">SP_ALBUMTYPE_UNKNOWN</a> =  3
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#ga2cda19baf2460da5e81fb1917f54626b">sp_imageformat</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__image.html#gga2cda19baf2460da5e81fb1917f54626ba2fec8a1b400bd6cd5396b9852e4279b6">SP_IMAGE_FORMAT_UNKNOWN</a> =  -1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__image.html#gga2cda19baf2460da5e81fb1917f54626ba6263674800bea702c4d913d4b07c135d">SP_IMAGE_FORMAT_JPEG</a> =  0
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__user.html#ga6af84143c0622b6fc5539bb1ae111e5b">sp_relation_type</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__user.html#gga6af84143c0622b6fc5539bb1ae111e5ba18f24164eef0e687b351c2aa6753e35e">SP_RELATION_TYPE_UNKNOWN</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__user.html#gga6af84143c0622b6fc5539bb1ae111e5bad9805f100828a9d3b64c3cc66f2ac5c1">SP_RELATION_TYPE_NONE</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__user.html#gga6af84143c0622b6fc5539bb1ae111e5ba06b2f38745c467e7e362c7744cb74205">SP_RELATION_TYPE_UNIDIRECTIONAL</a> =  2, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__user.html#gga6af84143c0622b6fc5539bb1ae111e5ba4bfef63cabd016cf1e6b11347a05d389">SP_RELATION_TYPE_BIDIRECTIONAL</a> =  3
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#ga220f32522efb2828e4f8ffb949af234a">sp_toplisttype</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__toplist.html#gga220f32522efb2828e4f8ffb949af234aa41523e58badf9e3901beea3f53e5d28e">SP_TOPLIST_TYPE_ARTISTS</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__toplist.html#gga220f32522efb2828e4f8ffb949af234aae8002818ef10eb2c75ec2058ce11cf6b">SP_TOPLIST_TYPE_ALBUMS</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__toplist.html#gga220f32522efb2828e4f8ffb949af234aa6a85f8384ec77cb9cb5746966b0f0e28">SP_TOPLIST_TYPE_TRACKS</a> =  2
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#ga6fa5cfed2cbb33f2f64542d0b63f6c8d">sp_toplistregion</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__toplist.html#gga6fa5cfed2cbb33f2f64542d0b63f6c8da9e9136541401041c7d5c37708b7a927f">SP_TOPLIST_REGION_EVERYWHERE</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__toplist.html#gga6fa5cfed2cbb33f2f64542d0b63f6c8da6912eff58c71f5c74b78f48af5305375">SP_TOPLIST_REGION_USER</a> =  1
<br/>
 }</td></tr>
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__error.html#ga983dee341d3c2008830513b7cffe7bf3">sp_error_message</a> (<a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> error)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gaf2891f2daced4ff6da84219d6376b3aa">sp_session_create</a> (const <a class="el" href="structsp__session__config.html">sp_session_config</a> *config, <a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> **sess)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gab81c540b76f7425a9cc0dbf270c09674">sp_session_release</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *sess)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga4533a992a120cacb109c892a852afe2a">sp_session_login</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, const char *username, const char *password, bool remember_me, const char *blob)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gae1bc9bebd230226c3d48925cd1be6edf">sp_session_relogin</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gab349c7bfe59e10e167bd75c20df9fc97">sp_session_remembered_user</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, char *buffer, size_t buffer_size)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gac7a365c2166738909cdb901edebc3f70">sp_session_user_name</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga61e6b796d9e07682c018e888b901a191">sp_session_forget_me</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga267bbcae24b6bb1fd56de56678a5f455">sp_session_user</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gab7f08ca0939985b30ae2d1ed9db1d726">sp_session_logout</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga34005bb06ee3de8ee4221597a0335cca">sp_session_flush_caches</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__session.html#gabf77bb5a124d5a6ee9a12c86abbc0d34">sp_connectionstate</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga34a7c9527705ab7d23b742006d81ea35">sp_session_connectionstate</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gabfb3f59b20ae0b225e154eb9095152b2">sp_session_userdata</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga6f27c55d1ce9f3f794fcce7bee7adfea">sp_session_set_cache_size</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, size_t size)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gaff27cb730db6debf55e750e39e7fadd7">sp_session_process_events</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, int *next_timeout)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gac73bf2c569a43d824439b557d5e4b293">sp_session_player_load</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga3430cd4f11541868d3f83eaa31aecf44">sp_session_player_seek</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, int offset)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gab66c5915967e4f90db945b118e620624">sp_session_player_play</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, bool play)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gafa7ee2803f119451bb8be3bf28746975">sp_session_player_unload</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gaf42e30a1f430ac7c436c7d9f0485368d">sp_session_player_prefetch</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga319767f0b795f1c46a08390b587c5671">sp_session_playlistcontainer</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gac72ccb51031c846101134b73195bb9ec">sp_session_inbox_create</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga02391c9e28cff0a602f7139542e0238f">sp_session_starred_create</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga9be806a719a6399bfe1fd0d4c125e0eb">sp_session_starred_for_user_create</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, const char *canonical_username)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga4ad3a1de596a41f275120dad3bb4685d">sp_session_publishedcontainer_for_user_create</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, const char *canonical_username)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gacd590e095b011af42fb10046117846fe">sp_session_preferred_bitrate</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__session.html#ga77ddd919314a7bb16140569af7a38fe2">sp_bitrate</a> bitrate)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga4bba5f828d6c87692f2c355cc8f07c61">sp_session_preferred_offline_bitrate</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__session.html#ga77ddd919314a7bb16140569af7a38fe2">sp_bitrate</a> bitrate, bool allow_resync)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga7913df06394360f255c77fb87af0f1fe">sp_session_get_volume_normalization</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga4e14f58356d00e3693be84623bf6bd11">sp_session_set_volume_normalization</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, bool on)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga42a8f0999316ac7f141926092879ad2f">sp_session_set_private_session</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, bool enabled)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga72702ee06bc96c074804388d24344149">sp_session_is_private_session</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga2475a1fbc2eeacccb96b7f36efd36725">sp_session_set_scrobbling</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, sp_social_provider provider, sp_scrobbling_state state)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga6a56bc82ff0b369bb6e0f035534ce33d">sp_session_is_scrobbling</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, sp_social_provider provider, sp_scrobbling_state *state)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga0fad03ceabcf8d68af78f0f35fcbcc8d">sp_session_is_scrobbling_possible</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, sp_social_provider provider, bool *out)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga9e5ee46ef5e75aa462607caac984f2de">sp_session_set_social_credentials</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, sp_social_provider provider, const char *username, const char *password)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gaf81c61799e0ccdbba048fb79ec050930">sp_session_set_connection_type</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__session.html#ga3e8773baeb94189b9a1ff27d6a5e3553">sp_connection_type</a> type)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga0ac85299c37710321b6d64713e1d6ba8">sp_session_set_connection_rules</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__session.html#gad275d696685b2ad9ff1a2c3e16af6502">sp_connection_rules</a> rules)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gaf535124b4208c279cb98a061834e6411">sp_offline_tracks_to_sync</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gad6cee58fa44453b7a4fd2ae2266df055">sp_offline_num_playlists</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga02525cd659a34728047cd3801049e822">sp_offline_sync_get_status</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="structsp__offline__sync__status.html">sp_offline_sync_status</a> *status)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gac36816dc42825db9a5a2fbd2694f20af">sp_offline_time_left</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga54c7693afa9be664f3ea870feb0df8d9">sp_session_user_country</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#gaea9c39f35f7986fc9fed4584fa211127">sp_link_create_from_string</a> (const char *link)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga82c29419ce70e2b504670e3d45167d5d">sp_link_create_from_track</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track, int offset)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga040627b0df84425947c82cd8890122ad">sp_link_create_from_album</a> (<a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#gaa87e346c29f1077d7a62c364719d4a55">sp_link_create_from_album_cover</a> (<a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album, <a class="el" href="group__session.html#ga61bc424465d776af3ceeb69eee2bb492">sp_image_size</a> size)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga3196ce9de3da4f1d5944a0b58bd80540">sp_link_create_from_artist</a> (<a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *artist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#gaafb25ee14bfb27f9cbbab1b039d4d225">sp_link_create_from_artist_portrait</a> (<a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *artist, <a class="el" href="group__session.html#ga61bc424465d776af3ceeb69eee2bb492">sp_image_size</a> size)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga32218fbd912ddddbb749cb42a72b6bcd">sp_link_create_from_artistbrowse_portrait</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga95c97ba4de9c4040047276ad618a108e">sp_link_create_from_search</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga805392bfa8e526eebedc1cf5a7bcae0f">sp_link_create_from_playlist</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#gaaa78b1750179c17f8152408cea43efef">sp_link_create_from_user</a> (<a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *user)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#gaa85fbea312127db44685b7e9dc492042">sp_link_create_from_image</a> (<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga9f169be53f098adcf12f7a10b8bd3ef7">sp_link_as_string</a> (<a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *link, char *buffer, int buffer_size)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__link.html#gabe9611f04086cdbed6e4e6e1fd913b98">sp_linktype</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga6140f924c696d53469bb8930cd53e1e6">sp_link_type</a> (<a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *link)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga2560687997d7ce0fbf4f05251d87d32a">sp_link_as_track</a> (<a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *link)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga80f6f752832f76c268c0bfd3ca45e6d2">sp_link_as_track_and_offset</a> (<a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *link, int *offset)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#gaafa98628d0abadcca27dd3b227c7337b">sp_link_as_album</a> (<a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *link)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#gab32979d26dcf68936202fa7aed7b6e49">sp_link_as_artist</a> (<a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *link)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga3e29975f47fc0a51be813b4774a3d6f3">sp_link_as_user</a> (<a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *link)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#gac5a808b15bceed41508bd3863c8f4b3b">sp_link_add_ref</a> (<a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *link)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga2b06ab16d1f6436cd8d36dbff2b5c022">sp_link_release</a> (<a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *link)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga8b69cf193679c7e00031ae43e61c6a54">sp_track_is_loaded</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga947c0f7755b0c4955ca0b0993db0f2b5">sp_track_error</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__session.html#gaeaa41aad3c0047409996a6ec3b03203f">sp_track_offline_status</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga281e0ad4373579c5d24202ea1f93fe7b">sp_track_offline_get_status</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__session.html#ga60c7ff53ddbc04c036a23181b7275d69">sp_track_availability</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga9c78846badae6567fe9f9a3792fd06c8">sp_track_get_availability</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#gabcb75da69e0338006bdbd2f2f467f082">sp_track_is_local</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga4eeb86de13187697cd9dfe0b0934988d">sp_track_is_autolinked</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga112dca47d0bac39818b55119ef134ffd">sp_track_get_playable</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga2367d906c578e674d0d470d8c1ee3b33">sp_track_is_placeholder</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#gab17d380ac941e102af0f308ad885b3c3">sp_track_is_starred</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga34b5a712fb2c683402ff78df73e7545c">sp_track_set_starred</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *const *tracks, int num_tracks, bool star)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga0aa945fc43e35d36cc334a52735d83b2">sp_track_num_artists</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga67cd0c035627a1e4a54642213fdf1d75">sp_track_artist</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga39a0f52244472cb2d450ea9ba6807304">sp_track_album</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga8eb423d3cc2cbfb743c7f23ffb8d0fad">sp_track_name</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#gac817937bd8d8355b6a1949b76d0b5560">sp_track_duration</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga4570f08f968edbff519b44d2241d2255">sp_track_popularity</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga9d464ee4a5c8836b59888952b960223a">sp_track_disc</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga25c1df9d32fd58f243397740b29c3f61">sp_track_index</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga0fb814ef23636fdecda64e3a63b15a23">sp_localtrack_create</a> (const char *artist, const char *title, const char *album, int length)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga7d86041a2bf75590f55978521c08e38c">sp_track_add_ref</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#gaa11098d82e6c2ae42fc2ea1486e741de">sp_track_release</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__album.html#ga46fbfa98be12c2f4067d5e679552cfb9">sp_album_is_loaded</a> (<a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__album.html#ga89eb8dc73a76f5e0509b1066426495f7">sp_album_is_available</a> (<a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__album.html#ga42309972141dab10c32d741d357c01de">sp_album_artist</a> (<a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const byte *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__album.html#ga6616ef3df724af185c5eb58e8a0fb808">sp_album_cover</a> (<a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album, <a class="el" href="group__session.html#ga61bc424465d776af3ceeb69eee2bb492">sp_image_size</a> size)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__album.html#ga0e828c991a8184d60026513f944e19ad">sp_album_name</a> (<a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__album.html#ga2aadf934b0af43c3ef6ee98b6a8065fd">sp_album_year</a> (<a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__album.html#ga019b49a9d1633b61daa79c80ea01d5c3">sp_albumtype</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__album.html#ga8dceb04a62bdb3ffc112ed0efc359e51">sp_album_type</a> (<a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__album.html#ga08192dd38d1c628f7b51615fffa33017">sp_album_add_ref</a> (<a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__album.html#ga5c6e49d04ffb05c722db5e78c9434b88">sp_album_release</a> (<a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artist.html#gad2895555bb48514986823733a7afe5e2">sp_artist_name</a> (<a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *artist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artist.html#gafc98f5093184a7ac7ce608302b0971ea">sp_artist_is_loaded</a> (<a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *artist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const byte *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artist.html#ga87d366ac7479c717005c2c059d5f2be9">sp_artist_portrait</a> (<a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *artist, <a class="el" href="group__session.html#ga61bc424465d776af3ceeb69eee2bb492">sp_image_size</a> size)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artist.html#gac70d7467f580aa497d1a5d610e06d273">sp_artist_add_ref</a> (<a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *artist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artist.html#ga7b0da8f7ce09454bd0821d06d52e2d12">sp_artist_release</a> (<a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *artist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#gaf1bc3042e748efea5ca7ac159e5cbfbe">sp_albumbrowse_create</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album, <a class="el" href="group__albumbrowse.html#gabd76254f89048e6d368929015a0c739f">albumbrowse_complete_cb</a> *callback, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#gad618d2752eb55173ab373d1407971960">sp_albumbrowse_is_loaded</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#ga153417eee319e7711b66503f88fba88b">sp_albumbrowse_error</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#gaf0dadfc4edb48a3558b606e30e8bedfa">sp_albumbrowse_album</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#ga4f835537a65bcac9ec52cef1058a44bc">sp_albumbrowse_artist</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#gab53fa74ee1958dad5186be09e70ddc4a">sp_albumbrowse_num_copyrights</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#ga34b205daa2960e8d02a6e1accd80ab92">sp_albumbrowse_copyright</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#ga3fb91de745ca07d3801a57288f2d9da7">sp_albumbrowse_num_tracks</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#gad3c8df4b75158bba2c06aaefa74c5aa1">sp_albumbrowse_track</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#ga868f3f3263f5033ae1fba60f403be712">sp_albumbrowse_review</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#ga2f1e1049065e8c090c010f8e43061bd4">sp_albumbrowse_backend_request_duration</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#ga1afd6a10febf31a61cf356673cb34bef">sp_albumbrowse_add_ref</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#gabdd5a4e3b2098166b67e35979f59613d">sp_albumbrowse_release</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga8dd8364b2fcd29c846209660bd9a69b2">sp_artistbrowse_create</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *artist, <a class="el" href="group__session.html#gac86504cc9e8cadbc30c8aa8dbf355034">sp_artistbrowse_type</a> type, <a class="el" href="group__artistbrowse.html#ga8077aa18c043210e859479be2616a3e7">artistbrowse_complete_cb</a> *callback, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga966b0f59e7b2b3d0037e44bb49dcdabc">sp_artistbrowse_is_loaded</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga203e757088ff7a5098f16a1367da25d2">sp_artistbrowse_error</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga5f6a046b2bd261d7628582b986a9019f">sp_artistbrowse_artist</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga98dc47d36d2789999bfe62707c5041d7">sp_artistbrowse_num_portraits</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const byte *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga5f164b2f9609a7bf2c89b3a1407ec239">sp_artistbrowse_portrait</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga8c862caa2234125ffcc4e93287b1e029">sp_artistbrowse_num_tracks</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga45d28771a856f935dc40ab40e27dec4c">sp_artistbrowse_track</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga0c26782796af954300ce92fddea97637">sp_artistbrowse_num_tophit_tracks</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga5da55f43def03fe9f0d2c8b252b9755a">sp_artistbrowse_tophit_track</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#gaf0055361abd53425d89a4636a32b5c83">sp_artistbrowse_num_albums</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga5b36c9a34876beea8fda8674b93d4fd3">sp_artistbrowse_album</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga2559638742416ac621af0e919e017d17">sp_artistbrowse_num_similar_artists</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#gac60ef4f9e006a920f1d72b6098743fbc">sp_artistbrowse_similar_artist</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga8b93b9e5630662855f35694280ba4d2b">sp_artistbrowse_biography</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#gadce357748b82abce8a7b093882850fdb">sp_artistbrowse_backend_request_duration</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga69fc2e1d2d5e8d91a724486cbfd0c4dc">sp_artistbrowse_add_ref</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga14626a4f6a60b1caf61cb54c26783671">sp_artistbrowse_release</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#gaf29e89f45945db2b3667bf9db4279c33">sp_image_create</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, const byte image_id[20])</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#ga70fb25cd2b0caaf15f637f36e75524b9">sp_image_create_from_link</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *l)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#gaa414f26ad1b9095645a83361597c92ce">sp_image_add_load_callback</a> (<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image, <a class="el" href="group__image.html#ga713bef7c5dedba7d91b9710cd9b5faa4">image_loaded_cb</a> *callback, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#gaaee68c65d9eab3499f2b6be5d048d6ba">sp_image_remove_load_callback</a> (<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image, <a class="el" href="group__image.html#ga713bef7c5dedba7d91b9710cd9b5faa4">image_loaded_cb</a> *callback, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#ga45312b1b9b5e5565485d61a8f0300e18">sp_image_is_loaded</a> (<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#gae40103df87426b346e0d0413d8d3b0ff">sp_image_error</a> (<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__image.html#ga2cda19baf2460da5e81fb1917f54626b">sp_imageformat</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#ga04448e81ca4916ba7ed223d0d817e803">sp_image_format</a> (<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const void *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#ga03700a7dfa90bfc8200b89f15acd91aa">sp_image_data</a> (<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image, size_t *data_size)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const byte *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#ga0ee0b98cc25c995fe208a992cc87d145">sp_image_image_id</a> (<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#ga98c93dbedfb182243742131a5224b83b">sp_image_add_ref</a> (<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#ga3df9af5f68b18df5a598b7510e9b587f">sp_image_release</a> (<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga2f64dfbcc1313e7d5179998cb28208d4">sp_search_create</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, const char *query, int track_offset, int track_count, int album_offset, int album_count, int artist_offset, int artist_count, int playlist_offset, int playlist_count, <a class="el" href="group__session.html#ga99e8e9176ce40fff08a9be8b944edb09">sp_search_type</a> search_type, <a class="el" href="group__search.html#gabcd51c99a318b9f36dfe2948d8209bb1">search_complete_cb</a> *callback, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga70e8c404d8c7ce0bbef70c2b274417cd">sp_search_is_loaded</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga7cf655e37a823f952d30270d4fb60f10">sp_search_error</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga1dd18cf7b3b3b7f4bf6e92a2140378d0">sp_search_num_tracks</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#gae9da7ca59ce0bbd73f7bcef4e15c4da8">sp_search_track</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga0c456a6396c4c05fbc8677ea641ef1f7">sp_search_num_albums</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga4ba7723e70db0c6a4569c4bcd44f0e98">sp_search_album</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#gaa9f007f439d8241bf632f9abb8d926c9">sp_search_num_playlists</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga4175fba17f355b1c0bd361357181ea35">sp_search_playlist</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga933cd5d5a0ccca9906082ca4549a4ed7">sp_search_playlist_name</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga0071a3d30f0f0c4e477bf923e9014ff5">sp_search_playlist_uri</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#gac4463fab4ea25e0a5d5079c959a1781c">sp_search_playlist_image_uri</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#gabd375a613c2dadecad8c13f8aca6f2d3">sp_search_num_artists</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga79b3d532d5a20a3b2bf2a087eead7888">sp_search_artist</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga127e9c2bf98e3602ecfc2926b9d242bf">sp_search_query</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga8561c1da8b93ecdc8f2d325a9d19199b">sp_search_did_you_mean</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#gab4e50582c517b4639fd1afd6fb011587">sp_search_total_tracks</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#gaafd3b228adbc028937383d0d45730581">sp_search_total_albums</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga305a4118625e0f70cfb14161a0112fd5">sp_search_total_artists</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga2e286415a6ba8dbf85ea677906f2798c">sp_search_total_playlists</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga92e45a5edb1e33e64fdb857bd8eb9ad5">sp_search_add_ref</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga4e01d43067d9f8c533c985f90143821b">sp_search_release</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gaee8ea6c07dfdca3397e27b278fa4870a">sp_playlist_is_loaded</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gab15fca12d387c69b4998a4d2b48e5b32">sp_playlist_add_callbacks</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, <a class="el" href="structsp__playlist__callbacks.html">sp_playlist_callbacks</a> *callbacks, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga7fcbf909a0fa8bf25f0b1d1e7dd0e160">sp_playlist_remove_callbacks</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, <a class="el" href="structsp__playlist__callbacks.html">sp_playlist_callbacks</a> *callbacks, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga684a3acc60f99b3b26488ed813ee5d23">sp_playlist_num_tracks</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga7a03854fe6072476306780d23c6cac16">sp_playlist_track</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gab8e77f8d63e787f8aa1a066d74daa74c">sp_playlist_track_create_time</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga80fcd9e7b40c791433c07d66e2ad432a">sp_playlist_track_creator</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gab9e00ee5bc6b5dc0b3d58cbdb32c0c7b">sp_playlist_track_seen</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga69f5cc1bdd7dbdcdb476a7b1d2b7834d">sp_playlist_track_set_seen</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, int index, bool seen)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga6887b9dabb30a060b10bdb75f8b3f971">sp_playlist_track_message</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga61b7e33cc1aedb4e31a2af75ae0ac8cc">sp_playlist_name</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gad6c3880c514353e204fdd90830b516ec">sp_playlist_rename</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, const char *new_name)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gac3e4295d3353eb9998402aedfdbd55de">sp_playlist_owner</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga8ad160f654f02f13690568070dd57353">sp_playlist_is_collaborative</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gad15410bcc2ebd986adabda865830bce4">sp_playlist_set_collaborative</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, bool collaborative)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga0bde47f340e0cd590a78007c6af69307">sp_playlist_set_autolink_tracks</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, bool link)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gab1d8e0ee9b436ecbb104bbd6cc0665be">sp_playlist_get_description</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga409cb6b2a88db7242ec939b6644e8c30">sp_playlist_get_image</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, byte image[20])</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gaf0e39b5969259d10625eb398af0f3f43">sp_playlist_has_pending_changes</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga2344a47133f7f0aed0a67e154ecc4dc4">sp_playlist_add_tracks</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *const *tracks, int num_tracks, int position, <a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gabd62cd7ff9484b4c31ff7f159ec41b6a">sp_playlist_remove_tracks</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, const int *tracks, int num_tracks)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga90ffd8c9fc6abc7375e89f4cb49adb11">sp_playlist_reorder_tracks</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, const int *tracks, int num_tracks, int new_position)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">unsigned int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga967ad87f0db702513ecda82546f667c5">sp_playlist_num_subscribers</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="structsp__subscribers.html">sp_subscribers</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gad49f491babc475f8d4aeea1b4452ff8b">sp_playlist_subscribers</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gae7754b74b1c3c8f5222ca43b6608ce6a">sp_playlist_subscribers_free</a> (<a class="el" href="structsp__subscribers.html">sp_subscribers</a> *subscribers)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga9ebbf147230b3ca98b68e556cf24e6bd">sp_playlist_update_subscribers</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga28456d1242693c6d890516dc782ab3ec">sp_playlist_is_in_ram</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gaf6ca8a349bdd982f6c8dda52ed691017">sp_playlist_set_in_ram</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, bool in_ram)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga342a6a0cfe10531ef7cb3c6629c1e8e7">sp_playlist_create</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *link)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga784f648f9cc431ef3b51f3491c2f169f">sp_playlist_set_offline_mode</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, bool offline)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__session.html#ga811fa52ed0fdb5cda732682e27e40417">sp_playlist_offline_status</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga7170157af21445c37a21a2241f91ff06">sp_playlist_get_offline_status</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga83ca1a25f50834f8e6f8ee1e883a8c6e">sp_playlist_get_offline_download_completed</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gacb10979add5a954e5c1600ef9c5b17a8">sp_playlist_add_ref</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gacb9250eb530869b039541a8b62dfab6c">sp_playlist_release</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga1976cb49c391cdd2dbe7c40d1bc71570">sp_playlistcontainer_add_callbacks</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, <a class="el" href="structsp__playlistcontainer__callbacks.html">sp_playlistcontainer_callbacks</a> *callbacks, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gafb5242b8f0f9964cec29d32f4d6c1164">sp_playlistcontainer_remove_callbacks</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, <a class="el" href="structsp__playlistcontainer__callbacks.html">sp_playlistcontainer_callbacks</a> *callbacks, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga7a1cbf558b2b364b8249d4ce432df700">sp_playlistcontainer_num_playlists</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gae23cb67b4b26bca663034997c4418fa8">sp_playlistcontainer_is_loaded</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga5ddd8c8064c281a14c6fd7877f522dc6">sp_playlistcontainer_playlist</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__session.html#gafdd7117213605e6f2671c4f289b44609">sp_playlist_type</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga79286860a3eeada495e97c5ad1fd7ebf">sp_playlistcontainer_playlist_type</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga852e5f5bcd4520be2e3d6d5d94def44a">sp_playlistcontainer_playlist_folder_name</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, int index, char *buffer, int buffer_size)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">sp_uint64&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga6939f9db71199612fc5a19d395e3a7f8">sp_playlistcontainer_playlist_folder_id</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga840b82b1074a7ca1c9eacd351bed24c2">sp_playlistcontainer_add_new_playlist</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, const char *name)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga87699479087915b741ceef4eebe69ad8">sp_playlistcontainer_add_playlist</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, <a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *link)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga1ae1d51c4305940ae5c5c98c12be0afc">sp_playlistcontainer_remove_playlist</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gad9be708159957d4c1e5ef905550808c5">sp_playlistcontainer_move_playlist</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, int index, int new_position, bool dry_run)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga0862502eea52fc5f2465ebad6fd98796">sp_playlistcontainer_add_folder</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, int index, const char *name)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gad4fc67d1386dd637f778f4e735a36894">sp_playlistcontainer_owner</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga2138c537a6ebcd35a01eea54d0dd1e8f">sp_playlistcontainer_add_ref</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga0311c7c3c4f26028e5edd4aacb36dbf8">sp_playlistcontainer_release</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gad9e11b45843ee4a147b43038a2e55f13">sp_playlistcontainer_get_unseen_tracks</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> **tracks, int num_tracks)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gadaad604c35e543363e1dd5b23c462db0">sp_playlistcontainer_clear_unseen_tracks</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__user.html#gad9ac5456cd129c31d2c577ba14e88f8c">sp_user_canonical_name</a> (<a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *user)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__user.html#ga0052befb81a93bb7106ca863de892610">sp_user_display_name</a> (<a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *user)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__user.html#ga0996fb9814564e4ad39b8a500cb3de21">sp_user_is_loaded</a> (<a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *user)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__user.html#ga232816a3c8f42ef2663b8d99261f2dae">sp_user_add_ref</a> (<a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *user)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__user.html#gab1ffba4355073e1f72594c9e1b22ebb4">sp_user_release</a> (<a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *user)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#gac2fe366e0050747438e09cdd22ed0e31">sp_toplistbrowse_create</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__toplist.html#ga220f32522efb2828e4f8ffb949af234a">sp_toplisttype</a> type, <a class="el" href="group__toplist.html#ga6fa5cfed2cbb33f2f64542d0b63f6c8d">sp_toplistregion</a> region, const char *username, <a class="el" href="group__toplist.html#gafe8e94ae23133105f35c03b9e3836a0a">toplistbrowse_complete_cb</a> *callback, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#gaff81156c09d311c4f6a82d28a32d7968">sp_toplistbrowse_is_loaded</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *tlb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#ga9b881929e74d97f64814ae54953ce4d7">sp_toplistbrowse_error</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *tlb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#ga421a19f128e5f3ae4b36e63a133a2a83">sp_toplistbrowse_add_ref</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *tlb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#gac6cf969c9cb6b431aeaa4723820ca8de">sp_toplistbrowse_release</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *tlb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#gae2f5c09fbbf947834b1b1e73461f1fb3">sp_toplistbrowse_num_artists</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *tlb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#ga504cc45074d40c817dffbcc2906ef57f">sp_toplistbrowse_artist</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *tlb, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#ga69f5e70269c1eb08e1ddb1c77bb8c3e3">sp_toplistbrowse_num_albums</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *tlb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#gaa080ace445d269f56942ac3d7f1f157e">sp_toplistbrowse_album</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *tlb, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#gaeb0ddfd565474dc7e444aabebbc119b7">sp_toplistbrowse_num_tracks</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *tlb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#gaf3d00b8bf089134a4f320a8d3d6ab683">sp_toplistbrowse_track</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *tlb, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#gab9cf87d6b6a8cbd8d36cd6e94a3270ee">sp_toplistbrowse_backend_request_duration</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *tlb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaec0f2e5098cebc05ce56adfc9b346510">sp_inbox</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__inbox.html#gaee29e747ca10b36597d91689ae074aa2">sp_inbox_post_tracks</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, const char *user, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *const *tracks, int num_tracks, const char *message, <a class="el" href="group__inbox.html#ga5084d6ab753294730402a0c43b82e60c">inboxpost_complete_cb</a> *callback, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__inbox.html#gaa452e9fe1fa7c9e2c780d28ce2ed63c5">sp_inbox_error</a> (<a class="el" href="group__types.html#gaec0f2e5098cebc05ce56adfc9b346510">sp_inbox</a> *inbox)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__inbox.html#gadb6b607bc26b9d362de4da09ec1c864f">sp_inbox_add_ref</a> (<a class="el" href="group__types.html#gaec0f2e5098cebc05ce56adfc9b346510">sp_inbox</a> *inbox)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__inbox.html#ga73659a65af92d30e4ac1cf3e06e74a0a">sp_inbox_release</a> (<a class="el" href="group__types.html#gaec0f2e5098cebc05ce56adfc9b346510">sp_inbox</a> *inbox)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="api_8h.html#a181d0940997cb8b69869449cd826cf88">sp_build_id</a> (void)</td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Public API for libspotify</p>
<dl class="note"><dt><b>Note:</b></dt><dd>All input strings are expected to be in UTF-8 </dd>
<dd>
All output strings are in UTF-8.</dd>
<dd>
All usernames are valid XMPP nodeprep identifiers: <a href="http://tools.ietf.org/html/rfc3920#appendix-A">http://tools.ietf.org/html/rfc3920#appendix-A</a> If you need to store user data, we strongly advise you to use the canonical form of the username. </dd></dl>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="a181d0940997cb8b69869449cd826cf88"></a><!-- doxytag: member="api.h::sp_build_id" ref="a181d0940997cb8b69869449cd826cf88" args="(void)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* sp_build_id </td>
          <td>(</td>
          <td class="paramtype">void&nbsp;</td>
          <td class="paramname"></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the libspotify build ID</p>
<p>This might be useful to have available for display somewhere in your user interface. </p>

</div>
</div>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/browse_8c-example.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: browse.c</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="headertitle">
<h1>browse.c</h1>  </div>
</div>
<div class="contents">
<p>The browse.c example shows how you can use the album, artist, and browse functions. The example also include some rudimentary playlist browsing. It is part of the spshell program</p>
<div class="fragment"><pre class="fragment">
<span class="preprocessor">#include &quot;spshell.h&quot;</span>
<span class="preprocessor">#include &quot;cmd.h&quot;</span>

<span class="keyword">static</span> <a class="code" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48" title="A track handle.">sp_track</a> *track_browse;
<span class="keyword">static</span> <a class="code" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174" title="A playlist handle.">sp_playlist</a> *playlist_browse;
<span class="keyword">static</span> <a name="_a0"></a><a class="code" href="structsp__playlist__callbacks.html">sp_playlist_callbacks</a> pl_callbacks;

<span class="keywordtype">void</span> print_track(<a class="code" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48" title="A track handle.">sp_track</a> *track)
{
    <span class="keywordtype">int</span> duration = <a name="a1"></a><a class="code" href="group__track.html#gac817937bd8d8355b6a1949b76d0b5560">sp_track_duration</a>(track);
    <span class="keywordtype">char</span> url[256];
    <a class="code" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39" title="A handle to the libspotify internal representation of a URI.">sp_link</a> *l;
    <span class="keywordtype">int</span> i;

<span class="preprocessor">#if WIN32</span>
<span class="preprocessor"></span>    printf(<span class="stringliteral">&quot; %s &quot;</span>, <a name="a2"></a><a class="code" href="group__track.html#gab17d380ac941e102af0f308ad885b3c3">sp_track_is_starred</a>(g_session,track) ? <span class="stringliteral">&quot;*&quot;</span> : <span class="stringliteral">&quot; &quot;</span>);
<span class="preprocessor">#else</span>
<span class="preprocessor"></span>    printf(<span class="stringliteral">&quot; %s &quot;</span>, <a class="code" href="group__track.html#gab17d380ac941e102af0f308ad885b3c3">sp_track_is_starred</a>(g_session,track) ? <span class="stringliteral">&quot;★&quot;</span> : <span class="stringliteral">&quot;☆&quot;</span>);
<span class="preprocessor">#endif</span>
<span class="preprocessor"></span>    printf(<span class="stringliteral">&quot;Track %s [%d:%02d] has %d artist(s), %d%% popularity&quot;</span>,
           <a name="a3"></a><a class="code" href="group__track.html#ga8eb423d3cc2cbfb743c7f23ffb8d0fad">sp_track_name</a>(track),
           duration / 60000,
           (duration / 1000) % 60,
           <a name="a4"></a><a class="code" href="group__track.html#ga0aa945fc43e35d36cc334a52735d83b2">sp_track_num_artists</a>(track),
           <a name="a5"></a><a class="code" href="group__track.html#ga4570f08f968edbff519b44d2241d2255">sp_track_popularity</a>(track));
    
    <span class="keywordflow">if</span>(<a name="a6"></a><a class="code" href="group__track.html#ga9d464ee4a5c8836b59888952b960223a">sp_track_disc</a>(track)) 
        printf(<span class="stringliteral">&quot;, %d on disc %d&quot;</span>,
               <a name="a7"></a><a class="code" href="group__track.html#ga25c1df9d32fd58f243397740b29c3f61">sp_track_index</a>(track),
               <a class="code" href="group__track.html#ga9d464ee4a5c8836b59888952b960223a">sp_track_disc</a>(track));
    printf(<span class="stringliteral">&quot;\n&quot;</span>);

    <span class="keywordflow">for</span> (i = 0; i &lt; <a class="code" href="group__track.html#ga0aa945fc43e35d36cc334a52735d83b2">sp_track_num_artists</a>(track); i++) {
        <a class="code" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc" title="An artist handle.">sp_artist</a> *art = <a name="a8"></a><a class="code" href="group__track.html#ga67cd0c035627a1e4a54642213fdf1d75">sp_track_artist</a>(track, i);
        printf(<span class="stringliteral">&quot;\tArtist %d: %s\n&quot;</span>, i + 1, <a name="a9"></a><a class="code" href="group__artist.html#gad2895555bb48514986823733a7afe5e2">sp_artist_name</a>(art));
    }
    l = <a name="a10"></a><a class="code" href="group__link.html#ga82c29419ce70e2b504670e3d45167d5d">sp_link_create_from_track</a>(track, 0);
    <a name="a11"></a><a class="code" href="group__link.html#ga9f169be53f098adcf12f7a10b8bd3ef7">sp_link_as_string</a>(l, url, <span class="keyword">sizeof</span>(url));
    printf(<span class="stringliteral">&quot;\t\t%s\n&quot;</span>, url);
    <a name="a12"></a><a class="code" href="group__link.html#ga2b06ab16d1f6436cd8d36dbff2b5c022">sp_link_release</a>(l);
}

<span class="keyword">static</span> <span class="keywordtype">void</span> print_albumbrowse(<a class="code" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9" title="A handle to an album browse result.">sp_albumbrowse</a> *browse)
{
    <span class="keywordtype">int</span> i;

    printf(<span class="stringliteral">&quot;Album browse of \&quot;%s\&quot; (%d)\n&quot;</span>, 
           <a name="a13"></a><a class="code" href="group__album.html#ga0e828c991a8184d60026513f944e19ad">sp_album_name</a>(<a name="a14"></a><a class="code" href="group__albumbrowse.html#gaf0dadfc4edb48a3558b606e30e8bedfa">sp_albumbrowse_album</a>(browse)), 
           <a name="a15"></a><a class="code" href="group__album.html#ga2aadf934b0af43c3ef6ee98b6a8065fd">sp_album_year</a>(<a class="code" href="group__albumbrowse.html#gaf0dadfc4edb48a3558b606e30e8bedfa">sp_albumbrowse_album</a>(browse)));

    <span class="keywordflow">for</span> (i = 0; i &lt; <a name="a16"></a><a class="code" href="group__albumbrowse.html#gab53fa74ee1958dad5186be09e70ddc4a">sp_albumbrowse_num_copyrights</a>(browse); ++i)
        printf(<span class="stringliteral">&quot;  Copyright: %s\n&quot;</span>, <a name="a17"></a><a class="code" href="group__albumbrowse.html#ga34b205daa2960e8d02a6e1accd80ab92">sp_albumbrowse_copyright</a>(browse, i));

    printf(<span class="stringliteral">&quot;  Tracks: %d\n&quot;</span>, <a name="a18"></a><a class="code" href="group__albumbrowse.html#ga3fb91de745ca07d3801a57288f2d9da7">sp_albumbrowse_num_tracks</a>(browse));
    printf(<span class="stringliteral">&quot;  Review: %.60s...\n&quot;</span>, <a name="a19"></a><a class="code" href="group__albumbrowse.html#ga868f3f3263f5033ae1fba60f403be712">sp_albumbrowse_review</a>(browse));
    puts(<span class="stringliteral">&quot;&quot;</span>);

    <span class="keywordflow">for</span> (i = 0; i &lt; <a class="code" href="group__albumbrowse.html#ga3fb91de745ca07d3801a57288f2d9da7">sp_albumbrowse_num_tracks</a>(browse); ++i)
        print_track(<a name="a20"></a><a class="code" href="group__albumbrowse.html#gad3c8df4b75158bba2c06aaefa74c5aa1">sp_albumbrowse_track</a>(browse, i));

    puts(<span class="stringliteral">&quot;&quot;</span>);
}

<span class="keyword">static</span> <span class="keywordtype">void</span> print_artistbrowse(<a class="code" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b" title="A handle to an artist browse result.">sp_artistbrowse</a> *browse)
{
    <span class="keywordtype">int</span> i;

    printf(<span class="stringliteral">&quot;Artist browse of \&quot;%s\&quot;\n&quot;</span>, <a class="code" href="group__artist.html#gad2895555bb48514986823733a7afe5e2">sp_artist_name</a>(<a name="a21"></a><a class="code" href="group__artistbrowse.html#ga5f6a046b2bd261d7628582b986a9019f">sp_artistbrowse_artist</a>(browse)));

    <span class="keywordflow">for</span> (i = 0; i &lt; <a name="a22"></a><a class="code" href="group__artistbrowse.html#ga2559638742416ac621af0e919e017d17">sp_artistbrowse_num_similar_artists</a>(browse); ++i)
        printf(<span class="stringliteral">&quot;  Similar artist: %s\n&quot;</span>, <a class="code" href="group__artist.html#gad2895555bb48514986823733a7afe5e2">sp_artist_name</a>(<a name="a23"></a><a class="code" href="group__artistbrowse.html#gac60ef4f9e006a920f1d72b6098743fbc">sp_artistbrowse_similar_artist</a>(browse, i)));

    printf(<span class="stringliteral">&quot;  Portraits: %d\n&quot;</span>, <a name="a24"></a><a class="code" href="group__artistbrowse.html#ga98dc47d36d2789999bfe62707c5041d7">sp_artistbrowse_num_portraits</a>(browse));
    printf(<span class="stringliteral">&quot;  Tracks   : %d\n&quot;</span>, <a name="a25"></a><a class="code" href="group__artistbrowse.html#ga8c862caa2234125ffcc4e93287b1e029">sp_artistbrowse_num_tracks</a>(browse));
    printf(<span class="stringliteral">&quot;  Biography: %.60s...\n&quot;</span>, <a name="a26"></a><a class="code" href="group__artistbrowse.html#ga8b93b9e5630662855f35694280ba4d2b">sp_artistbrowse_biography</a>(browse));
    puts(<span class="stringliteral">&quot;&quot;</span>);

    <span class="keywordflow">for</span> (i = 0; i &lt; <a class="code" href="group__artistbrowse.html#ga8c862caa2234125ffcc4e93287b1e029">sp_artistbrowse_num_tracks</a>(browse); ++i)
        print_track(<a name="a27"></a><a class="code" href="group__artistbrowse.html#ga45d28771a856f935dc40ab40e27dec4c">sp_artistbrowse_track</a>(browse, i));

    puts(<span class="stringliteral">&quot;&quot;</span>);
}



<span class="keyword">static</span> <span class="keywordtype">void</span> SP_CALLCONV browse_album_callback(<a class="code" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9" title="A handle to an album browse result.">sp_albumbrowse</a> *browse, <span class="keywordtype">void</span> *userdata)
{
    <span class="keywordflow">if</span> (<a name="a28"></a><a class="code" href="group__albumbrowse.html#ga153417eee319e7711b66503f88fba88b">sp_albumbrowse_error</a>(browse) == <a name="a29"></a><a class="code" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba16cb277dc84328e4b2c0cf6d5a0c0b8d" title="No errors encountered.">SP_ERROR_OK</a>)
        print_albumbrowse(browse);
    <span class="keywordflow">else</span>
        fprintf(stderr, <span class="stringliteral">&quot;Failed to browse album: %s\n&quot;</span>,
                <a name="a30"></a><a class="code" href="group__error.html#ga983dee341d3c2008830513b7cffe7bf3">sp_error_message</a>(<a class="code" href="group__albumbrowse.html#ga153417eee319e7711b66503f88fba88b">sp_albumbrowse_error</a>(browse)));

    <a name="a31"></a><a class="code" href="group__albumbrowse.html#gabdd5a4e3b2098166b67e35979f59613d">sp_albumbrowse_release</a>(browse);
    cmd_done();
}


<span class="keyword">static</span> <span class="keywordtype">void</span> SP_CALLCONV browse_artist_callback(<a class="code" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b" title="A handle to an artist browse result.">sp_artistbrowse</a> *browse, <span class="keywordtype">void</span> *userdata)
{
    <span class="keywordflow">if</span> (<a name="a32"></a><a class="code" href="group__artistbrowse.html#ga203e757088ff7a5098f16a1367da25d2">sp_artistbrowse_error</a>(browse) == <a class="code" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba16cb277dc84328e4b2c0cf6d5a0c0b8d" title="No errors encountered.">SP_ERROR_OK</a>)
        print_artistbrowse(browse);
    <span class="keywordflow">else</span>
        fprintf(stderr, <span class="stringliteral">&quot;Failed to browse artist: %s\n&quot;</span>,
                <a class="code" href="group__error.html#ga983dee341d3c2008830513b7cffe7bf3">sp_error_message</a>(<a class="code" href="group__artistbrowse.html#ga203e757088ff7a5098f16a1367da25d2">sp_artistbrowse_error</a>(browse)));

    <a name="a33"></a><a class="code" href="group__artistbrowse.html#ga14626a4f6a60b1caf61cb54c26783671">sp_artistbrowse_release</a>(browse);
    cmd_done();
}



<span class="keyword">static</span> <span class="keywordtype">void</span> track_browse_try(<span class="keywordtype">void</span>)
{
    <span class="keywordflow">switch</span> (<a name="a34"></a><a class="code" href="group__track.html#ga947c0f7755b0c4955ca0b0993db0f2b5">sp_track_error</a>(track_browse)) {
    <span class="keywordflow">case</span> <a class="code" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba16cb277dc84328e4b2c0cf6d5a0c0b8d" title="No errors encountered.">SP_ERROR_OK</a>:
        print_track(track_browse);
        <span class="keywordflow">break</span>;

    <span class="keywordflow">case</span> <a name="a35"></a><a class="code" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba17f54c30d01baedc24547e62ed417cdd" title="The resource is currently loading.">SP_ERROR_IS_LOADING</a>:
        <span class="keywordflow">return</span>; <span class="comment">// Still pending</span>

    <span class="keywordflow">default</span>:
        fprintf(stderr, <span class="stringliteral">&quot;Unable to resolve track: %s\n&quot;</span>, <a class="code" href="group__error.html#ga983dee341d3c2008830513b7cffe7bf3">sp_error_message</a>(<a class="code" href="group__track.html#ga947c0f7755b0c4955ca0b0993db0f2b5">sp_track_error</a>(track_browse)));
        <span class="keywordflow">break</span>;
    }
    
    metadata_updated_fn = NULL;
    cmd_done();
    <a name="a36"></a><a class="code" href="group__track.html#gaa11098d82e6c2ae42fc2ea1486e741de">sp_track_release</a>(track_browse);
}



<span class="keyword">static</span> <span class="keywordtype">void</span> playlist_browse_try(<span class="keywordtype">void</span>)
{
    <span class="keywordtype">int</span> i, tracks;

    metadata_updated_fn = playlist_browse_try;
    <span class="keywordflow">if</span>(!<a name="a37"></a><a class="code" href="group__playlist.html#gaee8ea6c07dfdca3397e27b278fa4870a">sp_playlist_is_loaded</a>(playlist_browse)) {
        printf(<span class="stringliteral">&quot;\tPlaylist not loaded\n&quot;</span>);
        <span class="keywordflow">return</span>;
    }

    tracks = <a name="a38"></a><a class="code" href="group__playlist.html#ga684a3acc60f99b3b26488ed813ee5d23">sp_playlist_num_tracks</a>(playlist_browse);
    <span class="keywordflow">for</span>(i = 0; i &lt; tracks; i++) {
        <a class="code" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48" title="A track handle.">sp_track</a> *t = <a name="a39"></a><a class="code" href="group__playlist.html#ga7a03854fe6072476306780d23c6cac16">sp_playlist_track</a>(playlist_browse, i);
        <span class="keywordflow">if</span> (!<a name="a40"></a><a class="code" href="group__track.html#ga8b69cf193679c7e00031ae43e61c6a54">sp_track_is_loaded</a>(t))
            <span class="keywordflow">return</span>;
    }

    printf(<span class="stringliteral">&quot;\tPlaylist and metadata loaded\n&quot;</span>);

    <span class="keywordflow">for</span>(i = 0; i &lt; tracks; i++) {
        <a class="code" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48" title="A track handle.">sp_track</a> *t = <a class="code" href="group__playlist.html#ga7a03854fe6072476306780d23c6cac16">sp_playlist_track</a>(playlist_browse, i);
        
        printf(<span class="stringliteral">&quot; %5d: &quot;</span>, i + 1);
        print_track(t);
    }
    <a name="a41"></a><a class="code" href="group__playlist.html#ga7fcbf909a0fa8bf25f0b1d1e7dd0e160">sp_playlist_remove_callbacks</a>(playlist_browse, &amp;pl_callbacks, NULL);

    <a name="a42"></a><a class="code" href="group__playlist.html#gacb9250eb530869b039541a8b62dfab6c">sp_playlist_release</a>(playlist_browse);
    playlist_browse = NULL;
    metadata_updated_fn = NULL;
    cmd_done();
}

<span class="keyword">static</span> <span class="keywordtype">void</span> SP_CALLCONV pl_tracks_added(<a class="code" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174" title="A playlist handle.">sp_playlist</a> *pl, <a class="code" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48" title="A track handle.">sp_track</a> * <span class="keyword">const</span> * tracks,
                <span class="keywordtype">int</span> num_tracks, <span class="keywordtype">int</span> position, <span class="keywordtype">void</span> *userdata)
{
    printf(<span class="stringliteral">&quot;\t%d tracks added\n&quot;</span>, num_tracks);
}

<span class="keyword">static</span> <span class="keywordtype">void</span> SP_CALLCONV pl_tracks_removed(<a class="code" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174" title="A playlist handle.">sp_playlist</a> *pl, <span class="keyword">const</span> <span class="keywordtype">int</span> *tracks,
                  <span class="keywordtype">int</span> num_tracks, <span class="keywordtype">void</span> *userdata)
{
    printf(<span class="stringliteral">&quot;\t%d tracks removed\n&quot;</span>, num_tracks);
}

<span class="keyword">static</span> <span class="keywordtype">void</span> SP_CALLCONV pl_tracks_moved(<a class="code" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174" title="A playlist handle.">sp_playlist</a> *pl, <span class="keyword">const</span> <span class="keywordtype">int</span> *tracks,
                <span class="keywordtype">int</span> num_tracks, <span class="keywordtype">int</span> new_position, <span class="keywordtype">void</span> *userdata)
{
    printf(<span class="stringliteral">&quot;\t%d tracks moved\n&quot;</span>, num_tracks);
}

<span class="keyword">static</span> <span class="keywordtype">void</span> SP_CALLCONV pl_renamed(<a class="code" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174" title="A playlist handle.">sp_playlist</a> *pl, <span class="keywordtype">void</span> *userdata)
{
    printf(<span class="stringliteral">&quot;\tList name: %s\n&quot;</span>,  <a name="a43"></a><a class="code" href="group__playlist.html#ga61b7e33cc1aedb4e31a2af75ae0ac8cc">sp_playlist_name</a>(pl));
}

<span class="keyword">static</span> <span class="keywordtype">void</span> SP_CALLCONV pl_state_change(<a class="code" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174" title="A playlist handle.">sp_playlist</a> *pl, <span class="keywordtype">void</span> *userdata)
{
    playlist_browse_try();
}

<span class="keyword">static</span> <a class="code" href="structsp__playlist__callbacks.html">sp_playlist_callbacks</a> pl_callbacks = {
    pl_tracks_added,
    pl_tracks_removed,
    pl_tracks_moved,
    pl_renamed,
    pl_state_change,
};


<span class="keywordtype">void</span> browse_playlist(<a class="code" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174" title="A playlist handle.">sp_playlist</a> *pl)
{
    playlist_browse = pl;
    <a name="a44"></a><a class="code" href="group__playlist.html#gab15fca12d387c69b4998a4d2b48e5b32">sp_playlist_add_callbacks</a>(playlist_browse, &amp;pl_callbacks, NULL);
    playlist_browse_try();
}

<span class="keyword">static</span> <span class="keywordtype">void</span> browse_usage(<span class="keywordtype">void</span>)
{
    fprintf(stderr, <span class="stringliteral">&quot;Usage: browse &lt;spotify-uri&gt;\n&quot;</span>);
}


<span class="keywordtype">int</span> cmd_browse(<span class="keywordtype">int</span> argc, <span class="keywordtype">char</span> **argv)
{
    <a class="code" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39" title="A handle to the libspotify internal representation of a URI.">sp_link</a> *link;

    <span class="keywordflow">if</span> (argc != 2) {
        browse_usage();
        <span class="keywordflow">return</span> -1;
    }

    
    link = <a name="a45"></a><a class="code" href="group__link.html#gaea9c39f35f7986fc9fed4584fa211127">sp_link_create_from_string</a>(argv[1]);
    
    <span class="keywordflow">if</span> (!link) {
        fprintf(stderr, <span class="stringliteral">&quot;Not a spotify link\n&quot;</span>);
        <span class="keywordflow">return</span> -1;
    }

    <span class="keywordflow">switch</span>(<a name="a46"></a><a class="code" href="group__link.html#ga6140f924c696d53469bb8930cd53e1e6">sp_link_type</a>(link)) {
    <span class="keywordflow">default</span>:
        fprintf(stderr, <span class="stringliteral">&quot;Can not handle link&quot;</span>);
        <a class="code" href="group__link.html#ga2b06ab16d1f6436cd8d36dbff2b5c022">sp_link_release</a>(link);
        <span class="keywordflow">return</span> -1;

    <span class="keywordflow">case</span> <a name="a47"></a><a class="code" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a7716eb95eed852d08300e6e64febc7f3" title="Link type is album.">SP_LINKTYPE_ALBUM</a>:
        <a name="a48"></a><a class="code" href="group__albumbrowse.html#gaf1bc3042e748efea5ca7ac159e5cbfbe">sp_albumbrowse_create</a>(g_session, <a name="a49"></a><a class="code" href="group__link.html#gaafa98628d0abadcca27dd3b227c7337b">sp_link_as_album</a>(link), browse_album_callback, NULL);
        <span class="keywordflow">break</span>;

    <span class="keywordflow">case</span> <a name="a50"></a><a class="code" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a4402b3b001aebb39fd55296f83c60b7e" title="Link type is artist.">SP_LINKTYPE_ARTIST</a>:
        <a name="a51"></a><a class="code" href="group__artistbrowse.html#ga8dd8364b2fcd29c846209660bd9a69b2">sp_artistbrowse_create</a>(g_session, <a name="a52"></a><a class="code" href="group__link.html#gab32979d26dcf68936202fa7aed7b6e49">sp_link_as_artist</a>(link), <a name="a53"></a><a class="code" href="group__session.html#ggac86504cc9e8cadbc30c8aa8dbf355034a2914168528aded818177c013a0dd7e87">SP_ARTISTBROWSE_FULL</a>, browse_artist_callback, NULL);
        <span class="keywordflow">break</span>;

    <span class="keywordflow">case</span> <a name="a54"></a><a class="code" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a0698cd0123190c7af55daf79bb642805" title="Link type is a local file.">SP_LINKTYPE_LOCALTRACK</a>:
    <span class="keywordflow">case</span> <a name="a55"></a><a class="code" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a5911dbb7258ed160b2f9c114cef152f1" title="Link type is track.">SP_LINKTYPE_TRACK</a>:
        track_browse = <a name="a56"></a><a class="code" href="group__link.html#ga2560687997d7ce0fbf4f05251d87d32a">sp_link_as_track</a>(link);
        metadata_updated_fn = track_browse_try;
        <a name="a57"></a><a class="code" href="group__track.html#ga7d86041a2bf75590f55978521c08e38c">sp_track_add_ref</a>(track_browse);
        track_browse_try();
        <span class="keywordflow">break</span>;

    <span class="keywordflow">case</span> <a name="a58"></a><a class="code" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a2640ed065a64b6a9f67e71bbeb2af2dd" title="Link type is playlist.">SP_LINKTYPE_PLAYLIST</a>:
        browse_playlist(<a name="a59"></a><a class="code" href="group__playlist.html#ga342a6a0cfe10531ef7cb3c6629c1e8e7">sp_playlist_create</a>(g_session, link));
        <span class="keywordflow">break</span>;
    }

    <a class="code" href="group__link.html#ga2b06ab16d1f6436cd8d36dbff2b5c022">sp_link_release</a>(link);
    <span class="keywordflow">return</span> 0;
}
</pre></div> </div>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/classes.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Alphabetical List</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li class="current"><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="functions.html"><span>Data&nbsp;Fields</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="headertitle">
<h1>Data Structure Index</h1>  </div>
</div>
<div class="contents">
<div class="qindex"><a class="qindex" href="#letter_S">S</a></div>
<table align="center" width="95%" border="0" cellspacing="0" cellpadding="0">
<tr><td><a name="letter_S"></a><table border="0" cellspacing="0" cellpadding="0"><tr><td><div class="ah">&nbsp;&nbsp;S&nbsp;&nbsp;</div></td></tr></table>
</td><td><a class="el" href="structsp__audioformat.html">sp_audioformat</a>&nbsp;&nbsp;&nbsp;</td><td><a class="el" href="structsp__playlist__callbacks.html">sp_playlist_callbacks</a>&nbsp;&nbsp;&nbsp;</td><td><a class="el" href="structsp__session__callbacks.html">sp_session_callbacks</a>&nbsp;&nbsp;&nbsp;</td><td><a class="el" href="structsp__subscribers.html">sp_subscribers</a>&nbsp;&nbsp;&nbsp;</td></tr><tr><td><a class="el" href="structsp__audio__buffer__stats.html">sp_audio_buffer_stats</a>&nbsp;&nbsp;&nbsp;</td><td><a class="el" href="structsp__offline__sync__status.html">sp_offline_sync_status</a>&nbsp;&nbsp;&nbsp;</td><td><a class="el" href="structsp__playlistcontainer__callbacks.html">sp_playlistcontainer_callbacks</a>&nbsp;&nbsp;&nbsp;</td><td><a class="el" href="structsp__session__config.html">sp_session_config</a>&nbsp;&nbsp;&nbsp;</td></tr></table><div class="qindex"><a class="qindex" href="#letter_S">S</a></div>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/doxygen.css
================================================
/* Copyright (c) 2009 Spotify Ltd */
body { margin:0; background:#fff; color:#444; padding:0; }
body,h1,h2,h3,h4,h5,p,td,li { font-family:'Helvetica neue',sans-serif; color:#000; }
body,td,p,li,div { line-height:1.5em; font-size:14px; color:#444; }

/* @group Heading Levels */
h1,h2,h3,h4,h5 { color:#222; }
h1 > a, h2 > a, h3 > a, h4 > a { color:#222; }
h1 { font-size: 180%; }
h2 { font-size: 150%; margin-top:2em; }
td h2 { margin-top:0.5em; font-weight:normal; }
h3 { font-size: 120%; }

/* @end */

caption { font-weight: bold; }

div.qindex, div.navtab {
  background-color: #e8eef2;
  border: 1px solid #84b0c7;
  text-align: center;
  margin: 2px;
  padding: 2px;
}
div.qindex, div.navpath { width:100%; line-height:140%; }
div.navtab { margin-right: 15px; }
div.contents { margin:0 3em; }

/* @group Link Styling */

div.contents a { text-decoration:none; }
div.contents a:link { color:#266a99; }
div.contents a:hover { text-decoration:underline; }
div.contents a:visited { color:#606a99; }
div.contents a:link:hover { color:#006be4; background:#e2f4ff; }
div.contents a:visited:hover { color:#af00cf; background:#f4e6ff; }

a.qindex { font-weight: bold; }
a.qindexHL {
  font-weight: bold;
  background-color: #6666cc;
  color: #ffffff;
  border: 1px double #9295C2;
}
.contents a.qindexHL:visited { color: #ffffff; }
a.el { font-weight: bold; }
a.elRef {}
a.code {}
a.codeRef {}

/* @end */

dl.el { margin-left: -1cm; }
.fragment { font-family: monospace, fixed; }
pre.fragment {
  border: 3px solid #fff;
  background-color: #f0f3d9;
  color:#38330b;
  padding: 1em;
  margin: 1em 0;
}
div.ah {
  background-color: black;
  font-weight: bold;
  color: #ffffff;
  margin-bottom: 3px;
  margin-top: 3px
}

div.groupHeader {
  margin-left: 16px;
  margin-top: 12px;
  margin-bottom: 6px;
  font-weight: bold;
}
div.groupText { margin-left: 16px; font-style: italic; }

div.navigation { margin-bottom:2em; }

td.indexkey {
  background-color: #e8eef2;
  font-weight: bold;
  border: 1px solid #CCCCCC;
  margin: 2px 0px 2px 0;
  padding: 2px 10px;
}
td.indexvalue {
  background-color: #e8eef2;
  border: 1px solid #CCCCCC;
  padding: 2px 10px;
  margin: 2px 0px;
}

tr.memlist { background-color: #f0f0f0; }
p.formulaDsp { text-align: center; }
img.formulaDsp {}
img.formulaInl { vertical-align: middle; }

/* @group Code Colorization */
span.keyword { color: #2550b0; }
span.keywordtype { color: #604020; }
span.keywordflow { color: #9d5303; }
span.comment { color: #8f9277; font-style:italic; }
span.preprocessor { color: #806020; }
span.stringliteral { color: #1d783b; }
span.charliteral { color: #008080; }
span.vhdldigit { color: #ff00ff; }
span.vhdlchar { color: #000000; }
span.vhdlkeyword { color: #700070; }
span.vhdllogic { color: #ff0000; }

/* @end */
.search { color:#003399; font-weight:bold; }
form.search { margin-bottom:0px; margin-top:0px; }
input.search {
  font-size:75%;
  color:#000080;
  font-weight:normal;
  background-color:#e8eef2;
}
td.tiny { font-size: 75%; }
.dirtab {
  padding: 4px;
  border-collapse: collapse;
  border: 1px solid #84b0c7;
}
th.dirtab { background: #e8eef2; font-weight: bold; }
hr { height:0; border:none; border-top:1px solid #ccc; }

/* @group Member Descriptions */
.mdescLeft, .mdescRight,
.memItemLeft, .memItemRight,
.memTemplItemLeft, .memTemplItemRight, .memTemplParams {
  background-color: #eee;
  border: none;
  margin: 4px;
  padding: 0.2em;
  font-family:monospace;
}
.mdescLeft, .memItemLeft, .memTemplItemLeft { padding-left:1em; }
.mdescRight, .memItemRight, .memTemplItemRight { padding-right:1em; }
.mdescLeft, .mdescRight { padding: 0px 8px 4px 8px; color: #555; }
.memItemLeft, .memItemRight, .memTemplParams { border-top: 1px solid #ccc; }
.memTemplParams { color: #606060; }

/* @end */

/* @group Member Details */

/* Styles for detailed member documentation */
.memtemplate {
  font-size: 80%;
  color: #606060;
  font-weight: normal;
  margin-left: 3px;
}
.memnav {
  background-color: #e8eef2;
  border: 1px solid #84b0c7;
  text-align: center;
  margin: 2px;
  margin-right: 15px;
  padding: 2px;
}
.memitem { padding: 0; }
.memname { white-space:nowrap; font-weight:bold; }
.memproto, .memdoc {}
.memproto {
  padding: 0.3em 0.8em;
  background-color: #cae2c9;
  font-weight: bold;
  -webkit-border-top-left-radius: 8px;
  -webkit-border-top-right-radius: 8px;
  -moz-border-radius-topleft: 8px;
  -moz-border-radius-topright: 8px;
}
.memproto td { font-family:monospace; }
.memproto td, .memdoc td { color:#103a0f; }
.memdoc {
  padding: 0.3em 0.8em;
  background-color: #eaf5e9;
  border-top-width: 0;
  -webkit-border-bottom-left-radius: 8px;
  -webkit-border-bottom-right-radius: 8px;
  -moz-border-radius-bottomleft: 8px;
  -moz-border-radius-bottomright: 8px;
}

.paramkey { text-align:right; }
.paramtype { white-space:nowrap; }
.paramname { color:#602020; white-space:nowrap; }
.paramname em { font-style: normal; }

/* @end */

/* @group Directory (tree) */

/* for the tree view */
.ftvtree { font-family:sans-serif; margin:0.5em; }

/* these are for tree view when used as main index */
.directory { font-size: 9pt; font-weight: bold; }
.directory h3 { margin: 0px; margin-top: 1em;  font-size: 11pt; }

/*
The following two styles can be used to replace the root node title
with an image of your choice.  Simply uncomment the next two styles,
specify the name of your image and be sure to set 'height' to the
proper pixel height of your image.
*/

/*
.directory h3.swap {
  height: 61px;
  background-repeat: no-repeat;
  background-image: url("yourimage.gif");
}
.directory h3.swap span { display: none; }
*/

.directory > h3 { margin-top: 0; }
.directory p { margin: 0px; white-space: nowrap; }
.directory div { display: none; margin: 0px; }
.directory img { vertical-align:-30%; }

/* these are for tree view when not used as main index */
.directory-alt { font-size: 100%; font-weight: bold; }
.directory-alt h3 { margin: 0px; margin-top: 1em; font-size: 11pt; }
.directory-alt > h3 { margin-top: 0; }
.directory-alt p { margin: 0px; white-space: nowrap; }
.directory-alt div { display: none; margin: 0px; }
.directory-alt img { vertical-align: -30%; }

/* @end */

/* Footer */
body > hr { margin-top:4em; }
body > address {
  padding:0 3em;
  font-style: normal;
  color: #999;
  margin-bottom:.5em;
  text-align:left !important;
}
body > address br { display:none; }

/* print */
@media print {
  div.contents {
    padding-left:10%;
    padding-right:6%;
  }
}


================================================
FILE: libspotify/docs/html/examples.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Examples</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li class="current"><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="headertitle">
<h1>Examples</h1>  </div>
</div>
<div class="contents">
Here is a list of all examples:<ul>
<li><a class="el" href="browse_8c-example.html">browse.c</a></li>

<li><a class="el" href="jukebox_8c-example.html">jukebox.c</a></li>

<li><a class="el" href="search_8c-example.html">search.c</a></li>

<li><a class="el" href="toplist_8c-example.html">toplist.c</a></li>

</ul>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/files.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: File Index</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li class="current"><a href="files.html"><span>File&nbsp;List</span></a></li>
      <li><a href="globals.html"><span>Globals</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="headertitle">
<h1>File List</h1>  </div>
</div>
<div class="contents">
Here is a list of all documented files with brief descriptions:<table>
  <tr><td class="indexkey"><a class="el" href="api_8h.html">api.h</a></td><td class="indexvalue"></td></tr>
</table>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/functions.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Data Fields</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li class="current"><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li class="current"><a href="functions.html"><span>Data&nbsp;Fields</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li class="current"><a href="functions.html"><span>All</span></a></li>
      <li><a href="functions_vars.html"><span>Variables</span></a></li>
    </ul>
  </div>
  <div class="tabs3">
    <ul class="tablist">
      <li><a href="#index_a"><span>a</span></a></li>
      <li><a href="#index_c"><span>c</span></a></li>
      <li><a href="#index_d"><span>d</span></a></li>
      <li><a href="#index_e"><span>e</span></a></li>
      <li><a href="#index_g"><span>g</span></a></li>
      <li><a href="#index_i"><span>i</span></a></li>
      <li><a href="#index_l"><span>l</span></a></li>
      <li><a href="#index_m"><span>m</span></a></li>
      <li><a href="#index_n"><span>n</span></a></li>
      <li><a href="#index_o"><span>o</span></a></li>
      <li><a href="#index_p"><span>p</span></a></li>
      <li><a href="#index_q"><span>q</span></a></li>
      <li><a href="#index_s"><span>s</span></a></li>
      <li><a href="#index_t"><span>t</span></a></li>
      <li><a href="#index_u"><span>u</span></a></li>
      <li><a href="#index_w"><span>w</span></a></li>
    </ul>
  </div>
</div>
<div class="contents">
Here is a list of all documented struct and union fields with links to the struct/union documentation for each field:

<h3><a class="anchor" id="index_a"></a>- a -</h3><ul>
<li>api_version
: <a class="el" href="structsp__session__config.html#a1ed9d4ff26e6f666ba96dce41d5f1bac">sp_session_config</a>
</li>
<li>application_key
: <a class="el" href="structsp__session__config.html#ab5a5296a8e34bb454e7575940a19b9ae">sp_session_config</a>
</li>
<li>application_key_size
: <a class="el" href="structsp__session__config.html#ab10b332fe29b941162fd1d9ea1003b82">sp_session_config</a>
</li>
</ul>


<h3><a class="anchor" id="index_c"></a>- c -</h3><ul>
<li>ca_certs_filename
: <a class="el" href="structsp__session__config.html#a4a94ad4270e5401e68587952661bd3ca">sp_session_config</a>
</li>
<li>cache_location
: <a class="el" href="structsp__session__config.html#ad1cb5e3670451d8cee3d8c9766b523fc">sp_session_config</a>
</li>
<li>callbacks
: <a class="el" href="structsp__session__config.html#af0b456e6b9228ed812cd8ad28acbb127">sp_session_config</a>
</li>
<li>channels
: <a class="el" href="structsp__audioformat.html#ab6b47d8d0ebfaab73229d707dc8bf0b8">sp_audioformat</a>
</li>
<li>compress_playlists
: <a class="el" href="structsp__session__config.html#a8413a38bf3db9047b45525ac5dd4bc7b">sp_session_config</a>
</li>
<li>connection_error
: <a class="el" href="structsp__session__callbacks.html#a45bf5d3fac7953099a191ea39fcfc018">sp_session_callbacks</a>
</li>
<li>connectionstate_updated
: <a class="el" href="structsp__session__callbacks.html#a379c96577e927d6c65ac61fe13c1e412">sp_session_callbacks</a>
</li>
<li>container_loaded
: <a class="el" href="structsp__playlistcontainer__callbacks.html#a8a0c301dd9cf90cccb4657a7d65c61b1">sp_playlistcontainer_callbacks</a>
</li>
<li>copied_tracks
: <a class="el" href="structsp__offline__sync__status.html#add0d4345a08fc710614be33c5a662f7c">sp_offline_sync_status</a>
</li>
<li>count
: <a class="el" href="structsp__subscribers.html#a37fd3d0daff9f2d856db1e891ce44bab">sp_subscribers</a>
</li>
<li>credentials_blob_updated
: <a class="el" href="structsp__session__callbacks.html#ae7c5c209735f5c437d76a512eebbf30b">sp_session_callbacks</a>
</li>
</ul>


<h3><a class="anchor" id="index_d"></a>- d -</h3><ul>
<li>description_changed
: <a class="el" href="structsp__playlist__callbacks.html#a07d1ebf29e1ba1f8b10c7a8c5e209f41">sp_playlist_callbacks</a>
</li>
<li>device_id
: <a class="el" href="structsp__session__config.html#af51c373555138dc4012501fa94b2bedc">sp_session_config</a>
</li>
<li>done_tracks
: <a class="el" href="structsp__offline__sync__status.html#aaeb2860d7301485d40d9f0d9bb868fbb">sp_offline_sync_status</a>
</li>
<li>dont_save_metadata_for_playlists
: <a class="el" href="structsp__session__config.html#a190139f3c0842cfe27c61ebf2da5ee9f">sp_session_config</a>
</li>
</ul>


<h3><a class="anchor" id="index_e"></a>- e -</h3><ul>
<li>end_of_track
: <a class="el" href="structsp__session__callbacks.html#a6bc198d89ff46d930c32dae950bd0294">sp_session_callbacks</a>
</li>
<li>error_tracks
: <a class="el" href="structsp__offline__sync__status.html#aa5002b69e3826edc285d19eb7ca0f582">sp_offline_sync_status</a>
</li>
</ul>


<h3><a class="anchor" id="index_g"></a>- g -</h3><ul>
<li>get_audio_buffer_stats
: <a class="el" href="structsp__session__callbacks.html#a328404ac150210387ea3f9cc973149c9">sp_session_callbacks</a>
</li>
</ul>


<h3><a class="anchor" id="index_i"></a>- i -</h3><ul>
<li>image_changed
: <a class="el" href="structsp__playlist__callbacks.html#a910203945dcd26b02b390d5413e4f5dd">sp_playlist_callbacks</a>
</li>
<li>initially_unload_playlists
: <a class="el" href="structsp__session__config.html#a3460b768cf69d1c646ac39f507e39287">sp_session_config</a>
</li>
</ul>


<h3><a class="anchor" id="index_l"></a>- l -</h3><ul>
<li>log_message
: <a class="el" href="structsp__session__callbacks.html#aae0ce9c91f2779fafa40ebd640060a05">sp_session_callbacks</a>
</li>
<li>logged_in
: <a class="el" href="structsp__session__callbacks.html#a52d509962541f7d8fdd71284f40d8415">sp_session_callbacks</a>
</li>
<li>logged_out
: <a class="el" href="structsp__session__callbacks.html#a073231e9ceb3d40f4a772ab64ba4ece7">sp_session_callbacks</a>
</li>
</ul>


<h3><a class="anchor" id="index_m"></a>- m -</h3><ul>
<li>message_to_user
: <a class="el" href="structsp__session__callbacks.html#ae5d6e4a9a4296cfcbca1e57acdb4d64d">sp_session_callbacks</a>
</li>
<li>metadata_updated
: <a class="el" href="structsp__session__callbacks.html#a09912988f00ea5e90835681b382a18fc">sp_session_callbacks</a>
</li>
<li>music_delivery
: <a class="el" href="structsp__session__callbacks.html#a33a31478b8de1882ad7847ad033fbaeb">sp_session_callbacks</a>
</li>
</ul>


<h3><a class="anchor" id="index_n"></a>- n -</h3><ul>
<li>notify_main_thread
: <a class="el" href="structsp__session__callbacks.html#a085cfd82e77aee2b592f314321019a29">sp_session_callbacks</a>
</li>
</ul>


<h3><a class="anchor" id="index_o"></a>- o -</h3><ul>
<li>offline_error
: <a class="el" href="structsp__session__callbacks.html#ad403ac063f5512b277c924add75dfbea">sp_session_callbacks</a>
</li>
<li>offline_status_updated
: <a class="el" href="structsp__session__callbacks.html#aa0f62ed875aab47e5ae093576a6d54c8">sp_session_callbacks</a>
</li>
</ul>


<h3><a class="anchor" id="index_p"></a>- p -</h3><ul>
<li>play_token_lost
: <a class="el" href="structsp__session__callbacks.html#a641fc97950305fbcd83d5114918c53b9">sp_session_callbacks</a>
</li>
<li>playlist_added
: <a class="el" href="structsp__playlistcontainer__callbacks.html#ab1ba98e60fe050aeda8edc95166dd6fe">sp_playlistcontainer_callbacks</a>
</li>
<li>playlist_metadata_updated
: <a class="el" href="structsp__playlist__callbacks.html#a0de3ae5463973647c114d5fdc85ade87">sp_playlist_callbacks</a>
</li>
<li>playlist_moved
: <a class="el" href="structsp__playlistcontainer__callbacks.html#a64889a47ae2023e21be1ca4a8024c663">sp_playlistcontainer_callbacks</a>
</li>
<li>playlist_removed
: <a class="el" href="structsp__playlistcontainer__callbacks.html#ad49b8c0f44f6c05e4ab3562b023f0928">sp_playlistcontainer_callbacks</a>
</li>
<li>playlist_renamed
: <a class="el" href="structsp__playlist__callbacks.html#a25e98e4355cf2d3503c7ac708c8104cf">sp_playlist_callbacks</a>
</li>
<li>playlist_state_changed
: <a class="el" href="structsp__playlist__callbacks.html#a7ff55580625a755b196336a551d210d4">sp_playlist_callbacks</a>
</li>
<li>playlist_update_in_progress
: <a class="el" href="structsp__playlist__callbacks.html#ab07f7eb6c283523afb37d683932b62d4">sp_playlist_callbacks</a>
</li>
<li>private_session_mode_changed
: <a class="el" href="structsp__session__callbacks.html#ad04af396785f8973a3c15a68bb617830">sp_session_callbacks</a>
</li>
<li>proxy
: <a class="el" href="structsp__session__config.html#af7a09f94350796ae7dde15a6518f51e2">sp_session_config</a>
</li>
<li>proxy_password
: <a class="el" href="structsp__session__config.html#a33f2d3aa26d3db999b3026529aa5d670">sp_session_config</a>
</li>
<li>proxy_username
: <a class="el" href="structsp__session__config.html#a393cd7cf64c064f1647fe0045ac0d5cb">sp_session_config</a>
</li>
</ul>


<h3><a class="anchor" id="index_q"></a>- q -</h3><ul>
<li>queued_tracks
: <a class="el" href="structsp__offline__sync__status.html#a44a8a719c66266763ed184b575abce61">sp_offline_sync_status</a>
</li>
</ul>


<h3><a class="anchor" id="index_s"></a>- s -</h3><ul>
<li>sample_rate
: <a class="el" href="structsp__audioformat.html#a2eb66d38a418d5c0afe284d4d45a619d">sp_audioformat</a>
</li>
<li>sample_type
: <a class="el" href="structsp__audioformat.html#af128862563608ee7e41a6d6a4e6133bc">sp_audioformat</a>
</li>
<li>samples
: <a class="el" href="structsp__audio__buffer__stats.html#a1ff9dcc75ace1cc954138fedc4c8f854">sp_audio_buffer_stats</a>
</li>
<li>scrobble_error
: <a class="el" href="structsp__session__callbacks.html#a01a47778439fa233187fdefa75a0f7dc">sp_session_callbacks</a>
</li>
<li>settings_location
: <a class="el" href="structsp__session__config.html#a342532432040d476aaaf73f10893d23b">sp_session_config</a>
</li>
<li>start_playback
: <a class="el" href="structsp__session__callbacks.html#adcfcee6abf1b6f408010e5615d2a79c8">sp_session_callbacks</a>
</li>
<li>stop_playback
: <a class="el" href="structsp__session__callbacks.html#a2a225bc017266c935c05d18142f27ad6">sp_session_callbacks</a>
</li>
<li>streaming_error
: <a class="el" href="structsp__session__callbacks.html#a003db54ec10236a3e3d77bfbf31f38ae">sp_session_callbacks</a>
</li>
<li>stutter
: <a class="el" href="structsp__audio__buffer__stats.html#a85f67e5b11d5ba63b4a94f01a5009d96">sp_audio_buffer_stats</a>
</li>
<li>subscribers
: <a class="el" href="structsp__subscribers.html#aaac89593785dc926976885dfd33efb0c">sp_subscribers</a>
</li>
<li>subscribers_changed
: <a class="el" href="structsp__playlist__callbacks.html#ae33cb7f8ebc9eac186c9f22272d093c3">sp_playlist_callbacks</a>
</li>
<li>syncing
: <a class="el" href="structsp__offline__sync__status.html#a5a2a99fdb8eeb38b3c73a44c6df68d06">sp_offline_sync_status</a>
</li>
</ul>


<h3><a class="anchor" id="index_t"></a>- t -</h3><ul>
<li>tracefile
: <a class="el" href="structsp__session__config.html#aa7df4256deac84eea21053a7ca2cc3da">sp_session_config</a>
</li>
<li>track_created_changed
: <a class="el" href="structsp__playlist__callbacks.html#a152a3b599f22f4040ff0581c6927d12e">sp_playlist_callbacks</a>
</li>
<li>track_message_changed
: <a class="el" href="structsp__playlist__callbacks.html#ad26fb637a16ed0590bdf7936dfcad82d">sp_playlist_callbacks</a>
</li>
<li>track_seen_changed
: <a class="el" href="structsp__playlist__callbacks.html#ab78eaf42523f53bb5931eaff8dcdea8b">sp_playlist_callbacks</a>
</li>
<li>tracks_added
: <a class="el" href="structsp__playlist__callbacks.html#a16c3e5758f8f73f5900de4b88424f85e">sp_playlist_callbacks</a>
</li>
<li>tracks_moved
: <a class="el" href="structsp__playlist__callbacks.html#ac3d51200f7a813cce810561132dba4e9">sp_playlist_callbacks</a>
</li>
<li>tracks_removed
: <a class="el" href="structsp__playlist__callbacks.html#a8f7decf111d725363c968ae4e7b15795">sp_playlist_callbacks</a>
</li>
</ul>


<h3><a class="anchor" id="index_u"></a>- u -</h3><ul>
<li>user_agent
: <a class="el" href="structsp__session__config.html#a69d5b5aa58c901d7916bdea6e5b75c88">sp_session_config</a>
</li>
<li>userdata
: <a class="el" href="structsp__session__config.html#a931b9a253380fdf910afc715e2c2d040">sp_session_config</a>
</li>
<li>userinfo_updated
: <a class="el" href="structsp__session__callbacks.html#a8685310c1755044ec0ea0e316de8be6e">sp_session_callbacks</a>
</li>
</ul>


<h3><a class="anchor" id="index_w"></a>- w -</h3><ul>
<li>willnotcopy_tracks
: <a class="el" href="structsp__offline__sync__status.html#aa56788dbda2c99047cc79282caf3ffd6">sp_offline_sync_status</a>
</li>
</ul>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/functions_vars.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Data Fields - Variables</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li class="current"><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li class="current"><a href="functions.html"><span>Data&nbsp;Fields</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="functions.html"><span>All</span></a></li>
      <li class="current"><a href="functions_vars.html"><span>Variables</span></a></li>
    </ul>
  </div>
  <div class="tabs3">
    <ul class="tablist">
      <li><a href="#index_a"><span>a</span></a></li>
      <li><a href="#index_c"><span>c</span></a></li>
      <li><a href="#index_d"><span>d</span></a></li>
      <li><a href="#index_e"><span>e</span></a></li>
      <li><a href="#index_g"><span>g</span></a></li>
      <li><a href="#index_i"><span>i</span></a></li>
      <li><a href="#index_l"><span>l</span></a></li>
      <li><a href="#index_m"><span>m</span></a></li>
      <li><a href="#index_n"><span>n</span></a></li>
      <li><a href="#index_o"><span>o</span></a></li>
      <li><a href="#index_p"><span>p</span></a></li>
      <li><a href="#index_q"><span>q</span></a></li>
      <li><a href="#index_s"><span>s</span></a></li>
      <li><a href="#index_t"><span>t</span></a></li>
      <li><a href="#index_u"><span>u</span></a></li>
      <li><a href="#index_w"><span>w</span></a></li>
    </ul>
  </div>
</div>
<div class="contents">
&nbsp;

<h3><a class="anchor" id="index_a"></a>- a -</h3><ul>
<li>api_version
: <a class="el" href="structsp__session__config.html#a1ed9d4ff26e6f666ba96dce41d5f1bac">sp_session_config</a>
</li>
<li>application_key
: <a class="el" href="structsp__session__config.html#ab5a5296a8e34bb454e7575940a19b9ae">sp_session_config</a>
</li>
<li>application_key_size
: <a class="el" href="structsp__session__config.html#ab10b332fe29b941162fd1d9ea1003b82">sp_session_config</a>
</li>
</ul>


<h3><a class="anchor" id="index_c"></a>- c -</h3><ul>
<li>ca_certs_filename
: <a class="el" href="structsp__session__config.html#a4a94ad4270e5401e68587952661bd3ca">sp_session_config</a>
</li>
<li>cache_location
: <a class="el" href="structsp__session__config.html#ad1cb5e3670451d8cee3d8c9766b523fc">sp_session_config</a>
</li>
<li>callbacks
: <a class="el" href="structsp__session__config.html#af0b456e6b9228ed812cd8ad28acbb127">sp_session_config</a>
</li>
<li>channels
: <a class="el" href="structsp__audioformat.html#ab6b47d8d0ebfaab73229d707dc8bf0b8">sp_audioformat</a>
</li>
<li>compress_playlists
: <a class="el" href="structsp__session__config.html#a8413a38bf3db9047b45525ac5dd4bc7b">sp_session_config</a>
</li>
<li>connection_error
: <a class="el" href="structsp__session__callbacks.html#a45bf5d3fac7953099a191ea39fcfc018">sp_session_callbacks</a>
</li>
<li>connectionstate_updated
: <a class="el" href="structsp__session__callbacks.html#a379c96577e927d6c65ac61fe13c1e412">sp_session_callbacks</a>
</li>
<li>container_loaded
: <a class="el" href="structsp__playlistcontainer__callbacks.html#a8a0c301dd9cf90cccb4657a7d65c61b1">sp_playlistcontainer_callbacks</a>
</li>
<li>copied_tracks
: <a class="el" href="structsp__offline__sync__status.html#add0d4345a08fc710614be33c5a662f7c">sp_offline_sync_status</a>
</li>
<li>count
: <a class="el" href="structsp__subscribers.html#a37fd3d0daff9f2d856db1e891ce44bab">sp_subscribers</a>
</li>
<li>credentials_blob_updated
: <a class="el" href="structsp__session__callbacks.html#ae7c5c209735f5c437d76a512eebbf30b">sp_session_callbacks</a>
</li>
</ul>


<h3><a class="anchor" id="index_d"></a>- d -</h3><ul>
<li>description_changed
: <a class="el" href="structsp__playlist__callbacks.html#a07d1ebf29e1ba1f8b10c7a8c5e209f41">sp_playlist_callbacks</a>
</li>
<li>device_id
: <a class="el" href="structsp__session__config.html#af51c373555138dc4012501fa94b2bedc">sp_session_config</a>
</li>
<li>done_tracks
: <a class="el" href="structsp__offline__sync__status.html#aaeb2860d7301485d40d9f0d9bb868fbb">sp_offline_sync_status</a>
</li>
<li>dont_save_metadata_for_playlists
: <a class="el" href="structsp__session__config.html#a190139f3c0842cfe27c61ebf2da5ee9f">sp_session_config</a>
</li>
</ul>


<h3><a class="anchor" id="index_e"></a>- e -</h3><ul>
<li>end_of_track
: <a class="el" href="structsp__session__callbacks.html#a6bc198d89ff46d930c32dae950bd0294">sp_session_callbacks</a>
</li>
<li>error_tracks
: <a class="el" href="structsp__offline__sync__status.html#aa5002b69e3826edc285d19eb7ca0f582">sp_offline_sync_status</a>
</li>
</ul>


<h3><a class="anchor" id="index_g"></a>- g -</h3><ul>
<li>get_audio_buffer_stats
: <a class="el" href="structsp__session__callbacks.html#a328404ac150210387ea3f9cc973149c9">sp_session_callbacks</a>
</li>
</ul>


<h3><a class="anchor" id="index_i"></a>- i -</h3><ul>
<li>image_changed
: <a class="el" href="structsp__playlist__callbacks.html#a910203945dcd26b02b390d5413e4f5dd">sp_playlist_callbacks</a>
</li>
<li>initially_unload_playlists
: <a class="el" href="structsp__session__config.html#a3460b768cf69d1c646ac39f507e39287">sp_session_config</a>
</li>
</ul>


<h3><a class="anchor" id="index_l"></a>- l -</h3><ul>
<li>log_message
: <a class="el" href="structsp__session__callbacks.html#aae0ce9c91f2779fafa40ebd640060a05">sp_session_callbacks</a>
</li>
<li>logged_in
: <a class="el" href="structsp__session__callbacks.html#a52d509962541f7d8fdd71284f40d8415">sp_session_callbacks</a>
</li>
<li>logged_out
: <a class="el" href="structsp__session__callbacks.html#a073231e9ceb3d40f4a772ab64ba4ece7">sp_session_callbacks</a>
</li>
</ul>


<h3><a class="anchor" id="index_m"></a>- m -</h3><ul>
<li>message_to_user
: <a class="el" href="structsp__session__callbacks.html#ae5d6e4a9a4296cfcbca1e57acdb4d64d">sp_session_callbacks</a>
</li>
<li>metadata_updated
: <a class="el" href="structsp__session__callbacks.html#a09912988f00ea5e90835681b382a18fc">sp_session_callbacks</a>
</li>
<li>music_delivery
: <a class="el" href="structsp__session__callbacks.html#a33a31478b8de1882ad7847ad033fbaeb">sp_session_callbacks</a>
</li>
</ul>


<h3><a class="anchor" id="index_n"></a>- n -</h3><ul>
<li>notify_main_thread
: <a class="el" href="structsp__session__callbacks.html#a085cfd82e77aee2b592f314321019a29">sp_session_callbacks</a>
</li>
</ul>


<h3><a class="anchor" id="index_o"></a>- o -</h3><ul>
<li>offline_error
: <a class="el" href="structsp__session__callbacks.html#ad403ac063f5512b277c924add75dfbea">sp_session_callbacks</a>
</li>
<li>offline_status_updated
: <a class="el" href="structsp__session__callbacks.html#aa0f62ed875aab47e5ae093576a6d54c8">sp_session_callbacks</a>
</li>
</ul>


<h3><a class="anchor" id="index_p"></a>- p -</h3><ul>
<li>play_token_lost
: <a class="el" href="structsp__session__callbacks.html#a641fc97950305fbcd83d5114918c53b9">sp_session_callbacks</a>
</li>
<li>playlist_added
: <a class="el" href="structsp__playlistcontainer__callbacks.html#ab1ba98e60fe050aeda8edc95166dd6fe">sp_playlistcontainer_callbacks</a>
</li>
<li>playlist_metadata_updated
: <a class="el" href="structsp__playlist__callbacks.html#a0de3ae5463973647c114d5fdc85ade87">sp_playlist_callbacks</a>
</li>
<li>playlist_moved
: <a class="el" href="structsp__playlistcontainer__callbacks.html#a64889a47ae2023e21be1ca4a8024c663">sp_playlistcontainer_callbacks</a>
</li>
<li>playlist_removed
: <a class="el" href="structsp__playlistcontainer__callbacks.html#ad49b8c0f44f6c05e4ab3562b023f0928">sp_playlistcontainer_callbacks</a>
</li>
<li>playlist_renamed
: <a class="el" href="structsp__playlist__callbacks.html#a25e98e4355cf2d3503c7ac708c8104cf">sp_playlist_callbacks</a>
</li>
<li>playlist_state_changed
: <a class="el" href="structsp__playlist__callbacks.html#a7ff55580625a755b196336a551d210d4">sp_playlist_callbacks</a>
</li>
<li>playlist_update_in_progress
: <a class="el" href="structsp__playlist__callbacks.html#ab07f7eb6c283523afb37d683932b62d4">sp_playlist_callbacks</a>
</li>
<li>private_session_mode_changed
: <a class="el" href="structsp__session__callbacks.html#ad04af396785f8973a3c15a68bb617830">sp_session_callbacks</a>
</li>
<li>proxy
: <a class="el" href="structsp__session__config.html#af7a09f94350796ae7dde15a6518f51e2">sp_session_config</a>
</li>
<li>proxy_password
: <a class="el" href="structsp__session__config.html#a33f2d3aa26d3db999b3026529aa5d670">sp_session_config</a>
</li>
<li>proxy_username
: <a class="el" href="structsp__session__config.html#a393cd7cf64c064f1647fe0045ac0d5cb">sp_session_config</a>
</li>
</ul>


<h3><a class="anchor" id="index_q"></a>- q -</h3><ul>
<li>queued_tracks
: <a class="el" href="structsp__offline__sync__status.html#a44a8a719c66266763ed184b575abce61">sp_offline_sync_status</a>
</li>
</ul>


<h3><a class="anchor" id="index_s"></a>- s -</h3><ul>
<li>sample_rate
: <a class="el" href="structsp__audioformat.html#a2eb66d38a418d5c0afe284d4d45a619d">sp_audioformat</a>
</li>
<li>sample_type
: <a class="el" href="structsp__audioformat.html#af128862563608ee7e41a6d6a4e6133bc">sp_audioformat</a>
</li>
<li>samples
: <a class="el" href="structsp__audio__buffer__stats.html#a1ff9dcc75ace1cc954138fedc4c8f854">sp_audio_buffer_stats</a>
</li>
<li>scrobble_error
: <a class="el" href="structsp__session__callbacks.html#a01a47778439fa233187fdefa75a0f7dc">sp_session_callbacks</a>
</li>
<li>settings_location
: <a class="el" href="structsp__session__config.html#a342532432040d476aaaf73f10893d23b">sp_session_config</a>
</li>
<li>start_playback
: <a class="el" href="structsp__session__callbacks.html#adcfcee6abf1b6f408010e5615d2a79c8">sp_session_callbacks</a>
</li>
<li>stop_playback
: <a class="el" href="structsp__session__callbacks.html#a2a225bc017266c935c05d18142f27ad6">sp_session_callbacks</a>
</li>
<li>streaming_error
: <a class="el" href="structsp__session__callbacks.html#a003db54ec10236a3e3d77bfbf31f38ae">sp_session_callbacks</a>
</li>
<li>stutter
: <a class="el" href="structsp__audio__buffer__stats.html#a85f67e5b11d5ba63b4a94f01a5009d96">sp_audio_buffer_stats</a>
</li>
<li>subscribers
: <a class="el" href="structsp__subscribers.html#aaac89593785dc926976885dfd33efb0c">sp_subscribers</a>
</li>
<li>subscribers_changed
: <a class="el" href="structsp__playlist__callbacks.html#ae33cb7f8ebc9eac186c9f22272d093c3">sp_playlist_callbacks</a>
</li>
<li>syncing
: <a class="el" href="structsp__offline__sync__status.html#a5a2a99fdb8eeb38b3c73a44c6df68d06">sp_offline_sync_status</a>
</li>
</ul>


<h3><a class="anchor" id="index_t"></a>- t -</h3><ul>
<li>tracefile
: <a class="el" href="structsp__session__config.html#aa7df4256deac84eea21053a7ca2cc3da">sp_session_config</a>
</li>
<li>track_created_changed
: <a class="el" href="structsp__playlist__callbacks.html#a152a3b599f22f4040ff0581c6927d12e">sp_playlist_callbacks</a>
</li>
<li>track_message_changed
: <a class="el" href="structsp__playlist__callbacks.html#ad26fb637a16ed0590bdf7936dfcad82d">sp_playlist_callbacks</a>
</li>
<li>track_seen_changed
: <a class="el" href="structsp__playlist__callbacks.html#ab78eaf42523f53bb5931eaff8dcdea8b">sp_playlist_callbacks</a>
</li>
<li>tracks_added
: <a class="el" href="structsp__playlist__callbacks.html#a16c3e5758f8f73f5900de4b88424f85e">sp_playlist_callbacks</a>
</li>
<li>tracks_moved
: <a class="el" href="structsp__playlist__callbacks.html#ac3d51200f7a813cce810561132dba4e9">sp_playlist_callbacks</a>
</li>
<li>tracks_removed
: <a class="el" href="structsp__playlist__callbacks.html#a8f7decf111d725363c968ae4e7b15795">sp_playlist_callbacks</a>
</li>
</ul>


<h3><a class="anchor" id="index_u"></a>- u -</h3><ul>
<li>user_agent
: <a class="el" href="structsp__session__config.html#a69d5b5aa58c901d7916bdea6e5b75c88">sp_session_config</a>
</li>
<li>userdata
: <a class="el" href="structsp__session__config.html#a931b9a253380fdf910afc715e2c2d040">sp_session_config</a>
</li>
<li>userinfo_updated
: <a class="el" href="structsp__session__callbacks.html#a8685310c1755044ec0ea0e316de8be6e">sp_session_callbacks</a>
</li>
</ul>


<h3><a class="anchor" id="index_w"></a>- w -</h3><ul>
<li>willnotcopy_tracks
: <a class="el" href="structsp__offline__sync__status.html#aa56788dbda2c99047cc79282caf3ffd6">sp_offline_sync_status</a>
</li>
</ul>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/globals.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Data Fields</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="files.html"><span>File&nbsp;List</span></a></li>
      <li class="current"><a href="globals.html"><span>Globals</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li class="current"><a href="globals.html"><span>All</span></a></li>
      <li><a href="globals_func.html"><span>Functions</span></a></li>
      <li><a href="globals_type.html"><span>Typedefs</span></a></li>
      <li><a href="globals_enum.html"><span>Enumerations</span></a></li>
      <li><a href="globals_eval.html"><span>Enumerator</span></a></li>
      <li><a href="globals_defs.html"><span>Defines</span></a></li>
    </ul>
  </div>
  <div class="tabs3">
    <ul class="tablist">
      <li class="current"><a href="globals.html#index_a"><span>a</span></a></li>
      <li><a href="globals_0x69.html#index_i"><span>i</span></a></li>
      <li><a href="globals_0x73.html#index_s"><span>s</span></a></li>
      <li><a href="globals_0x74.html#index_t"><span>t</span></a></li>
    </ul>
  </div>
</div>
<div class="contents">
Here is a list of all documented functions, variables, defines, enums, and typedefs with links to the documentation:

<h3><a class="anchor" id="index_a"></a>- a -</h3><ul>
<li>albumbrowse_complete_cb
: <a class="el" href="group__albumbrowse.html#gabd76254f89048e6d368929015a0c739f">api.h</a>
</li>
<li>artistbrowse_complete_cb
: <a class="el" href="group__artistbrowse.html#ga8077aa18c043210e859479be2616a3e7">api.h</a>
</li>
</ul>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/globals_0x69.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Data Fields</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="files.html"><span>File&nbsp;List</span></a></li>
      <li class="current"><a href="globals.html"><span>Globals</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li class="current"><a href="globals.html"><span>All</span></a></li>
      <li><a href="globals_func.html"><span>Functions</span></a></li>
      <li><a href="globals_type.html"><span>Typedefs</span></a></li>
      <li><a href="globals_enum.html"><span>Enumerations</span></a></li>
      <li><a href="globals_eval.html"><span>Enumerator</span></a></li>
      <li><a href="globals_defs.html"><span>Defines</span></a></li>
    </ul>
  </div>
  <div class="tabs3">
    <ul class="tablist">
      <li><a href="globals.html#index_a"><span>a</span></a></li>
      <li class="current"><a href="globals_0x69.html#index_i"><span>i</span></a></li>
      <li><a href="globals_0x73.html#index_s"><span>s</span></a></li>
      <li><a href="globals_0x74.html#index_t"><span>t</span></a></li>
    </ul>
  </div>
</div>
<div class="contents">
Here is a list of all documented functions, variables, defines, enums, and typedefs with links to the documentation:

<h3><a class="anchor" id="index_i"></a>- i -</h3><ul>
<li>image_loaded_cb
: <a class="el" href="group__image.html#ga713bef7c5dedba7d91b9710cd9b5faa4">api.h</a>
</li>
<li>inboxpost_complete_cb
: <a class="el" href="group__inbox.html#ga5084d6ab753294730402a0c43b82e60c">api.h</a>
</li>
</ul>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/globals_0x73.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Data Fields</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="files.html"><span>File&nbsp;List</span></a></li>
      <li class="current"><a href="globals.html"><span>Globals</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li class="current"><a href="globals.html"><span>All</span></a></li>
      <li><a href="globals_func.html"><span>Functions</span></a></li>
      <li><a href="globals_type.html"><span>Typedefs</span></a></li>
      <li><a href="globals_enum.html"><span>Enumerations</span></a></li>
      <li><a href="globals_eval.html"><span>Enumerator</span></a></li>
      <li><a href="globals_defs.html"><span>Defines</span></a></li>
    </ul>
  </div>
  <div class="tabs3">
    <ul class="tablist">
      <li><a href="globals.html#index_a"><span>a</span></a></li>
      <li><a href="globals_0x69.html#index_i"><span>i</span></a></li>
      <li class="current"><a href="globals_0x73.html#index_s"><span>s</span></a></li>
      <li><a href="globals_0x74.html#index_t"><span>t</span></a></li>
    </ul>
  </div>
</div>
<div class="contents">
Here is a list of all documented functions, variables, defines, enums, and typedefs with links to the documentation:

<h3><a class="anchor" id="index_s"></a>- s -</h3><ul>
<li>search_complete_cb
: <a class="el" href="group__search.html#gabcd51c99a318b9f36dfe2948d8209bb1">api.h</a>
</li>
<li>sp_album
: <a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">api.h</a>
</li>
<li>sp_album_add_ref()
: <a class="el" href="group__album.html#ga08192dd38d1c628f7b51615fffa33017">api.h</a>
</li>
<li>sp_album_artist()
: <a class="el" href="group__album.html#ga42309972141dab10c32d741d357c01de">api.h</a>
</li>
<li>sp_album_cover()
: <a class="el" href="group__album.html#ga6616ef3df724af185c5eb58e8a0fb808">api.h</a>
</li>
<li>sp_album_is_available()
: <a class="el" href="group__album.html#ga89eb8dc73a76f5e0509b1066426495f7">api.h</a>
</li>
<li>sp_album_is_loaded()
: <a class="el" href="group__album.html#ga46fbfa98be12c2f4067d5e679552cfb9">api.h</a>
</li>
<li>sp_album_name()
: <a class="el" href="group__album.html#ga0e828c991a8184d60026513f944e19ad">api.h</a>
</li>
<li>sp_album_release()
: <a class="el" href="group__album.html#ga5c6e49d04ffb05c722db5e78c9434b88">api.h</a>
</li>
<li>sp_album_type()
: <a class="el" href="group__album.html#ga8dceb04a62bdb3ffc112ed0efc359e51">api.h</a>
</li>
<li>sp_album_year()
: <a class="el" href="group__album.html#ga2aadf934b0af43c3ef6ee98b6a8065fd">api.h</a>
</li>
<li>sp_albumbrowse
: <a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">api.h</a>
</li>
<li>sp_albumbrowse_add_ref()
: <a class="el" href="group__albumbrowse.html#ga1afd6a10febf31a61cf356673cb34bef">api.h</a>
</li>
<li>sp_albumbrowse_album()
: <a class="el" href="group__albumbrowse.html#gaf0dadfc4edb48a3558b606e30e8bedfa">api.h</a>
</li>
<li>sp_albumbrowse_artist()
: <a class="el" href="group__albumbrowse.html#ga4f835537a65bcac9ec52cef1058a44bc">api.h</a>
</li>
<li>sp_albumbrowse_backend_request_duration()
: <a class="el" href="group__albumbrowse.html#ga2f1e1049065e8c090c010f8e43061bd4">api.h</a>
</li>
<li>sp_albumbrowse_copyright()
: <a class="el" href="group__albumbrowse.html#ga34b205daa2960e8d02a6e1accd80ab92">api.h</a>
</li>
<li>sp_albumbrowse_create()
: <a class="el" href="group__albumbrowse.html#gaf1bc3042e748efea5ca7ac159e5cbfbe">api.h</a>
</li>
<li>sp_albumbrowse_error()
: <a class="el" href="group__albumbrowse.html#ga153417eee319e7711b66503f88fba88b">api.h</a>
</li>
<li>sp_albumbrowse_is_loaded()
: <a class="el" href="group__albumbrowse.html#gad618d2752eb55173ab373d1407971960">api.h</a>
</li>
<li>sp_albumbrowse_num_copyrights()
: <a class="el" href="group__albumbrowse.html#gab53fa74ee1958dad5186be09e70ddc4a">api.h</a>
</li>
<li>sp_albumbrowse_num_tracks()
: <a class="el" href="group__albumbrowse.html#ga3fb91de745ca07d3801a57288f2d9da7">api.h</a>
</li>
<li>sp_albumbrowse_release()
: <a class="el" href="group__albumbrowse.html#gabdd5a4e3b2098166b67e35979f59613d">api.h</a>
</li>
<li>sp_albumbrowse_review()
: <a class="el" href="group__albumbrowse.html#ga868f3f3263f5033ae1fba60f403be712">api.h</a>
</li>
<li>sp_albumbrowse_track()
: <a class="el" href="group__albumbrowse.html#gad3c8df4b75158bba2c06aaefa74c5aa1">api.h</a>
</li>
<li>sp_albumtype
: <a class="el" href="group__album.html#ga019b49a9d1633b61daa79c80ea01d5c3">api.h</a>
</li>
<li>SP_ALBUMTYPE_ALBUM
: <a class="el" href="group__album.html#gga019b49a9d1633b61daa79c80ea01d5c3ad1693d93a2c05c053fc4fd77886af8dd">api.h</a>
</li>
<li>SP_ALBUMTYPE_COMPILATION
: <a class="el" href="group__album.html#gga019b49a9d1633b61daa79c80ea01d5c3a8fee6ba46e8876037f4f2e46c6d6c6af">api.h</a>
</li>
<li>SP_ALBUMTYPE_SINGLE
: <a class="el" href="group__album.html#gga019b49a9d1633b61daa79c80ea01d5c3a3b6f78b733f1bc18a5e4fa18c020fc73">api.h</a>
</li>
<li>SP_ALBUMTYPE_UNKNOWN
: <a class="el" href="group__album.html#gga019b49a9d1633b61daa79c80ea01d5c3ad564ed5f1f0659929fe5ec700513873f">api.h</a>
</li>
<li>sp_artist
: <a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">api.h</a>
</li>
<li>sp_artist_add_ref()
: <a class="el" href="group__artist.html#gac70d7467f580aa497d1a5d610e06d273">api.h</a>
</li>
<li>sp_artist_is_loaded()
: <a class="el" href="group__artist.html#gafc98f5093184a7ac7ce608302b0971ea">api.h</a>
</li>
<li>sp_artist_name()
: <a class="el" href="group__artist.html#gad2895555bb48514986823733a7afe5e2">api.h</a>
</li>
<li>sp_artist_portrait()
: <a class="el" href="group__artist.html#ga87d366ac7479c717005c2c059d5f2be9">api.h</a>
</li>
<li>sp_artist_release()
: <a class="el" href="group__artist.html#ga7b0da8f7ce09454bd0821d06d52e2d12">api.h</a>
</li>
<li>sp_artistbrowse
: <a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">api.h</a>
</li>
<li>sp_artistbrowse_add_ref()
: <a class="el" href="group__artistbrowse.html#ga69fc2e1d2d5e8d91a724486cbfd0c4dc">api.h</a>
</li>
<li>sp_artistbrowse_album()
: <a class="el" href="group__artistbrowse.html#ga5b36c9a34876beea8fda8674b93d4fd3">api.h</a>
</li>
<li>sp_artistbrowse_artist()
: <a class="el" href="group__artistbrowse.html#ga5f6a046b2bd261d7628582b986a9019f">api.h</a>
</li>
<li>sp_artistbrowse_backend_request_duration()
: <a class="el" href="group__artistbrowse.html#gadce357748b82abce8a7b093882850fdb">api.h</a>
</li>
<li>sp_artistbrowse_biography()
: <a class="el" href="group__artistbrowse.html#ga8b93b9e5630662855f35694280ba4d2b">api.h</a>
</li>
<li>sp_artistbrowse_create()
: <a class="el" href="group__artistbrowse.html#ga8dd8364b2fcd29c846209660bd9a69b2">api.h</a>
</li>
<li>sp_artistbrowse_error()
: <a class="el" href="group__artistbrowse.html#ga203e757088ff7a5098f16a1367da25d2">api.h</a>
</li>
<li>SP_ARTISTBROWSE_FULL
: <a class="el" href="group__session.html#ggac86504cc9e8cadbc30c8aa8dbf355034a2914168528aded818177c013a0dd7e87">api.h</a>
</li>
<li>sp_artistbrowse_is_loaded()
: <a class="el" href="group__artistbrowse.html#ga966b0f59e7b2b3d0037e44bb49dcdabc">api.h</a>
</li>
<li>SP_ARTISTBROWSE_NO_ALBUMS
: <a class="el" href="group__session.html#ggac86504cc9e8cadbc30c8aa8dbf355034ac0032981f8dbf44c022e6a7ab1672167">api.h</a>
</li>
<li>SP_ARTISTBROWSE_NO_TRACKS
: <a class="el" href="group__session.html#ggac86504cc9e8cadbc30c8aa8dbf355034afbad1e58606b3230dce5bc3320c95d12">api.h</a>
</li>
<li>sp_artistbrowse_num_albums()
: <a class="el" href="group__artistbrowse.html#gaf0055361abd53425d89a4636a32b5c83">api.h</a>
</li>
<li>sp_artistbrowse_num_portraits()
: <a class="el" href="group__artistbrowse.html#ga98dc47d36d2789999bfe62707c5041d7">api.h</a>
</li>
<li>sp_artistbrowse_num_similar_artists()
: <a class="el" href="group__artistbrowse.html#ga2559638742416ac621af0e919e017d17">api.h</a>
</li>
<li>sp_artistbrowse_num_tophit_tracks()
: <a class="el" href="group__artistbrowse.html#ga0c26782796af954300ce92fddea97637">api.h</a>
</li>
<li>sp_artistbrowse_num_tracks()
: <a class="el" href="group__artistbrowse.html#ga8c862caa2234125ffcc4e93287b1e029">api.h</a>
</li>
<li>sp_artistbrowse_portrait()
: <a class="el" href="group__artistbrowse.html#ga5f164b2f9609a7bf2c89b3a1407ec239">api.h</a>
</li>
<li>sp_artistbrowse_release()
: <a class="el" href="group__artistbrowse.html#ga14626a4f6a60b1caf61cb54c26783671">api.h</a>
</li>
<li>sp_artistbrowse_similar_artist()
: <a class="el" href="group__artistbrowse.html#gac60ef4f9e006a920f1d72b6098743fbc">api.h</a>
</li>
<li>sp_artistbrowse_tophit_track()
: <a class="el" href="group__artistbrowse.html#ga5da55f43def03fe9f0d2c8b252b9755a">api.h</a>
</li>
<li>sp_artistbrowse_track()
: <a class="el" href="group__artistbrowse.html#ga45d28771a856f935dc40ab40e27dec4c">api.h</a>
</li>
<li>sp_artistbrowse_type
: <a class="el" href="group__session.html#gac86504cc9e8cadbc30c8aa8dbf355034">api.h</a>
</li>
<li>sp_audio_buffer_stats
: <a class="el" href="group__session.html#ga25462859a596a247ba5cc1853fc32cca">api.h</a>
</li>
<li>sp_audioformat
: <a class="el" href="group__session.html#ga5338d4a10576ba8d6ab11b70892d503c">api.h</a>
</li>
<li>sp_availability
: <a class="el" href="group__session.html#gad7d9465769597b2a379ac704099adfdf">api.h</a>
</li>
<li>sp_bitrate
: <a class="el" href="group__session.html#ga77ddd919314a7bb16140569af7a38fe2">api.h</a>
</li>
<li>SP_BITRATE_160k
: <a class="el" href="group__session.html#gga77ddd919314a7bb16140569af7a38fe2a5b5c794224972f833a4b7eec9d7909c9">api.h</a>
</li>
<li>SP_BITRATE_320k
: <a class="el" href="group__session.html#gga77ddd919314a7bb16140569af7a38fe2a9383c0dc9faefd2cbb38c3b9342c47e0">api.h</a>
</li>
<li>SP_BITRATE_96k
: <a class="el" href="group__session.html#gga77ddd919314a7bb16140569af7a38fe2ad815a35af7e6bb5e2ef29418af62759b">api.h</a>
</li>
<li>sp_build_id()
: <a class="el" href="api_8h.html#a181d0940997cb8b69869449cd826cf88">api.h</a>
</li>
<li>SP_CONNECTION_RULE_ALLOW_SYNC_OVER_MOBILE
: <a class="el" href="group__session.html#ggad275d696685b2ad9ff1a2c3e16af6502a91a946573c44de44d74e9d20dbce4c74">api.h</a>
</li>
<li>SP_CONNECTION_RULE_ALLOW_SYNC_OVER_WIFI
: <a class="el" href="group__session.html#ggad275d696685b2ad9ff1a2c3e16af6502a548f3734832ec65a992e598d8b91633d">api.h</a>
</li>
<li>SP_CONNECTION_RULE_NETWORK
: <a class="el" href="group__session.html#ggad275d696685b2ad9ff1a2c3e16af6502aa39a1c21c17c55cd1547bc900ae2d386">api.h</a>
</li>
<li>SP_CONNECTION_RULE_NETWORK_IF_ROAMING
: <a class="el" href="group__session.html#ggad275d696685b2ad9ff1a2c3e16af6502af2772ba84ee7e410ad99708a11955670">api.h</a>
</li>
<li>sp_connection_rules
: <a class="el" href="group__session.html#gad275d696685b2ad9ff1a2c3e16af6502">api.h</a>
</li>
<li>SP_CONNECTION_STATE_DISCONNECTED
: <a class="el" href="group__session.html#ggabf77bb5a124d5a6ee9a12c86abbc0d34ad1a6eb721675af4613f823c091538a8c">api.h</a>
</li>
<li>SP_CONNECTION_STATE_LOGGED_IN
: <a class="el" href="group__session.html#ggabf77bb5a124d5a6ee9a12c86abbc0d34a88ae17b4168184e62e4c190c289c47c5">api.h</a>
</li>
<li>SP_CONNECTION_STATE_LOGGED_OUT
: <a class="el" href="group__session.html#ggabf77bb5a124d5a6ee9a12c86abbc0d34ae31e9958a98211ecff5ecbcf7041dfa5">api.h</a>
</li>
<li>SP_CONNECTION_STATE_OFFLINE
: <a class="el" href="group__session.html#ggabf77bb5a124d5a6ee9a12c86abbc0d34a63099ef9185ba287fcd2e77be3c47d8f">api.h</a>
</li>
<li>SP_CONNECTION_STATE_UNDEFINED
: <a class="el" href="group__session.html#ggabf77bb5a124d5a6ee9a12c86abbc0d34a4ddf57518007eef86b06f496d7059484">api.h</a>
</li>
<li>sp_connection_type
: <a class="el" href="group__session.html#ga3e8773baeb94189b9a1ff27d6a5e3553">api.h</a>
</li>
<li>SP_CONNECTION_TYPE_MOBILE
: <a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553a3ca3e6a85ac9d497914c35620ad5179d">api.h</a>
</li>
<li>SP_CONNECTION_TYPE_MOBILE_ROAMING
: <a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553a05b41bbfd369f9030a7daafc9395116e">api.h</a>
</li>
<li>SP_CONNECTION_TYPE_NONE
: <a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553aa7aae7ae3f7c471ece1c6aa2705d046c">api.h</a>
</li>
<li>SP_CONNECTION_TYPE_UNKNOWN
: <a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553af949fae9bc12f47b99ef290fa9b5d8a7">api.h</a>
</li>
<li>SP_CONNECTION_TYPE_WIFI
: <a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553a31d2cad7379f1bc2eeedd24c40541cb9">api.h</a>
</li>
<li>SP_CONNECTION_TYPE_WIRED
: <a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553a4f9f0c09e59af4114bb369ebcc474710">api.h</a>
</li>
<li>sp_connectionstate
: <a class="el" href="group__session.html#gabf77bb5a124d5a6ee9a12c86abbc0d34">api.h</a>
</li>
<li>sp_error
: <a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">api.h</a>
</li>
<li>SP_ERROR_API_INITIALIZATION_FAILED
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6bac8c438bd52975d14edf23d040e93d114">api.h</a>
</li>
<li>SP_ERROR_APPLICATION_BANNED
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba46c3b6173bb5b09445164402ac5ed81f">api.h</a>
</li>
<li>SP_ERROR_BAD_API_VERSION
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba17c588fa9648e3649185e595bdb88d6f">api.h</a>
</li>
<li>SP_ERROR_BAD_APPLICATION_KEY
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba2bad808a467ee4418adaa40f4844d059">api.h</a>
</li>
<li>SP_ERROR_BAD_USER_AGENT
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baf3597d4af35adb4fc0d0793ea26f77b4">api.h</a>
</li>
<li>SP_ERROR_BAD_USERNAME_OR_PASSWORD
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba41052a4a158fa18bb1b8bfdd8c37f7dc">api.h</a>
</li>
<li>SP_ERROR_CANT_OPEN_TRACE_FILE
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6badb3af1736912156cbe0b1e39eaeee1c8">api.h</a>
</li>
<li>SP_ERROR_CLIENT_TOO_OLD
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba995344026c012b3f59dc73e12c28b1ba">api.h</a>
</li>
<li>SP_ERROR_INBOX_IS_FULL
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baa4bdf4298c9653549464d21ee528c881">api.h</a>
</li>
<li>SP_ERROR_INDEX_OUT_OF_RANGE
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba44b3f132578cbf9a43b5c048efcf63a2">api.h</a>
</li>
<li>SP_ERROR_INVALID_ARGUMENT
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba7f8be4d478e51d2b205157c7c538a3e5">api.h</a>
</li>
<li>SP_ERROR_INVALID_DEVICE_ID
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba846d94ada9e8db0c2bd5153f5801afa2">api.h</a>
</li>
<li>SP_ERROR_INVALID_INDATA
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6bac9f65a7270391d35342ca9e6c01d519d">api.h</a>
</li>
<li>SP_ERROR_IS_LOADING
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba17f54c30d01baedc24547e62ed417cdd">api.h</a>
</li>
<li>SP_ERROR_LASTFM_AUTH_ERROR
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baf588c0f7a2d8d11acea28ac2a4de43c4">api.h</a>
</li>
<li>sp_error_message()
: <a class="el" href="group__error.html#ga983dee341d3c2008830513b7cffe7bf3">api.h</a>
</li>
<li>SP_ERROR_MISSING_CALLBACK
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6babb1116e69e1d651f9f175dbc8bb5fa32">api.h</a>
</li>
<li>SP_ERROR_NETWORK_DISABLED
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba8fda4dd3ee6ac931337a871fbee02978">api.h</a>
</li>
<li>SP_ERROR_NO_CACHE
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba3b8851ee3ba2bd7ad1fe377d94ac38c0">api.h</a>
</li>
<li>SP_ERROR_NO_CREDENTIALS
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba9ad34b997313d790f142f24e77e78e2d">api.h</a>
</li>
<li>SP_ERROR_NO_STREAM_AVAILABLE
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba71307cc7b8460042603f3f322d1096f4">api.h</a>
</li>
<li>SP_ERROR_NO_SUCH_USER
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baf8ade144869c958de534ecec9f9a36a9">api.h</a>
</li>
<li>SP_ERROR_OFFLINE_DISK_CACHE
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6bae6b9d9b013f1243548e4fbcf961559ff">api.h</a>
</li>
<li>SP_ERROR_OFFLINE_EXPIRED
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba7e16a1962fd4de081d73dc4a4e32eb04">api.h</a>
</li>
<li>SP_ERROR_OFFLINE_LICENSE_ERROR
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba9149b343017c0dea431839c8b4d9198c">api.h</a>
</li>
<li>SP_ERROR_OFFLINE_LICENSE_LOST
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba2c87afb46df21783f172a06b2c25d8f9">api.h</a>
</li>
<li>SP_ERROR_OFFLINE_NOT_ALLOWED
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6bae102b46f4fae3b7b6b34e21ea80d656f">api.h</a>
</li>
<li>SP_ERROR_OFFLINE_TOO_MANY_TRACKS
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba32fd1f63fd4dc7ec50bd11791f02953f">api.h</a>
</li>
<li>SP_ERROR_OK
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba16cb277dc84328e4b2c0cf6d5a0c0b8d">api.h</a>
</li>
<li>SP_ERROR_OTHER_PERMANENT
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba3f68775a5c001bd1de26afdf5ea4e09d">api.h</a>
</li>
<li>SP_ERROR_OTHER_TRANSIENT
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baf139c18351a543862bd9393ccebc5f91">api.h</a>
</li>
<li>SP_ERROR_PERMISSION_DENIED
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baaddac1f3b82e905711ab9ffe5b4b0329">api.h</a>
</li>
<li>SP_ERROR_SYSTEM_FAILURE
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba73d533e0f25f4ba4cecd6d2e2502b80b">api.h</a>
</li>
<li>SP_ERROR_TRACK_NOT_PLAYABLE
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba7b94fe2b53f58d91d4c3cda7bb706ff3">api.h</a>
</li>
<li>SP_ERROR_UNABLE_TO_CONTACT_SERVER
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba9d11d66176b6ae95bf00486e9e39866b">api.h</a>
</li>
<li>SP_ERROR_USER_BANNED
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba822f4031a82ab428cd04f2ecdc0e757f">api.h</a>
</li>
<li>SP_ERROR_USER_NEEDS_PREMIUM
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba96c08adfcda17005c63142cd4e4cd9bb">api.h</a>
</li>
<li>sp_image
: <a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">api.h</a>
</li>
<li>sp_image_add_load_callback()
: <a class="el" href="group__image.html#gaa414f26ad1b9095645a83361597c92ce">api.h</a>
</li>
<li>sp_image_add_ref()
: <a class="el" href="group__image.html#ga98c93dbedfb182243742131a5224b83b">api.h</a>
</li>
<li>sp_image_create()
: <a class="el" href="group__image.html#gaf29e89f45945db2b3667bf9db4279c33">api.h</a>
</li>
<li>sp_image_create_from_link()
: <a class="el" href="group__image.html#ga70fb25cd2b0caaf15f637f36e75524b9">api.h</a>
</li>
<li>sp_image_data()
: <a class="el" href="group__image.html#ga03700a7dfa90bfc8200b89f15acd91aa">api.h</a>
</li>
<li>sp_image_error()
: <a class="el" href="group__image.html#gae40103df87426b346e0d0413d8d3b0ff">api.h</a>
</li>
<li>sp_image_format()
: <a class="el" href="group__image.html#ga04448e81ca4916ba7ed223d0d817e803">api.h</a>
</li>
<li>SP_IMAGE_FORMAT_JPEG
: <a class="el" href="group__image.html#gga2cda19baf2460da5e81fb1917f54626ba6263674800bea702c4d913d4b07c135d">api.h</a>
</li>
<li>SP_IMAGE_FORMAT_UNKNOWN
: <a class="el" href="group__image.html#gga2cda19baf2460da5e81fb1917f54626ba2fec8a1b400bd6cd5396b9852e4279b6">api.h</a>
</li>
<li>sp_image_image_id()
: <a class="el" href="group__image.html#ga0ee0b98cc25c995fe208a992cc87d145">api.h</a>
</li>
<li>sp_image_is_loaded()
: <a class="el" href="group__image.html#ga45312b1b9b5e5565485d61a8f0300e18">api.h</a>
</li>
<li>sp_image_release()
: <a class="el" href="group__image.html#ga3df9af5f68b18df5a598b7510e9b587f">api.h</a>
</li>
<li>sp_image_remove_load_callback()
: <a class="el" href="group__image.html#gaaee68c65d9eab3499f2b6be5d048d6ba">api.h</a>
</li>
<li>sp_image_size
: <a class="el" href="group__session.html#ga61bc424465d776af3ceeb69eee2bb492">api.h</a>
</li>
<li>SP_IMAGE_SIZE_LARGE
: <a class="el" href="group__session.html#gga61bc424465d776af3ceeb69eee2bb492a0a0b624afbb2a66ee3d7954202b89721">api.h</a>
</li>
<li>SP_IMAGE_SIZE_NORMAL
: <a class="el" href="group__session.html#gga61bc424465d776af3ceeb69eee2bb492ad20c808fd1f8180d1f49f643975d1dd7">api.h</a>
</li>
<li>SP_IMAGE_SIZE_SMALL
: <a class="el" href="group__session.html#gga61bc424465d776af3ceeb69eee2bb492ab9340b1bcf2129c3ad1328ea617d547f">api.h</a>
</li>
<li>sp_imageformat
: <a class="el" href="group__image.html#ga2cda19baf2460da5e81fb1917f54626b">api.h</a>
</li>
<li>sp_inbox
: <a class="el" href="group__types.html#gaec0f2e5098cebc05ce56adfc9b346510">api.h</a>
</li>
<li>sp_inbox_add_ref()
: <a class="el" href="group__inbox.html#gadb6b607bc26b9d362de4da09ec1c864f">api.h</a>
</li>
<li>sp_inbox_error()
: <a class="el" href="group__inbox.html#gaa452e9fe1fa7c9e2c780d28ce2ed63c5">api.h</a>
</li>
<li>sp_inbox_post_tracks()
: <a class="el" href="group__inbox.html#gaee29e747ca10b36597d91689ae074aa2">api.h</a>
</li>
<li>sp_inbox_release()
: <a class="el" href="group__inbox.html#ga73659a65af92d30e4ac1cf3e06e74a0a">api.h</a>
</li>
<li>sp_link
: <a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">api.h</a>
</li>
<li>sp_link_add_ref()
: <a class="el" href="group__link.html#gac5a808b15bceed41508bd3863c8f4b3b">api.h</a>
</li>
<li>sp_link_as_album()
: <a class="el" href="group__link.html#gaafa98628d0abadcca27dd3b227c7337b">api.h</a>
</li>
<li>sp_link_as_artist()
: <a class="el" href="group__link.html#gab32979d26dcf68936202fa7aed7b6e49">api.h</a>
</li>
<li>sp_link_as_string()
: <a class="el" href="group__link.html#ga9f169be53f098adcf12f7a10b8bd3ef7">api.h</a>
</li>
<li>sp_link_as_track()
: <a class="el" href="group__link.html#ga2560687997d7ce0fbf4f05251d87d32a">api.h</a>
</li>
<li>sp_link_as_track_and_offset()
: <a class="el" href="group__link.html#ga80f6f752832f76c268c0bfd3ca45e6d2">api.h</a>
</li>
<li>sp_link_as_user()
: <a class="el" href="group__link.html#ga3e29975f47fc0a51be813b4774a3d6f3">api.h</a>
</li>
<li>sp_link_create_from_album()
: <a class="el" href="group__link.html#ga040627b0df84425947c82cd8890122ad">api.h</a>
</li>
<li>sp_link_create_from_album_cover()
: <a class="el" href="group__link.html#gaa87e346c29f1077d7a62c364719d4a55">api.h</a>
</li>
<li>sp_link_create_from_artist()
: <a class="el" href="group__link.html#ga3196ce9de3da4f1d5944a0b58bd80540">api.h</a>
</li>
<li>sp_link_create_from_artist_portrait()
: <a class="el" href="group__link.html#gaafb25ee14bfb27f9cbbab1b039d4d225">api.h</a>
</li>
<li>sp_link_create_from_artistbrowse_portrait()
: <a class="el" href="group__link.html#ga32218fbd912ddddbb749cb42a72b6bcd">api.h</a>
</li>
<li>sp_link_create_from_image()
: <a class="el" href="group__link.html#gaa85fbea312127db44685b7e9dc492042">api.h</a>
</li>
<li>sp_link_create_from_playlist()
: <a class="el" href="group__link.html#ga805392bfa8e526eebedc1cf5a7bcae0f">api.h</a>
</li>
<li>sp_link_create_from_search()
: <a class="el" href="group__link.html#ga95c97ba4de9c4040047276ad618a108e">api.h</a>
</li>
<li>sp_link_create_from_string()
: <a class="el" href="group__link.html#gaea9c39f35f7986fc9fed4584fa211127">api.h</a>
</li>
<li>sp_link_create_from_track()
: <a class="el" href="group__link.html#ga82c29419ce70e2b504670e3d45167d5d">api.h</a>
</li>
<li>sp_link_create_from_user()
: <a class="el" href="group__link.html#gaaa78b1750179c17f8152408cea43efef">api.h</a>
</li>
<li>sp_link_release()
: <a class="el" href="group__link.html#ga2b06ab16d1f6436cd8d36dbff2b5c022">api.h</a>
</li>
<li>sp_link_type()
: <a class="el" href="group__link.html#ga6140f924c696d53469bb8930cd53e1e6">api.h</a>
</li>
<li>sp_linktype
: <a class="el" href="group__link.html#gabe9611f04086cdbed6e4e6e1fd913b98">api.h</a>
</li>
<li>SP_LINKTYPE_ALBUM
: <a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a7716eb95eed852d08300e6e64febc7f3">api.h</a>
</li>
<li>SP_LINKTYPE_ARTIST
: <a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a4402b3b001aebb39fd55296f83c60b7e">api.h</a>
</li>
<li>SP_LINKTYPE_IMAGE
: <a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a1b20b8e2b8773df47b241dc7d28ea0e8">api.h</a>
</li>
<li>SP_LINKTYPE_INVALID
: <a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a88b0098486cde586b4dcffb623ac6e63">api.h</a>
</li>
<li>SP_LINKTYPE_LOCALTRACK
: <a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a0698cd0123190c7af55daf79bb642805">api.h</a>
</li>
<li>SP_LINKTYPE_PLAYLIST
: <a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a2640ed065a64b6a9f67e71bbeb2af2dd">api.h</a>
</li>
<li>SP_LINKTYPE_PROFILE
: <a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98ab7a356adce8b1ea34daf21532c7b50e6">api.h</a>
</li>
<li>SP_LINKTYPE_SEARCH
: <a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98ad5909ab9b1cca702163e116b04b6ee8e">api.h</a>
</li>
<li>SP_LINKTYPE_STARRED
: <a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98ab649bd86d0fc55ab3fafed3050261353">api.h</a>
</li>
<li>SP_LINKTYPE_TRACK
: <a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a5911dbb7258ed160b2f9c114cef152f1">api.h</a>
</li>
<li>sp_localtrack_create()
: <a class="el" href="group__track.html#ga0fb814ef23636fdecda64e3a63b15a23">api.h</a>
</li>
<li>sp_offline_num_playlists()
: <a class="el" href="group__session.html#gad6cee58fa44453b7a4fd2ae2266df055">api.h</a>
</li>
<li>sp_offline_sync_get_status()
: <a class="el" href="group__session.html#ga02525cd659a34728047cd3801049e822">api.h</a>
</li>
<li>sp_offline_sync_status
: <a class="el" href="group__session.html#gaa7f24f13d6d105869c405045a4cc2a20">api.h</a>
</li>
<li>sp_offline_time_left()
: <a class="el" href="group__session.html#gac36816dc42825db9a5a2fbd2694f20af">api.h</a>
</li>
<li>sp_offline_tracks_to_sync()
: <a class="el" href="group__session.html#gaf535124b4208c279cb98a061834e6411">api.h</a>
</li>
<li>sp_playlist
: <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">api.h</a>
</li>
<li>sp_playlist_add_callbacks()
: <a class="el" href="group__playlist.html#gab15fca12d387c69b4998a4d2b48e5b32">api.h</a>
</li>
<li>sp_playlist_add_ref()
: <a class="el" href="group__playlist.html#gacb10979add5a954e5c1600ef9c5b17a8">api.h</a>
</li>
<li>sp_playlist_add_tracks()
: <a class="el" href="group__playlist.html#ga2344a47133f7f0aed0a67e154ecc4dc4">api.h</a>
</li>
<li>sp_playlist_callbacks
: <a class="el" href="group__playlist.html#ga8249fe3d53c6dce0f154d0bfd3e80c6a">api.h</a>
</li>
<li>sp_playlist_create()
: <a class="el" href="group__playlist.html#ga342a6a0cfe10531ef7cb3c6629c1e8e7">api.h</a>
</li>
<li>sp_playlist_get_description()
: <a class="el" href="group__playlist.html#gab1d8e0ee9b436ecbb104bbd6cc0665be">api.h</a>
</li>
<li>sp_playlist_get_image()
: <a class="el" href="group__playlist.html#ga409cb6b2a88db7242ec939b6644e8c30">api.h</a>
</li>
<li>sp_playlist_get_offline_download_completed()
: <a class="el" href="group__playlist.html#ga83ca1a25f50834f8e6f8ee1e883a8c6e">api.h</a>
</li>
<li>sp_playlist_get_offline_status()
: <a class="el" href="group__playlist.html#ga7170157af21445c37a21a2241f91ff06">api.h</a>
</li>
<li>sp_playlist_has_pending_changes()
: <a class="el" href="group__playlist.html#gaf0e39b5969259d10625eb398af0f3f43">api.h</a>
</li>
<li>sp_playlist_is_collaborative()
: <a class="el" href="group__playlist.html#ga8ad160f654f02f13690568070dd57353">api.h</a>
</li>
<li>sp_playlist_is_in_ram()
: <a class="el" href="group__playlist.html#ga28456d1242693c6d890516dc782ab3ec">api.h</a>
</li>
<li>sp_playlist_is_loaded()
: <a class="el" href="group__playlist.html#gaee8ea6c07dfdca3397e27b278fa4870a">api.h</a>
</li>
<li>sp_playlist_name()
: <a class="el" href="group__playlist.html#ga61b7e33cc1aedb4e31a2af75ae0ac8cc">api.h</a>
</li>
<li>sp_playlist_num_subscribers()
: <a class="el" href="group__playlist.html#ga967ad87f0db702513ecda82546f667c5">api.h</a>
</li>
<li>sp_playlist_num_tracks()
: <a class="el" href="group__playlist.html#ga684a3acc60f99b3b26488ed813ee5d23">api.h</a>
</li>
<li>sp_playlist_offline_status
: <a class="el" href="group__session.html#ga811fa52ed0fdb5cda732682e27e40417">api.h</a>
</li>
<li>SP_PLAYLIST_OFFLINE_STATUS_DOWNLOADING
: <a class="el" href="group__session.html#gga811fa52ed0fdb5cda732682e27e40417abc999c70761d392b26753708e9a2cfa1">api.h</a>
</li>
<li>SP_PLAYLIST_OFFLINE_STATUS_NO
: <a class="el" href="group__session.html#gga811fa52ed0fdb5cda732682e27e40417abef62e4e3a4af8827fed7fe3aa733ca0">api.h</a>
</li>
<li>SP_PLAYLIST_OFFLINE_STATUS_WAITING
: <a class="el" href="group__session.html#gga811fa52ed0fdb5cda732682e27e40417a7d929bbf4f1df3633b283e39b9c95919">api.h</a>
</li>
<li>SP_PLAYLIST_OFFLINE_STATUS_YES
: <a class="el" href="group__session.html#gga811fa52ed0fdb5cda732682e27e40417affed38ac820e084b96fb48e3d1939584">api.h</a>
</li>
<li>sp_playlist_owner()
: <a class="el" href="group__playlist.html#gac3e4295d3353eb9998402aedfdbd55de">api.h</a>
</li>
<li>sp_playlist_release()
: <a class="el" href="group__playlist.html#gacb9250eb530869b039541a8b62dfab6c">api.h</a>
</li>
<li>sp_playlist_remove_callbacks()
: <a class="el" href="group__playlist.html#ga7fcbf909a0fa8bf25f0b1d1e7dd0e160">api.h</a>
</li>
<li>sp_playlist_remove_tracks()
: <a class="el" href="group__playlist.html#gabd62cd7ff9484b4c31ff7f159ec41b6a">api.h</a>
</li>
<li>sp_playlist_rename()
: <a class="el" href="group__playlist.html#gad6c3880c514353e204fdd90830b516ec">api.h</a>
</li>
<li>sp_playlist_reorder_tracks()
: <a class="el" href="group__playlist.html#ga90ffd8c9fc6abc7375e89f4cb49adb11">api.h</a>
</li>
<li>sp_playlist_set_autolink_tracks()
: <a class="el" href="group__playlist.html#ga0bde47f340e0cd590a78007c6af69307">api.h</a>
</li>
<li>sp_playlist_set_collaborative()
: <a class="el" href="group__playlist.html#gad15410bcc2ebd986adabda865830bce4">api.h</a>
</li>
<li>sp_playlist_set_in_ram()
: <a class="el" href="group__playlist.html#gaf6ca8a349bdd982f6c8dda52ed691017">api.h</a>
</li>
<li>sp_playlist_set_offline_mode()
: <a class="el" href="group__playlist.html#ga784f648f9cc431ef3b51f3491c2f169f">api.h</a>
</li>
<li>sp_playlist_subscribers()
: <a class="el" href="group__playlist.html#gad49f491babc475f8d4aeea1b4452ff8b">api.h</a>
</li>
<li>sp_playlist_subscribers_free()
: <a class="el" href="group__playlist.html#gae7754b74b1c3c8f5222ca43b6608ce6a">api.h</a>
</li>
<li>sp_playlist_track()
: <a class="el" href="group__playlist.html#ga7a03854fe6072476306780d23c6cac16">api.h</a>
</li>
<li>sp_playlist_track_create_time()
: <a class="el" href="group__playlist.html#gab8e77f8d63e787f8aa1a066d74daa74c">api.h</a>
</li>
<li>sp_playlist_track_creator()
: <a class="el" href="group__playlist.html#ga80fcd9e7b40c791433c07d66e2ad432a">api.h</a>
</li>
<li>sp_playlist_track_message()
: <a class="el" href="group__playlist.html#ga6887b9dabb30a060b10bdb75f8b3f971">api.h</a>
</li>
<li>sp_playlist_track_seen()
: <a class="el" href="group__playlist.html#gab9e00ee5bc6b5dc0b3d58cbdb32c0c7b">api.h</a>
</li>
<li>sp_playlist_track_set_seen()
: <a class="el" href="group__playlist.html#ga69f5cc1bdd7dbdcdb476a7b1d2b7834d">api.h</a>
</li>
<li>sp_playlist_type
: <a class="el" href="group__session.html#ga86723f553db2db6a8f507cd748948ad4">api.h</a>
</li>
<li>SP_PLAYLIST_TYPE_END_FOLDER
: <a class="el" href="group__session.html#ggafdd7117213605e6f2671c4f289b44609a3ec52ad1d99d8e32e1b9de31e3f5187a">api.h</a>
</li>
<li>SP_PLAYLIST_TYPE_PLACEHOLDER
: <a class="el" href="group__session.html#ggafdd7117213605e6f2671c4f289b44609ad4f860ef76154e3e2c0d9da2f57a2784">api.h</a>
</li>
<li>SP_PLAYLIST_TYPE_PLAYLIST
: <a class="el" href="group__session.html#ggafdd7117213605e6f2671c4f289b44609a6bd6bf9b62018fa9bbf969835c2f3077">api.h</a>
</li>
<li>SP_PLAYLIST_TYPE_START_FOLDER
: <a class="el" href="group__session.html#ggafdd7117213605e6f2671c4f289b44609a4d3266991787f9438deb9de83d9200da">api.h</a>
</li>
<li>sp_playlist_update_subscribers()
: <a class="el" href="group__playlist.html#ga9ebbf147230b3ca98b68e556cf24e6bd">api.h</a>
</li>
<li>sp_playlistcontainer
: <a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">api.h</a>
</li>
<li>sp_playlistcontainer_add_callbacks()
: <a class="el" href="group__playlist.html#ga1976cb49c391cdd2dbe7c40d1bc71570">api.h</a>
</li>
<li>sp_playlistcontainer_add_folder()
: <a class="el" href="group__playlist.html#ga0862502eea52fc5f2465ebad6fd98796">api.h</a>
</li>
<li>sp_playlistcontainer_add_new_playlist()
: <a class="el" href="group__playlist.html#ga840b82b1074a7ca1c9eacd351bed24c2">api.h</a>
</li>
<li>sp_playlistcontainer_add_playlist()
: <a class="el" href="group__playlist.html#ga87699479087915b741ceef4eebe69ad8">api.h</a>
</li>
<li>sp_playlistcontainer_add_ref()
: <a class="el" href="group__playlist.html#ga2138c537a6ebcd35a01eea54d0dd1e8f">api.h</a>
</li>
<li>sp_playlistcontainer_callbacks
: <a class="el" href="group__playlist.html#ga8786e3840bb3774fc929183e3a9df281">api.h</a>
</li>
<li>sp_playlistcontainer_clear_unseen_tracks()
: <a class="el" href="group__playlist.html#gadaad604c35e543363e1dd5b23c462db0">api.h</a>
</li>
<li>sp_playlistcontainer_get_unseen_tracks()
: <a class="el" href="group__playlist.html#gad9e11b45843ee4a147b43038a2e55f13">api.h</a>
</li>
<li>sp_playlistcontainer_is_loaded()
: <a class="el" href="group__playlist.html#gae23cb67b4b26bca663034997c4418fa8">api.h</a>
</li>
<li>sp_playlistcontainer_move_playlist()
: <a class="el" href="group__playlist.html#gad9be708159957d4c1e5ef905550808c5">api.h</a>
</li>
<li>sp_playlistcontainer_num_playlists()
: <a class="el" href="group__playlist.html#ga7a1cbf558b2b364b8249d4ce432df700">api.h</a>
</li>
<li>sp_playlistcontainer_owner()
: <a class="el" href="group__playlist.html#gad4fc67d1386dd637f778f4e735a36894">api.h</a>
</li>
<li>sp_playlistcontainer_playlist()
: <a class="el" href="group__playlist.html#ga5ddd8c8064c281a14c6fd7877f522dc6">api.h</a>
</li>
<li>sp_playlistcontainer_playlist_folder_id()
: <a class="el" href="group__playlist.html#ga6939f9db71199612fc5a19d395e3a7f8">api.h</a>
</li>
<li>sp_playlistcontainer_playlist_folder_name()
: <a class="el" href="group__playlist.html#ga852e5f5bcd4520be2e3d6d5d94def44a">api.h</a>
</li>
<li>sp_playlistcontainer_playlist_type()
: <a class="el" href="group__playlist.html#ga79286860a3eeada495e97c5ad1fd7ebf">api.h</a>
</li>
<li>sp_playlistcontainer_release()
: <a class="el" href="group__playlist.html#ga0311c7c3c4f26028e5edd4aacb36dbf8">api.h</a>
</li>
<li>sp_playlistcontainer_remove_callbacks()
: <a class="el" href="group__playlist.html#gafb5242b8f0f9964cec29d32f4d6c1164">api.h</a>
</li>
<li>sp_playlistcontainer_remove_playlist()
: <a class="el" href="group__playlist.html#ga1ae1d51c4305940ae5c5c98c12be0afc">api.h</a>
</li>
<li>sp_relation_type
: <a class="el" href="group__user.html#ga6af84143c0622b6fc5539bb1ae111e5b">api.h</a>
</li>
<li>SP_RELATION_TYPE_BIDIRECTIONAL
: <a class="el" href="group__user.html#gga6af84143c0622b6fc5539bb1ae111e5ba4bfef63cabd016cf1e6b11347a05d389">api.h</a>
</li>
<li>SP_RELATION_TYPE_NONE
: <a class="el" href="group__user.html#gga6af84143c0622b6fc5539bb1ae111e5bad9805f100828a9d3b64c3cc66f2ac5c1">api.h</a>
</li>
<li>SP_RELATION_TYPE_UNIDIRECTIONAL
: <a class="el" href="group__user.html#gga6af84143c0622b6fc5539bb1ae111e5ba06b2f38745c467e7e362c7744cb74205">api.h</a>
</li>
<li>SP_RELATION_TYPE_UNKNOWN
: <a class="el" href="group__user.html#gga6af84143c0622b6fc5539bb1ae111e5ba18f24164eef0e687b351c2aa6753e35e">api.h</a>
</li>
<li>sp_sampletype
: <a class="el" href="group__session.html#ga5ef462e78d5a5af60dd0e7085b1ba512">api.h</a>
</li>
<li>SP_SAMPLETYPE_INT16_NATIVE_ENDIAN
: <a class="el" href="group__session.html#gga087d21080010768316cfb55d938eb94daa829b269d191cca95ecb02c2bc59da42">api.h</a>
</li>
<li>sp_search
: <a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">api.h</a>
</li>
<li>sp_search_add_ref()
: <a class="el" href="group__search.html#ga92e45a5edb1e33e64fdb857bd8eb9ad5">api.h</a>
</li>
<li>sp_search_album()
: <a class="el" href="group__search.html#ga4ba7723e70db0c6a4569c4bcd44f0e98">api.h</a>
</li>
<li>sp_search_artist()
: <a class="el" href="group__search.html#ga79b3d532d5a20a3b2bf2a087eead7888">api.h</a>
</li>
<li>sp_search_create()
: <a class="el" href="group__search.html#ga2f64dfbcc1313e7d5179998cb28208d4">api.h</a>
</li>
<li>sp_search_did_you_mean()
: <a class="el" href="group__search.html#ga8561c1da8b93ecdc8f2d325a9d19199b">api.h</a>
</li>
<li>sp_search_error()
: <a class="el" href="group__search.html#ga7cf655e37a823f952d30270d4fb60f10">api.h</a>
</li>
<li>sp_search_is_loaded()
: <a class="el" href="group__search.html#ga70e8c404d8c7ce0bbef70c2b274417cd">api.h</a>
</li>
<li>sp_search_num_albums()
: <a class="el" href="group__search.html#ga0c456a6396c4c05fbc8677ea641ef1f7">api.h</a>
</li>
<li>sp_search_num_artists()
: <a class="el" href="group__search.html#gabd375a613c2dadecad8c13f8aca6f2d3">api.h</a>
</li>
<li>sp_search_num_playlists()
: <a class="el" href="group__search.html#gaa9f007f439d8241bf632f9abb8d926c9">api.h</a>
</li>
<li>sp_search_num_tracks()
: <a class="el" href="group__search.html#ga1dd18cf7b3b3b7f4bf6e92a2140378d0">api.h</a>
</li>
<li>sp_search_playlist()
: <a class="el" href="group__search.html#ga4175fba17f355b1c0bd361357181ea35">api.h</a>
</li>
<li>sp_search_playlist_image_uri()
: <a class="el" href="group__search.html#gac4463fab4ea25e0a5d5079c959a1781c">api.h</a>
</li>
<li>sp_search_playlist_name()
: <a class="el" href="group__search.html#ga933cd5d5a0ccca9906082ca4549a4ed7">api.h</a>
</li>
<li>sp_search_playlist_uri()
: <a class="el" href="group__search.html#ga0071a3d30f0f0c4e477bf923e9014ff5">api.h</a>
</li>
<li>sp_search_query()
: <a class="el" href="group__search.html#ga127e9c2bf98e3602ecfc2926b9d242bf">api.h</a>
</li>
<li>sp_search_release()
: <a class="el" href="group__search.html#ga4e01d43067d9f8c533c985f90143821b">api.h</a>
</li>
<li>sp_search_total_albums()
: <a class="el" href="group__search.html#gaafd3b228adbc028937383d0d45730581">api.h</a>
</li>
<li>sp_search_total_artists()
: <a class="el" href="group__search.html#ga305a4118625e0f70cfb14161a0112fd5">api.h</a>
</li>
<li>sp_search_total_playlists()
: <a class="el" href="group__search.html#ga2e286415a6ba8dbf85ea677906f2798c">api.h</a>
</li>
<li>sp_search_total_tracks()
: <a class="el" href="group__search.html#gab4e50582c517b4639fd1afd6fb011587">api.h</a>
</li>
<li>sp_search_track()
: <a class="el" href="group__search.html#gae9da7ca59ce0bbd73f7bcef4e15c4da8">api.h</a>
</li>
<li>sp_search_type
: <a class="el" href="group__session.html#ga99e8e9176ce40fff08a9be8b944edb09">api.h</a>
</li>
<li>sp_session
: <a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">api.h</a>
</li>
<li>sp_session_callbacks
: <a class="el" href="group__session.html#gaf1d92302cd5d0d4a032e1408188c8fd5">api.h</a>
</li>
<li>sp_session_config
: <a class="el" href="group__session.html#ga372b25a93da38d4d707b0c2eaa7b3ebb">api.h</a>
</li>
<li>sp_session_connectionstate()
: <a class="el" href="group__session.html#ga34a7c9527705ab7d23b742006d81ea35">api.h</a>
</li>
<li>sp_session_create()
: <a class="el" href="group__session.html#gaf2891f2daced4ff6da84219d6376b3aa">api.h</a>
</li>
<li>sp_session_flush_caches()
: <a class="el" href="group__session.html#ga34005bb06ee3de8ee4221597a0335cca">api.h</a>
</li>
<li>sp_session_forget_me()
: <a class="el" href="group__session.html#ga61e6b796d9e07682c018e888b901a191">api.h</a>
</li>
<li>sp_session_get_volume_normalization()
: <a class="el" href="group__session.html#ga7913df06394360f255c77fb87af0f1fe">api.h</a>
</li>
<li>sp_session_inbox_create()
: <a class="el" href="group__session.html#gac72ccb51031c846101134b73195bb9ec">api.h</a>
</li>
<li>sp_session_is_private_session()
: <a class="el" href="group__session.html#ga72702ee06bc96c074804388d24344149">api.h</a>
</li>
<li>sp_session_is_scrobbling()
: <a class="el" href="group__session.html#ga6a56bc82ff0b369bb6e0f035534ce33d">api.h</a>
</li>
<li>sp_session_is_scrobbling_possible()
: <a class="el" href="group__session.html#ga0fad03ceabcf8d68af78f0f35fcbcc8d">api.h</a>
</li>
<li>sp_session_login()
: <a class="el" href="group__session.html#ga4533a992a120cacb109c892a852afe2a">api.h</a>
</li>
<li>sp_session_logout()
: <a class="el" href="group__session.html#gab7f08ca0939985b30ae2d1ed9db1d726">api.h</a>
</li>
<li>sp_session_player_load()
: <a class="el" href="group__session.html#gac73bf2c569a43d824439b557d5e4b293">api.h</a>
</li>
<li>sp_session_player_play()
: <a class="el" href="group__session.html#gab66c5915967e4f90db945b118e620624">api.h</a>
</li>
<li>sp_session_player_prefetch()
: <a class="el" href="group__session.html#gaf42e30a1f430ac7c436c7d9f0485368d">api.h</a>
</li>
<li>sp_session_player_seek()
: <a class="el" href="group__session.html#ga3430cd4f11541868d3f83eaa31aecf44">api.h</a>
</li>
<li>sp_session_player_unload()
: <a class="el" href="group__session.html#gafa7ee2803f119451bb8be3bf28746975">api.h</a>
</li>
<li>sp_session_playlistcontainer()
: <a class="el" href="group__session.html#ga319767f0b795f1c46a08390b587c5671">api.h</a>
</li>
<li>sp_session_preferred_bitrate()
: <a class="el" href="group__session.html#gacd590e095b011af42fb10046117846fe">api.h</a>
</li>
<li>sp_session_preferred_offline_bitrate()
: <a class="el" href="group__session.html#ga4bba5f828d6c87692f2c355cc8f07c61">api.h</a>
</li>
<li>sp_session_process_events()
: <a class="el" href="group__session.html#gaff27cb730db6debf55e750e39e7fadd7">api.h</a>
</li>
<li>sp_session_publishedcontainer_for_user_create()
: <a class="el" href="group__session.html#ga4ad3a1de596a41f275120dad3bb4685d">api.h</a>
</li>
<li>sp_session_release()
: <a class="el" href="group__session.html#gab81c540b76f7425a9cc0dbf270c09674">api.h</a>
</li>
<li>sp_session_relogin()
: <a class="el" href="group__session.html#gae1bc9bebd230226c3d48925cd1be6edf">api.h</a>
</li>
<li>sp_session_remembered_user()
: <a class="el" href="group__session.html#gab349c7bfe59e10e167bd75c20df9fc97">api.h</a>
</li>
<li>sp_session_set_cache_size()
: <a class="el" href="group__session.html#ga6f27c55d1ce9f3f794fcce7bee7adfea">api.h</a>
</li>
<li>sp_session_set_connection_rules()
: <a class="el" href="group__session.html#ga0ac85299c37710321b6d64713e1d6ba8">api.h</a>
</li>
<li>sp_session_set_connection_type()
: <a class="el" href="group__session.html#gaf81c61799e0ccdbba048fb79ec050930">api.h</a>
</li>
<li>sp_session_set_private_session()
: <a class="el" href="group__session.html#ga42a8f0999316ac7f141926092879ad2f">api.h</a>
</li>
<li>sp_session_set_scrobbling()
: <a class="el" href="group__session.html#ga2475a1fbc2eeacccb96b7f36efd36725">api.h</a>
</li>
<li>sp_session_set_social_credentials()
: <a class="el" href="group__session.html#ga9e5ee46ef5e75aa462607caac984f2de">api.h</a>
</li>
<li>sp_session_set_volume_normalization()
: <a class="el" href="group__session.html#ga4e14f58356d00e3693be84623bf6bd11">api.h</a>
</li>
<li>sp_session_starred_create()
: <a class="el" href="group__session.html#ga02391c9e28cff0a602f7139542e0238f">api.h</a>
</li>
<li>sp_session_starred_for_user_create()
: <a class="el" href="group__session.html#ga9be806a719a6399bfe1fd0d4c125e0eb">api.h</a>
</li>
<li>sp_session_user()
: <a class="el" href="group__session.html#ga267bbcae24b6bb1fd56de56678a5f455">api.h</a>
</li>
<li>sp_session_user_country()
: <a class="el" href="group__session.html#ga54c7693afa9be664f3ea870feb0df8d9">api.h</a>
</li>
<li>sp_session_user_name()
: <a class="el" href="group__session.html#gac7a365c2166738909cdb901edebc3f70">api.h</a>
</li>
<li>sp_session_userdata()
: <a class="el" href="group__session.html#gabfb3f59b20ae0b225e154eb9095152b2">api.h</a>
</li>
<li>sp_subscribers
: <a class="el" href="group__session.html#gafb515e30d134c61b8eaaff3177af0b5b">api.h</a>
</li>
<li>SP_TOPLIST_REGION
: <a class="el" href="group__toplist.html#gaa078b44491f976af43e4941fd1dd032c">api.h</a>
</li>
<li>SP_TOPLIST_REGION_EVERYWHERE
: <a class="el" href="group__toplist.html#gga6fa5cfed2cbb33f2f64542d0b63f6c8da9e9136541401041c7d5c37708b7a927f">api.h</a>
</li>
<li>SP_TOPLIST_REGION_USER
: <a class="el" href="group__toplist.html#gga6fa5cfed2cbb33f2f64542d0b63f6c8da6912eff58c71f5c74b78f48af5305375">api.h</a>
</li>
<li>SP_TOPLIST_TYPE_ALBUMS
: <a class="el" href="group__toplist.html#gga220f32522efb2828e4f8ffb949af234aae8002818ef10eb2c75ec2058ce11cf6b">api.h</a>
</li>
<li>SP_TOPLIST_TYPE_ARTISTS
: <a class="el" href="group__toplist.html#gga220f32522efb2828e4f8ffb949af234aa41523e58badf9e3901beea3f53e5d28e">api.h</a>
</li>
<li>SP_TOPLIST_TYPE_TRACKS
: <a class="el" href="group__toplist.html#gga220f32522efb2828e4f8ffb949af234aa6a85f8384ec77cb9cb5746966b0f0e28">api.h</a>
</li>
<li>sp_toplistbrowse
: <a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">api.h</a>
</li>
<li>sp_toplistbrowse_add_ref()
: <a class="el" href="group__toplist.html#ga421a19f128e5f3ae4b36e63a133a2a83">api.h</a>
</li>
<li>sp_toplistbrowse_album()
: <a class="el" href="group__toplist.html#gaa080ace445d269f56942ac3d7f1f157e">api.h</a>
</li>
<li>sp_toplistbrowse_artist()
: <a class="el" href="group__toplist.html#ga504cc45074d40c817dffbcc2906ef57f">api.h</a>
</li>
<li>sp_toplistbrowse_backend_request_duration()
: <a class="el" href="group__toplist.html#gab9cf87d6b6a8cbd8d36cd6e94a3270ee">api.h</a>
</li>
<li>sp_toplistbrowse_create()
: <a class="el" href="group__toplist.html#gac2fe366e0050747438e09cdd22ed0e31">api.h</a>
</li>
<li>sp_toplistbrowse_error()
: <a class="el" href="group__toplist.html#ga9b881929e74d97f64814ae54953ce4d7">api.h</a>
</li>
<li>sp_toplistbrowse_is_loaded()
: <a class="el" href="group__toplist.html#gaff81156c09d311c4f6a82d28a32d7968">api.h</a>
</li>
<li>sp_toplistbrowse_num_albums()
: <a class="el" href="group__toplist.html#ga69f5e70269c1eb08e1ddb1c77bb8c3e3">api.h</a>
</li>
<li>sp_toplistbrowse_num_artists()
: <a class="el" href="group__toplist.html#gae2f5c09fbbf947834b1b1e73461f1fb3">api.h</a>
</li>
<li>sp_toplistbrowse_num_tracks()
: <a class="el" href="group__toplist.html#gaeb0ddfd565474dc7e444aabebbc119b7">api.h</a>
</li>
<li>sp_toplistbrowse_release()
: <a class="el" href="group__toplist.html#gac6cf969c9cb6b431aeaa4723820ca8de">api.h</a>
</li>
<li>sp_toplistbrowse_track()
: <a class="el" href="group__toplist.html#gaf3d00b8bf089134a4f320a8d3d6ab683">api.h</a>
</li>
<li>sp_toplistregion
: <a class="el" href="group__toplist.html#ga6fa5cfed2cbb33f2f64542d0b63f6c8d">api.h</a>
</li>
<li>sp_toplisttype
: <a class="el" href="group__toplist.html#ga220f32522efb2828e4f8ffb949af234a">api.h</a>
</li>
<li>sp_track
: <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">api.h</a>
</li>
<li>sp_track_add_ref()
: <a class="el" href="group__track.html#ga7d86041a2bf75590f55978521c08e38c">api.h</a>
</li>
<li>sp_track_album()
: <a class="el" href="group__track.html#ga39a0f52244472cb2d450ea9ba6807304">api.h</a>
</li>
<li>sp_track_artist()
: <a class="el" href="group__track.html#ga67cd0c035627a1e4a54642213fdf1d75">api.h</a>
</li>
<li>sp_track_availability
: <a class="el" href="group__session.html#ga60c7ff53ddbc04c036a23181b7275d69">api.h</a>
</li>
<li>SP_TRACK_AVAILABILITY_AVAILABLE
: <a class="el" href="group__session.html#ggad7d9465769597b2a379ac704099adfdfa3b837ba6d740b5650b0113734a3b2ff7">api.h</a>
</li>
<li>SP_TRACK_AVAILABILITY_BANNED_BY_ARTIST
: <a class="el" href="group__session.html#ggad7d9465769597b2a379ac704099adfdfaeb5d63e89c543f513cd3054969e50914">api.h</a>
</li>
<li>SP_TRACK_AVAILABILITY_NOT_STREAMABLE
: <a class="el" href="group__session.html#ggad7d9465769597b2a379ac704099adfdfae7b2cfafa10288ecc50df97621bbe940">api.h</a>
</li>
<li>SP_TRACK_AVAILABILITY_UNAVAILABLE
: <a class="el" href="group__session.html#ggad7d9465769597b2a379ac704099adfdfa44bc1e6f138910b3f8dbd309325e0077">api.h</a>
</li>
<li>sp_track_disc()
: <a class="el" href="group__track.html#ga9d464ee4a5c8836b59888952b960223a">api.h</a>
</li>
<li>sp_track_duration()
: <a class="el" href="group__track.html#gac817937bd8d8355b6a1949b76d0b5560">api.h</a>
</li>
<li>sp_track_error()
: <a class="el" href="group__track.html#ga947c0f7755b0c4955ca0b0993db0f2b5">api.h</a>
</li>
<li>sp_track_get_availability()
: <a class="el" href="group__track.html#ga9c78846badae6567fe9f9a3792fd06c8">api.h</a>
</li>
<li>sp_track_get_playable()
: <a class="el" href="group__track.html#ga112dca47d0bac39818b55119ef134ffd">api.h</a>
</li>
<li>sp_track_index()
: <a class="el" href="group__track.html#ga25c1df9d32fd58f243397740b29c3f61">api.h</a>
</li>
<li>sp_track_is_autolinked()
: <a class="el" href="group__track.html#ga4eeb86de13187697cd9dfe0b0934988d">api.h</a>
</li>
<li>sp_track_is_loaded()
: <a class="el" href="group__track.html#ga8b69cf193679c7e00031ae43e61c6a54">api.h</a>
</li>
<li>sp_track_is_local()
: <a class="el" href="group__track.html#gabcb75da69e0338006bdbd2f2f467f082">api.h</a>
</li>
<li>sp_track_is_placeholder()
: <a class="el" href="group__track.html#ga2367d906c578e674d0d470d8c1ee3b33">api.h</a>
</li>
<li>sp_track_is_starred()
: <a class="el" href="group__track.html#gab17d380ac941e102af0f308ad885b3c3">api.h</a>
</li>
<li>sp_track_name()
: <a class="el" href="group__track.html#ga8eb423d3cc2cbfb743c7f23ffb8d0fad">api.h</a>
</li>
<li>sp_track_num_artists()
: <a class="el" href="group__track.html#ga0aa945fc43e35d36cc334a52735d83b2">api.h</a>
</li>
<li>SP_TRACK_OFFLINE_DONE
: <a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fac54d46cbc73de7686a1ad8daf269532a">api.h</a>
</li>
<li>SP_TRACK_OFFLINE_DONE_EXPIRED
: <a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa00fe430030fb6a8a49a46c11cca7326c">api.h</a>
</li>
<li>SP_TRACK_OFFLINE_DONE_RESYNC
: <a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa5f3e19627de4509ae4a3864fd29edee6">api.h</a>
</li>
<li>SP_TRACK_OFFLINE_DOWNLOADING
: <a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa7dcf6dfc56a8421200451d07a476f370">api.h</a>
</li>
<li>SP_TRACK_OFFLINE_ERROR
: <a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa86618798c266540bdc889dd037a52631">api.h</a>
</li>
<li>sp_track_offline_get_status()
: <a class="el" href="group__track.html#ga281e0ad4373579c5d24202ea1f93fe7b">api.h</a>
</li>
<li>SP_TRACK_OFFLINE_LIMIT_EXCEEDED
: <a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa405a9b7a3fa489ad2dadbb108794e247">api.h</a>
</li>
<li>SP_TRACK_OFFLINE_NO
: <a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203faad1a1cba82ce9f9be678f4d1042eddec">api.h</a>
</li>
<li>sp_track_offline_status
: <a class="el" href="group__session.html#gaeaa41aad3c0047409996a6ec3b03203f">api.h</a>
</li>
<li>SP_TRACK_OFFLINE_WAITING
: <a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa1fdd2a518dcdc072cfca27a0ca4f2581">api.h</a>
</li>
<li>sp_track_popularity()
: <a class="el" href="group__track.html#ga4570f08f968edbff519b44d2241d2255">api.h</a>
</li>
<li>sp_track_release()
: <a class="el" href="group__track.html#gaa11098d82e6c2ae42fc2ea1486e741de">api.h</a>
</li>
<li>sp_track_set_starred()
: <a class="el" href="group__track.html#ga34b5a712fb2c683402ff78df73e7545c">api.h</a>
</li>
<li>sp_user
: <a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">api.h</a>
</li>
<li>sp_user_add_ref()
: <a class="el" href="group__user.html#ga232816a3c8f42ef2663b8d99261f2dae">api.h</a>
</li>
<li>sp_user_canonical_name()
: <a class="el" href="group__user.html#gad9ac5456cd129c31d2c577ba14e88f8c">api.h</a>
</li>
<li>sp_user_display_name()
: <a class="el" href="group__user.html#ga0052befb81a93bb7106ca863de892610">api.h</a>
</li>
<li>sp_user_is_loaded()
: <a class="el" href="group__user.html#ga0996fb9814564e4ad39b8a500cb3de21">api.h</a>
</li>
<li>sp_user_release()
: <a class="el" href="group__user.html#gab1ffba4355073e1f72594c9e1b22ebb4">api.h</a>
</li>
<li>SPOTIFY_API_VERSION
: <a class="el" href="group__session.html#ga63b2309874193750ec3395f6cae32899">api.h</a>
</li>
</ul>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/globals_0x74.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Data Fields</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="files.html"><span>File&nbsp;List</span></a></li>
      <li class="current"><a href="globals.html"><span>Globals</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li class="current"><a href="globals.html"><span>All</span></a></li>
      <li><a href="globals_func.html"><span>Functions</span></a></li>
      <li><a href="globals_type.html"><span>Typedefs</span></a></li>
      <li><a href="globals_enum.html"><span>Enumerations</span></a></li>
      <li><a href="globals_eval.html"><span>Enumerator</span></a></li>
      <li><a href="globals_defs.html"><span>Defines</span></a></li>
    </ul>
  </div>
  <div class="tabs3">
    <ul class="tablist">
      <li><a href="globals.html#index_a"><span>a</span></a></li>
      <li><a href="globals_0x69.html#index_i"><span>i</span></a></li>
      <li><a href="globals_0x73.html#index_s"><span>s</span></a></li>
      <li class="current"><a href="globals_0x74.html#index_t"><span>t</span></a></li>
    </ul>
  </div>
</div>
<div class="contents">
Here is a list of all documented functions, variables, defines, enums, and typedefs with links to the documentation:

<h3><a class="anchor" id="index_t"></a>- t -</h3><ul>
<li>toplistbrowse_complete_cb
: <a class="el" href="group__toplist.html#gafe8e94ae23133105f35c03b9e3836a0a">api.h</a>
</li>
</ul>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/globals_defs.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Data Fields</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="files.html"><span>File&nbsp;List</span></a></li>
      <li class="current"><a href="globals.html"><span>Globals</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="globals.html"><span>All</span></a></li>
      <li><a href="globals_func.html"><span>Functions</span></a></li>
      <li><a href="globals_type.html"><span>Typedefs</span></a></li>
      <li><a href="globals_enum.html"><span>Enumerations</span></a></li>
      <li><a href="globals_eval.html"><span>Enumerator</span></a></li>
      <li class="current"><a href="globals_defs.html"><span>Defines</span></a></li>
    </ul>
  </div>
</div>
<div class="contents">
&nbsp;<ul>
<li>SP_TOPLIST_REGION
: <a class="el" href="group__toplist.html#gaa078b44491f976af43e4941fd1dd032c">api.h</a>
</li>
<li>SPOTIFY_API_VERSION
: <a class="el" href="group__session.html#ga63b2309874193750ec3395f6cae32899">api.h</a>
</li>
</ul>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/globals_enum.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Data Fields</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="files.html"><span>File&nbsp;List</span></a></li>
      <li class="current"><a href="globals.html"><span>Globals</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="globals.html"><span>All</span></a></li>
      <li><a href="globals_func.html"><span>Functions</span></a></li>
      <li><a href="globals_type.html"><span>Typedefs</span></a></li>
      <li class="current"><a href="globals_enum.html"><span>Enumerations</span></a></li>
      <li><a href="globals_eval.html"><span>Enumerator</span></a></li>
      <li><a href="globals_defs.html"><span>Defines</span></a></li>
    </ul>
  </div>
</div>
<div class="contents">
&nbsp;<ul>
<li>sp_albumtype
: <a class="el" href="group__album.html#ga019b49a9d1633b61daa79c80ea01d5c3">api.h</a>
</li>
<li>sp_artistbrowse_type
: <a class="el" href="group__session.html#gac86504cc9e8cadbc30c8aa8dbf355034">api.h</a>
</li>
<li>sp_availability
: <a class="el" href="group__session.html#gad7d9465769597b2a379ac704099adfdf">api.h</a>
</li>
<li>sp_bitrate
: <a class="el" href="group__session.html#ga77ddd919314a7bb16140569af7a38fe2">api.h</a>
</li>
<li>sp_connection_rules
: <a class="el" href="group__session.html#gad275d696685b2ad9ff1a2c3e16af6502">api.h</a>
</li>
<li>sp_connection_type
: <a class="el" href="group__session.html#ga3e8773baeb94189b9a1ff27d6a5e3553">api.h</a>
</li>
<li>sp_connectionstate
: <a class="el" href="group__session.html#gabf77bb5a124d5a6ee9a12c86abbc0d34">api.h</a>
</li>
<li>sp_error
: <a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">api.h</a>
</li>
<li>sp_image_size
: <a class="el" href="group__session.html#ga61bc424465d776af3ceeb69eee2bb492">api.h</a>
</li>
<li>sp_imageformat
: <a class="el" href="group__image.html#ga2cda19baf2460da5e81fb1917f54626b">api.h</a>
</li>
<li>sp_linktype
: <a class="el" href="group__link.html#gabe9611f04086cdbed6e4e6e1fd913b98">api.h</a>
</li>
<li>sp_playlist_offline_status
: <a class="el" href="group__session.html#ga811fa52ed0fdb5cda732682e27e40417">api.h</a>
</li>
<li>sp_playlist_type
: <a class="el" href="group__session.html#gafdd7117213605e6f2671c4f289b44609">api.h</a>
</li>
<li>sp_relation_type
: <a class="el" href="group__user.html#ga6af84143c0622b6fc5539bb1ae111e5b">api.h</a>
</li>
<li>sp_sampletype
: <a class="el" href="group__session.html#ga087d21080010768316cfb55d938eb94d">api.h</a>
</li>
<li>sp_search_type
: <a class="el" href="group__session.html#ga99e8e9176ce40fff08a9be8b944edb09">api.h</a>
</li>
<li>sp_toplistregion
: <a class="el" href="group__toplist.html#ga6fa5cfed2cbb33f2f64542d0b63f6c8d">api.h</a>
</li>
<li>sp_toplisttype
: <a class="el" href="group__toplist.html#ga220f32522efb2828e4f8ffb949af234a">api.h</a>
</li>
<li>sp_track_offline_status
: <a class="el" href="group__session.html#gaeaa41aad3c0047409996a6ec3b03203f">api.h</a>
</li>
</ul>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/globals_eval.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Data Fields</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="files.html"><span>File&nbsp;List</span></a></li>
      <li class="current"><a href="globals.html"><span>Globals</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="globals.html"><span>All</span></a></li>
      <li><a href="globals_func.html"><span>Functions</span></a></li>
      <li><a href="globals_type.html"><span>Typedefs</span></a></li>
      <li><a href="globals_enum.html"><span>Enumerations</span></a></li>
      <li class="current"><a href="globals_eval.html"><span>Enumerator</span></a></li>
      <li><a href="globals_defs.html"><span>Defines</span></a></li>
    </ul>
  </div>
  <div class="tabs3">
    <ul class="tablist">
      <li><a href="#index_s"><span>s</span></a></li>
    </ul>
  </div>
</div>
<div class="contents">
&nbsp;

<h3><a class="anchor" id="index_s"></a>- s -</h3><ul>
<li>SP_ALBUMTYPE_ALBUM
: <a class="el" href="group__album.html#gga019b49a9d1633b61daa79c80ea01d5c3ad1693d93a2c05c053fc4fd77886af8dd">api.h</a>
</li>
<li>SP_ALBUMTYPE_COMPILATION
: <a class="el" href="group__album.html#gga019b49a9d1633b61daa79c80ea01d5c3a8fee6ba46e8876037f4f2e46c6d6c6af">api.h</a>
</li>
<li>SP_ALBUMTYPE_SINGLE
: <a class="el" href="group__album.html#gga019b49a9d1633b61daa79c80ea01d5c3a3b6f78b733f1bc18a5e4fa18c020fc73">api.h</a>
</li>
<li>SP_ALBUMTYPE_UNKNOWN
: <a class="el" href="group__album.html#gga019b49a9d1633b61daa79c80ea01d5c3ad564ed5f1f0659929fe5ec700513873f">api.h</a>
</li>
<li>SP_ARTISTBROWSE_FULL
: <a class="el" href="group__session.html#ggac86504cc9e8cadbc30c8aa8dbf355034a2914168528aded818177c013a0dd7e87">api.h</a>
</li>
<li>SP_ARTISTBROWSE_NO_ALBUMS
: <a class="el" href="group__session.html#ggac86504cc9e8cadbc30c8aa8dbf355034ac0032981f8dbf44c022e6a7ab1672167">api.h</a>
</li>
<li>SP_ARTISTBROWSE_NO_TRACKS
: <a class="el" href="group__session.html#ggac86504cc9e8cadbc30c8aa8dbf355034afbad1e58606b3230dce5bc3320c95d12">api.h</a>
</li>
<li>SP_BITRATE_160k
: <a class="el" href="group__session.html#gga77ddd919314a7bb16140569af7a38fe2a5b5c794224972f833a4b7eec9d7909c9">api.h</a>
</li>
<li>SP_BITRATE_320k
: <a class="el" href="group__session.html#gga77ddd919314a7bb16140569af7a38fe2a9383c0dc9faefd2cbb38c3b9342c47e0">api.h</a>
</li>
<li>SP_BITRATE_96k
: <a class="el" href="group__session.html#gga77ddd919314a7bb16140569af7a38fe2ad815a35af7e6bb5e2ef29418af62759b">api.h</a>
</li>
<li>SP_CONNECTION_RULE_ALLOW_SYNC_OVER_MOBILE
: <a class="el" href="group__session.html#ggad275d696685b2ad9ff1a2c3e16af6502a91a946573c44de44d74e9d20dbce4c74">api.h</a>
</li>
<li>SP_CONNECTION_RULE_ALLOW_SYNC_OVER_WIFI
: <a class="el" href="group__session.html#ggad275d696685b2ad9ff1a2c3e16af6502a548f3734832ec65a992e598d8b91633d">api.h</a>
</li>
<li>SP_CONNECTION_RULE_NETWORK
: <a class="el" href="group__session.html#ggad275d696685b2ad9ff1a2c3e16af6502aa39a1c21c17c55cd1547bc900ae2d386">api.h</a>
</li>
<li>SP_CONNECTION_RULE_NETWORK_IF_ROAMING
: <a class="el" href="group__session.html#ggad275d696685b2ad9ff1a2c3e16af6502af2772ba84ee7e410ad99708a11955670">api.h</a>
</li>
<li>SP_CONNECTION_STATE_DISCONNECTED
: <a class="el" href="group__session.html#ggabf77bb5a124d5a6ee9a12c86abbc0d34ad1a6eb721675af4613f823c091538a8c">api.h</a>
</li>
<li>SP_CONNECTION_STATE_LOGGED_IN
: <a class="el" href="group__session.html#ggabf77bb5a124d5a6ee9a12c86abbc0d34a88ae17b4168184e62e4c190c289c47c5">api.h</a>
</li>
<li>SP_CONNECTION_STATE_LOGGED_OUT
: <a class="el" href="group__session.html#ggabf77bb5a124d5a6ee9a12c86abbc0d34ae31e9958a98211ecff5ecbcf7041dfa5">api.h</a>
</li>
<li>SP_CONNECTION_STATE_OFFLINE
: <a class="el" href="group__session.html#ggabf77bb5a124d5a6ee9a12c86abbc0d34a63099ef9185ba287fcd2e77be3c47d8f">api.h</a>
</li>
<li>SP_CONNECTION_STATE_UNDEFINED
: <a class="el" href="group__session.html#ggabf77bb5a124d5a6ee9a12c86abbc0d34a4ddf57518007eef86b06f496d7059484">api.h</a>
</li>
<li>SP_CONNECTION_TYPE_MOBILE
: <a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553a3ca3e6a85ac9d497914c35620ad5179d">api.h</a>
</li>
<li>SP_CONNECTION_TYPE_MOBILE_ROAMING
: <a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553a05b41bbfd369f9030a7daafc9395116e">api.h</a>
</li>
<li>SP_CONNECTION_TYPE_NONE
: <a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553aa7aae7ae3f7c471ece1c6aa2705d046c">api.h</a>
</li>
<li>SP_CONNECTION_TYPE_UNKNOWN
: <a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553af949fae9bc12f47b99ef290fa9b5d8a7">api.h</a>
</li>
<li>SP_CONNECTION_TYPE_WIFI
: <a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553a31d2cad7379f1bc2eeedd24c40541cb9">api.h</a>
</li>
<li>SP_CONNECTION_TYPE_WIRED
: <a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553a4f9f0c09e59af4114bb369ebcc474710">api.h</a>
</li>
<li>SP_ERROR_API_INITIALIZATION_FAILED
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6bac8c438bd52975d14edf23d040e93d114">api.h</a>
</li>
<li>SP_ERROR_APPLICATION_BANNED
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba46c3b6173bb5b09445164402ac5ed81f">api.h</a>
</li>
<li>SP_ERROR_BAD_API_VERSION
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba17c588fa9648e3649185e595bdb88d6f">api.h</a>
</li>
<li>SP_ERROR_BAD_APPLICATION_KEY
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba2bad808a467ee4418adaa40f4844d059">api.h</a>
</li>
<li>SP_ERROR_BAD_USER_AGENT
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baf3597d4af35adb4fc0d0793ea26f77b4">api.h</a>
</li>
<li>SP_ERROR_BAD_USERNAME_OR_PASSWORD
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba41052a4a158fa18bb1b8bfdd8c37f7dc">api.h</a>
</li>
<li>SP_ERROR_CANT_OPEN_TRACE_FILE
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6badb3af1736912156cbe0b1e39eaeee1c8">api.h</a>
</li>
<li>SP_ERROR_CLIENT_TOO_OLD
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba995344026c012b3f59dc73e12c28b1ba">api.h</a>
</li>
<li>SP_ERROR_INBOX_IS_FULL
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baa4bdf4298c9653549464d21ee528c881">api.h</a>
</li>
<li>SP_ERROR_INDEX_OUT_OF_RANGE
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba44b3f132578cbf9a43b5c048efcf63a2">api.h</a>
</li>
<li>SP_ERROR_INVALID_ARGUMENT
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba7f8be4d478e51d2b205157c7c538a3e5">api.h</a>
</li>
<li>SP_ERROR_INVALID_DEVICE_ID
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba846d94ada9e8db0c2bd5153f5801afa2">api.h</a>
</li>
<li>SP_ERROR_INVALID_INDATA
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6bac9f65a7270391d35342ca9e6c01d519d">api.h</a>
</li>
<li>SP_ERROR_IS_LOADING
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba17f54c30d01baedc24547e62ed417cdd">api.h</a>
</li>
<li>SP_ERROR_LASTFM_AUTH_ERROR
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baf588c0f7a2d8d11acea28ac2a4de43c4">api.h</a>
</li>
<li>SP_ERROR_MISSING_CALLBACK
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6babb1116e69e1d651f9f175dbc8bb5fa32">api.h</a>
</li>
<li>SP_ERROR_NETWORK_DISABLED
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba8fda4dd3ee6ac931337a871fbee02978">api.h</a>
</li>
<li>SP_ERROR_NO_CACHE
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba3b8851ee3ba2bd7ad1fe377d94ac38c0">api.h</a>
</li>
<li>SP_ERROR_NO_CREDENTIALS
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba9ad34b997313d790f142f24e77e78e2d">api.h</a>
</li>
<li>SP_ERROR_NO_STREAM_AVAILABLE
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba71307cc7b8460042603f3f322d1096f4">api.h</a>
</li>
<li>SP_ERROR_NO_SUCH_USER
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baf8ade144869c958de534ecec9f9a36a9">api.h</a>
</li>
<li>SP_ERROR_OFFLINE_DISK_CACHE
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6bae6b9d9b013f1243548e4fbcf961559ff">api.h</a>
</li>
<li>SP_ERROR_OFFLINE_EXPIRED
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba7e16a1962fd4de081d73dc4a4e32eb04">api.h</a>
</li>
<li>SP_ERROR_OFFLINE_LICENSE_ERROR
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba9149b343017c0dea431839c8b4d9198c">api.h</a>
</li>
<li>SP_ERROR_OFFLINE_LICENSE_LOST
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba2c87afb46df21783f172a06b2c25d8f9">api.h</a>
</li>
<li>SP_ERROR_OFFLINE_NOT_ALLOWED
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6bae102b46f4fae3b7b6b34e21ea80d656f">api.h</a>
</li>
<li>SP_ERROR_OFFLINE_TOO_MANY_TRACKS
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba32fd1f63fd4dc7ec50bd11791f02953f">api.h</a>
</li>
<li>SP_ERROR_OK
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba16cb277dc84328e4b2c0cf6d5a0c0b8d">api.h</a>
</li>
<li>SP_ERROR_OTHER_PERMANENT
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba3f68775a5c001bd1de26afdf5ea4e09d">api.h</a>
</li>
<li>SP_ERROR_OTHER_TRANSIENT
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baf139c18351a543862bd9393ccebc5f91">api.h</a>
</li>
<li>SP_ERROR_PERMISSION_DENIED
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baaddac1f3b82e905711ab9ffe5b4b0329">api.h</a>
</li>
<li>SP_ERROR_SYSTEM_FAILURE
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba73d533e0f25f4ba4cecd6d2e2502b80b">api.h</a>
</li>
<li>SP_ERROR_TRACK_NOT_PLAYABLE
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba7b94fe2b53f58d91d4c3cda7bb706ff3">api.h</a>
</li>
<li>SP_ERROR_UNABLE_TO_CONTACT_SERVER
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba9d11d66176b6ae95bf00486e9e39866b">api.h</a>
</li>
<li>SP_ERROR_USER_BANNED
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba822f4031a82ab428cd04f2ecdc0e757f">api.h</a>
</li>
<li>SP_ERROR_USER_NEEDS_PREMIUM
: <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba96c08adfcda17005c63142cd4e4cd9bb">api.h</a>
</li>
<li>SP_IMAGE_FORMAT_JPEG
: <a class="el" href="group__image.html#gga2cda19baf2460da5e81fb1917f54626ba6263674800bea702c4d913d4b07c135d">api.h</a>
</li>
<li>SP_IMAGE_FORMAT_UNKNOWN
: <a class="el" href="group__image.html#gga2cda19baf2460da5e81fb1917f54626ba2fec8a1b400bd6cd5396b9852e4279b6">api.h</a>
</li>
<li>SP_IMAGE_SIZE_LARGE
: <a class="el" href="group__session.html#gga61bc424465d776af3ceeb69eee2bb492a0a0b624afbb2a66ee3d7954202b89721">api.h</a>
</li>
<li>SP_IMAGE_SIZE_NORMAL
: <a class="el" href="group__session.html#gga61bc424465d776af3ceeb69eee2bb492ad20c808fd1f8180d1f49f643975d1dd7">api.h</a>
</li>
<li>SP_IMAGE_SIZE_SMALL
: <a class="el" href="group__session.html#gga61bc424465d776af3ceeb69eee2bb492ab9340b1bcf2129c3ad1328ea617d547f">api.h</a>
</li>
<li>SP_LINKTYPE_ALBUM
: <a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a7716eb95eed852d08300e6e64febc7f3">api.h</a>
</li>
<li>SP_LINKTYPE_ARTIST
: <a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a4402b3b001aebb39fd55296f83c60b7e">api.h</a>
</li>
<li>SP_LINKTYPE_IMAGE
: <a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a1b20b8e2b8773df47b241dc7d28ea0e8">api.h</a>
</li>
<li>SP_LINKTYPE_INVALID
: <a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a88b0098486cde586b4dcffb623ac6e63">api.h</a>
</li>
<li>SP_LINKTYPE_LOCALTRACK
: <a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a0698cd0123190c7af55daf79bb642805">api.h</a>
</li>
<li>SP_LINKTYPE_PLAYLIST
: <a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a2640ed065a64b6a9f67e71bbeb2af2dd">api.h</a>
</li>
<li>SP_LINKTYPE_PROFILE
: <a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98ab7a356adce8b1ea34daf21532c7b50e6">api.h</a>
</li>
<li>SP_LINKTYPE_SEARCH
: <a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98ad5909ab9b1cca702163e116b04b6ee8e">api.h</a>
</li>
<li>SP_LINKTYPE_STARRED
: <a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98ab649bd86d0fc55ab3fafed3050261353">api.h</a>
</li>
<li>SP_LINKTYPE_TRACK
: <a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a5911dbb7258ed160b2f9c114cef152f1">api.h</a>
</li>
<li>SP_PLAYLIST_OFFLINE_STATUS_DOWNLOADING
: <a class="el" href="group__session.html#gga811fa52ed0fdb5cda732682e27e40417abc999c70761d392b26753708e9a2cfa1">api.h</a>
</li>
<li>SP_PLAYLIST_OFFLINE_STATUS_NO
: <a class="el" href="group__session.html#gga811fa52ed0fdb5cda732682e27e40417abef62e4e3a4af8827fed7fe3aa733ca0">api.h</a>
</li>
<li>SP_PLAYLIST_OFFLINE_STATUS_WAITING
: <a class="el" href="group__session.html#gga811fa52ed0fdb5cda732682e27e40417a7d929bbf4f1df3633b283e39b9c95919">api.h</a>
</li>
<li>SP_PLAYLIST_OFFLINE_STATUS_YES
: <a class="el" href="group__session.html#gga811fa52ed0fdb5cda732682e27e40417affed38ac820e084b96fb48e3d1939584">api.h</a>
</li>
<li>SP_PLAYLIST_TYPE_END_FOLDER
: <a class="el" href="group__session.html#ggafdd7117213605e6f2671c4f289b44609a3ec52ad1d99d8e32e1b9de31e3f5187a">api.h</a>
</li>
<li>SP_PLAYLIST_TYPE_PLACEHOLDER
: <a class="el" href="group__session.html#ggafdd7117213605e6f2671c4f289b44609ad4f860ef76154e3e2c0d9da2f57a2784">api.h</a>
</li>
<li>SP_PLAYLIST_TYPE_PLAYLIST
: <a class="el" href="group__session.html#ggafdd7117213605e6f2671c4f289b44609a6bd6bf9b62018fa9bbf969835c2f3077">api.h</a>
</li>
<li>SP_PLAYLIST_TYPE_START_FOLDER
: <a class="el" href="group__session.html#ggafdd7117213605e6f2671c4f289b44609a4d3266991787f9438deb9de83d9200da">api.h</a>
</li>
<li>SP_RELATION_TYPE_BIDIRECTIONAL
: <a class="el" href="group__user.html#gga6af84143c0622b6fc5539bb1ae111e5ba4bfef63cabd016cf1e6b11347a05d389">api.h</a>
</li>
<li>SP_RELATION_TYPE_NONE
: <a class="el" href="group__user.html#gga6af84143c0622b6fc5539bb1ae111e5bad9805f100828a9d3b64c3cc66f2ac5c1">api.h</a>
</li>
<li>SP_RELATION_TYPE_UNIDIRECTIONAL
: <a class="el" href="group__user.html#gga6af84143c0622b6fc5539bb1ae111e5ba06b2f38745c467e7e362c7744cb74205">api.h</a>
</li>
<li>SP_RELATION_TYPE_UNKNOWN
: <a class="el" href="group__user.html#gga6af84143c0622b6fc5539bb1ae111e5ba18f24164eef0e687b351c2aa6753e35e">api.h</a>
</li>
<li>SP_SAMPLETYPE_INT16_NATIVE_ENDIAN
: <a class="el" href="group__session.html#gga087d21080010768316cfb55d938eb94daa829b269d191cca95ecb02c2bc59da42">api.h</a>
</li>
<li>SP_TOPLIST_REGION_EVERYWHERE
: <a class="el" href="group__toplist.html#gga6fa5cfed2cbb33f2f64542d0b63f6c8da9e9136541401041c7d5c37708b7a927f">api.h</a>
</li>
<li>SP_TOPLIST_REGION_USER
: <a class="el" href="group__toplist.html#gga6fa5cfed2cbb33f2f64542d0b63f6c8da6912eff58c71f5c74b78f48af5305375">api.h</a>
</li>
<li>SP_TOPLIST_TYPE_ALBUMS
: <a class="el" href="group__toplist.html#gga220f32522efb2828e4f8ffb949af234aae8002818ef10eb2c75ec2058ce11cf6b">api.h</a>
</li>
<li>SP_TOPLIST_TYPE_ARTISTS
: <a class="el" href="group__toplist.html#gga220f32522efb2828e4f8ffb949af234aa41523e58badf9e3901beea3f53e5d28e">api.h</a>
</li>
<li>SP_TOPLIST_TYPE_TRACKS
: <a class="el" href="group__toplist.html#gga220f32522efb2828e4f8ffb949af234aa6a85f8384ec77cb9cb5746966b0f0e28">api.h</a>
</li>
<li>SP_TRACK_AVAILABILITY_AVAILABLE
: <a class="el" href="group__session.html#ggad7d9465769597b2a379ac704099adfdfa3b837ba6d740b5650b0113734a3b2ff7">api.h</a>
</li>
<li>SP_TRACK_AVAILABILITY_BANNED_BY_ARTIST
: <a class="el" href="group__session.html#ggad7d9465769597b2a379ac704099adfdfaeb5d63e89c543f513cd3054969e50914">api.h</a>
</li>
<li>SP_TRACK_AVAILABILITY_NOT_STREAMABLE
: <a class="el" href="group__session.html#ggad7d9465769597b2a379ac704099adfdfae7b2cfafa10288ecc50df97621bbe940">api.h</a>
</li>
<li>SP_TRACK_AVAILABILITY_UNAVAILABLE
: <a class="el" href="group__session.html#ggad7d9465769597b2a379ac704099adfdfa44bc1e6f138910b3f8dbd309325e0077">api.h</a>
</li>
<li>SP_TRACK_OFFLINE_DONE
: <a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fac54d46cbc73de7686a1ad8daf269532a">api.h</a>
</li>
<li>SP_TRACK_OFFLINE_DONE_EXPIRED
: <a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa00fe430030fb6a8a49a46c11cca7326c">api.h</a>
</li>
<li>SP_TRACK_OFFLINE_DONE_RESYNC
: <a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa5f3e19627de4509ae4a3864fd29edee6">api.h</a>
</li>
<li>SP_TRACK_OFFLINE_DOWNLOADING
: <a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa7dcf6dfc56a8421200451d07a476f370">api.h</a>
</li>
<li>SP_TRACK_OFFLINE_ERROR
: <a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa86618798c266540bdc889dd037a52631">api.h</a>
</li>
<li>SP_TRACK_OFFLINE_LIMIT_EXCEEDED
: <a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa405a9b7a3fa489ad2dadbb108794e247">api.h</a>
</li>
<li>SP_TRACK_OFFLINE_NO
: <a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203faad1a1cba82ce9f9be678f4d1042eddec">api.h</a>
</li>
<li>SP_TRACK_OFFLINE_WAITING
: <a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa1fdd2a518dcdc072cfca27a0ca4f2581">api.h</a>
</li>
</ul>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/globals_func.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Data Fields</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="files.html"><span>File&nbsp;List</span></a></li>
      <li class="current"><a href="globals.html"><span>Globals</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="globals.html"><span>All</span></a></li>
      <li class="current"><a href="globals_func.html"><span>Functions</span></a></li>
      <li><a href="globals_type.html"><span>Typedefs</span></a></li>
      <li><a href="globals_enum.html"><span>Enumerations</span></a></li>
      <li><a href="globals_eval.html"><span>Enumerator</span></a></li>
      <li><a href="globals_defs.html"><span>Defines</span></a></li>
    </ul>
  </div>
  <div class="tabs3">
    <ul class="tablist">
      <li class="current"><a href="globals_func.html#index_s"><span>s</span></a></li>
    </ul>
  </div>
</div>
<div class="contents">
&nbsp;

<h3><a class="anchor" id="index_s"></a>- s -</h3><ul>
<li>sp_album_add_ref()
: <a class="el" href="group__album.html#ga08192dd38d1c628f7b51615fffa33017">api.h</a>
</li>
<li>sp_album_artist()
: <a class="el" href="group__album.html#ga42309972141dab10c32d741d357c01de">api.h</a>
</li>
<li>sp_album_cover()
: <a class="el" href="group__album.html#ga6616ef3df724af185c5eb58e8a0fb808">api.h</a>
</li>
<li>sp_album_is_available()
: <a class="el" href="group__album.html#ga89eb8dc73a76f5e0509b1066426495f7">api.h</a>
</li>
<li>sp_album_is_loaded()
: <a class="el" href="group__album.html#ga46fbfa98be12c2f4067d5e679552cfb9">api.h</a>
</li>
<li>sp_album_name()
: <a class="el" href="group__album.html#ga0e828c991a8184d60026513f944e19ad">api.h</a>
</li>
<li>sp_album_release()
: <a class="el" href="group__album.html#ga5c6e49d04ffb05c722db5e78c9434b88">api.h</a>
</li>
<li>sp_album_type()
: <a class="el" href="group__album.html#ga8dceb04a62bdb3ffc112ed0efc359e51">api.h</a>
</li>
<li>sp_album_year()
: <a class="el" href="group__album.html#ga2aadf934b0af43c3ef6ee98b6a8065fd">api.h</a>
</li>
<li>sp_albumbrowse_add_ref()
: <a class="el" href="group__albumbrowse.html#ga1afd6a10febf31a61cf356673cb34bef">api.h</a>
</li>
<li>sp_albumbrowse_album()
: <a class="el" href="group__albumbrowse.html#gaf0dadfc4edb48a3558b606e30e8bedfa">api.h</a>
</li>
<li>sp_albumbrowse_artist()
: <a class="el" href="group__albumbrowse.html#ga4f835537a65bcac9ec52cef1058a44bc">api.h</a>
</li>
<li>sp_albumbrowse_backend_request_duration()
: <a class="el" href="group__albumbrowse.html#ga2f1e1049065e8c090c010f8e43061bd4">api.h</a>
</li>
<li>sp_albumbrowse_copyright()
: <a class="el" href="group__albumbrowse.html#ga34b205daa2960e8d02a6e1accd80ab92">api.h</a>
</li>
<li>sp_albumbrowse_create()
: <a class="el" href="group__albumbrowse.html#gaf1bc3042e748efea5ca7ac159e5cbfbe">api.h</a>
</li>
<li>sp_albumbrowse_error()
: <a class="el" href="group__albumbrowse.html#ga153417eee319e7711b66503f88fba88b">api.h</a>
</li>
<li>sp_albumbrowse_is_loaded()
: <a class="el" href="group__albumbrowse.html#gad618d2752eb55173ab373d1407971960">api.h</a>
</li>
<li>sp_albumbrowse_num_copyrights()
: <a class="el" href="group__albumbrowse.html#gab53fa74ee1958dad5186be09e70ddc4a">api.h</a>
</li>
<li>sp_albumbrowse_num_tracks()
: <a class="el" href="group__albumbrowse.html#ga3fb91de745ca07d3801a57288f2d9da7">api.h</a>
</li>
<li>sp_albumbrowse_release()
: <a class="el" href="group__albumbrowse.html#gabdd5a4e3b2098166b67e35979f59613d">api.h</a>
</li>
<li>sp_albumbrowse_review()
: <a class="el" href="group__albumbrowse.html#ga868f3f3263f5033ae1fba60f403be712">api.h</a>
</li>
<li>sp_albumbrowse_track()
: <a class="el" href="group__albumbrowse.html#gad3c8df4b75158bba2c06aaefa74c5aa1">api.h</a>
</li>
<li>sp_artist_add_ref()
: <a class="el" href="group__artist.html#gac70d7467f580aa497d1a5d610e06d273">api.h</a>
</li>
<li>sp_artist_is_loaded()
: <a class="el" href="group__artist.html#gafc98f5093184a7ac7ce608302b0971ea">api.h</a>
</li>
<li>sp_artist_name()
: <a class="el" href="group__artist.html#gad2895555bb48514986823733a7afe5e2">api.h</a>
</li>
<li>sp_artist_portrait()
: <a class="el" href="group__artist.html#ga87d366ac7479c717005c2c059d5f2be9">api.h</a>
</li>
<li>sp_artist_release()
: <a class="el" href="group__artist.html#ga7b0da8f7ce09454bd0821d06d52e2d12">api.h</a>
</li>
<li>sp_artistbrowse_add_ref()
: <a class="el" href="group__artistbrowse.html#ga69fc2e1d2d5e8d91a724486cbfd0c4dc">api.h</a>
</li>
<li>sp_artistbrowse_album()
: <a class="el" href="group__artistbrowse.html#ga5b36c9a34876beea8fda8674b93d4fd3">api.h</a>
</li>
<li>sp_artistbrowse_artist()
: <a class="el" href="group__artistbrowse.html#ga5f6a046b2bd261d7628582b986a9019f">api.h</a>
</li>
<li>sp_artistbrowse_backend_request_duration()
: <a class="el" href="group__artistbrowse.html#gadce357748b82abce8a7b093882850fdb">api.h</a>
</li>
<li>sp_artistbrowse_biography()
: <a class="el" href="group__artistbrowse.html#ga8b93b9e5630662855f35694280ba4d2b">api.h</a>
</li>
<li>sp_artistbrowse_create()
: <a class="el" href="group__artistbrowse.html#ga8dd8364b2fcd29c846209660bd9a69b2">api.h</a>
</li>
<li>sp_artistbrowse_error()
: <a class="el" href="group__artistbrowse.html#ga203e757088ff7a5098f16a1367da25d2">api.h</a>
</li>
<li>sp_artistbrowse_is_loaded()
: <a class="el" href="group__artistbrowse.html#ga966b0f59e7b2b3d0037e44bb49dcdabc">api.h</a>
</li>
<li>sp_artistbrowse_num_albums()
: <a class="el" href="group__artistbrowse.html#gaf0055361abd53425d89a4636a32b5c83">api.h</a>
</li>
<li>sp_artistbrowse_num_portraits()
: <a class="el" href="group__artistbrowse.html#ga98dc47d36d2789999bfe62707c5041d7">api.h</a>
</li>
<li>sp_artistbrowse_num_similar_artists()
: <a class="el" href="group__artistbrowse.html#ga2559638742416ac621af0e919e017d17">api.h</a>
</li>
<li>sp_artistbrowse_num_tophit_tracks()
: <a class="el" href="group__artistbrowse.html#ga0c26782796af954300ce92fddea97637">api.h</a>
</li>
<li>sp_artistbrowse_num_tracks()
: <a class="el" href="group__artistbrowse.html#ga8c862caa2234125ffcc4e93287b1e029">api.h</a>
</li>
<li>sp_artistbrowse_portrait()
: <a class="el" href="group__artistbrowse.html#ga5f164b2f9609a7bf2c89b3a1407ec239">api.h</a>
</li>
<li>sp_artistbrowse_release()
: <a class="el" href="group__artistbrowse.html#ga14626a4f6a60b1caf61cb54c26783671">api.h</a>
</li>
<li>sp_artistbrowse_similar_artist()
: <a class="el" href="group__artistbrowse.html#gac60ef4f9e006a920f1d72b6098743fbc">api.h</a>
</li>
<li>sp_artistbrowse_tophit_track()
: <a class="el" href="group__artistbrowse.html#ga5da55f43def03fe9f0d2c8b252b9755a">api.h</a>
</li>
<li>sp_artistbrowse_track()
: <a class="el" href="group__artistbrowse.html#ga45d28771a856f935dc40ab40e27dec4c">api.h</a>
</li>
<li>sp_build_id()
: <a class="el" href="api_8h.html#a181d0940997cb8b69869449cd826cf88">api.h</a>
</li>
<li>sp_error_message()
: <a class="el" href="group__error.html#ga983dee341d3c2008830513b7cffe7bf3">api.h</a>
</li>
<li>sp_image_add_load_callback()
: <a class="el" href="group__image.html#gaa414f26ad1b9095645a83361597c92ce">api.h</a>
</li>
<li>sp_image_add_ref()
: <a class="el" href="group__image.html#ga98c93dbedfb182243742131a5224b83b">api.h</a>
</li>
<li>sp_image_create()
: <a class="el" href="group__image.html#gaf29e89f45945db2b3667bf9db4279c33">api.h</a>
</li>
<li>sp_image_create_from_link()
: <a class="el" href="group__image.html#ga70fb25cd2b0caaf15f637f36e75524b9">api.h</a>
</li>
<li>sp_image_data()
: <a class="el" href="group__image.html#ga03700a7dfa90bfc8200b89f15acd91aa">api.h</a>
</li>
<li>sp_image_error()
: <a class="el" href="group__image.html#gae40103df87426b346e0d0413d8d3b0ff">api.h</a>
</li>
<li>sp_image_format()
: <a class="el" href="group__image.html#ga04448e81ca4916ba7ed223d0d817e803">api.h</a>
</li>
<li>sp_image_image_id()
: <a class="el" href="group__image.html#ga0ee0b98cc25c995fe208a992cc87d145">api.h</a>
</li>
<li>sp_image_is_loaded()
: <a class="el" href="group__image.html#ga45312b1b9b5e5565485d61a8f0300e18">api.h</a>
</li>
<li>sp_image_release()
: <a class="el" href="group__image.html#ga3df9af5f68b18df5a598b7510e9b587f">api.h</a>
</li>
<li>sp_image_remove_load_callback()
: <a class="el" href="group__image.html#gaaee68c65d9eab3499f2b6be5d048d6ba">api.h</a>
</li>
<li>sp_inbox_add_ref()
: <a class="el" href="group__inbox.html#gadb6b607bc26b9d362de4da09ec1c864f">api.h</a>
</li>
<li>sp_inbox_error()
: <a class="el" href="group__inbox.html#gaa452e9fe1fa7c9e2c780d28ce2ed63c5">api.h</a>
</li>
<li>sp_inbox_post_tracks()
: <a class="el" href="group__inbox.html#gaee29e747ca10b36597d91689ae074aa2">api.h</a>
</li>
<li>sp_inbox_release()
: <a class="el" href="group__inbox.html#ga73659a65af92d30e4ac1cf3e06e74a0a">api.h</a>
</li>
<li>sp_link_add_ref()
: <a class="el" href="group__link.html#gac5a808b15bceed41508bd3863c8f4b3b">api.h</a>
</li>
<li>sp_link_as_album()
: <a class="el" href="group__link.html#gaafa98628d0abadcca27dd3b227c7337b">api.h</a>
</li>
<li>sp_link_as_artist()
: <a class="el" href="group__link.html#gab32979d26dcf68936202fa7aed7b6e49">api.h</a>
</li>
<li>sp_link_as_string()
: <a class="el" href="group__link.html#ga9f169be53f098adcf12f7a10b8bd3ef7">api.h</a>
</li>
<li>sp_link_as_track()
: <a class="el" href="group__link.html#ga2560687997d7ce0fbf4f05251d87d32a">api.h</a>
</li>
<li>sp_link_as_track_and_offset()
: <a class="el" href="group__link.html#ga80f6f752832f76c268c0bfd3ca45e6d2">api.h</a>
</li>
<li>sp_link_as_user()
: <a class="el" href="group__link.html#ga3e29975f47fc0a51be813b4774a3d6f3">api.h</a>
</li>
<li>sp_link_create_from_album()
: <a class="el" href="group__link.html#ga040627b0df84425947c82cd8890122ad">api.h</a>
</li>
<li>sp_link_create_from_album_cover()
: <a class="el" href="group__link.html#gaa87e346c29f1077d7a62c364719d4a55">api.h</a>
</li>
<li>sp_link_create_from_artist()
: <a class="el" href="group__link.html#ga3196ce9de3da4f1d5944a0b58bd80540">api.h</a>
</li>
<li>sp_link_create_from_artist_portrait()
: <a class="el" href="group__link.html#gaafb25ee14bfb27f9cbbab1b039d4d225">api.h</a>
</li>
<li>sp_link_create_from_artistbrowse_portrait()
: <a class="el" href="group__link.html#ga32218fbd912ddddbb749cb42a72b6bcd">api.h</a>
</li>
<li>sp_link_create_from_image()
: <a class="el" href="group__link.html#gaa85fbea312127db44685b7e9dc492042">api.h</a>
</li>
<li>sp_link_create_from_playlist()
: <a class="el" href="group__link.html#ga805392bfa8e526eebedc1cf5a7bcae0f">api.h</a>
</li>
<li>sp_link_create_from_search()
: <a class="el" href="group__link.html#ga95c97ba4de9c4040047276ad618a108e">api.h</a>
</li>
<li>sp_link_create_from_string()
: <a class="el" href="group__link.html#gaea9c39f35f7986fc9fed4584fa211127">api.h</a>
</li>
<li>sp_link_create_from_track()
: <a class="el" href="group__link.html#ga82c29419ce70e2b504670e3d45167d5d">api.h</a>
</li>
<li>sp_link_create_from_user()
: <a class="el" href="group__link.html#gaaa78b1750179c17f8152408cea43efef">api.h</a>
</li>
<li>sp_link_release()
: <a class="el" href="group__link.html#ga2b06ab16d1f6436cd8d36dbff2b5c022">api.h</a>
</li>
<li>sp_link_type()
: <a class="el" href="group__link.html#ga6140f924c696d53469bb8930cd53e1e6">api.h</a>
</li>
<li>sp_localtrack_create()
: <a class="el" href="group__track.html#ga0fb814ef23636fdecda64e3a63b15a23">api.h</a>
</li>
<li>sp_offline_num_playlists()
: <a class="el" href="group__session.html#gad6cee58fa44453b7a4fd2ae2266df055">api.h</a>
</li>
<li>sp_offline_sync_get_status()
: <a class="el" href="group__session.html#ga02525cd659a34728047cd3801049e822">api.h</a>
</li>
<li>sp_offline_time_left()
: <a class="el" href="group__session.html#gac36816dc42825db9a5a2fbd2694f20af">api.h</a>
</li>
<li>sp_offline_tracks_to_sync()
: <a class="el" href="group__session.html#gaf535124b4208c279cb98a061834e6411">api.h</a>
</li>
<li>sp_playlist_add_callbacks()
: <a class="el" href="group__playlist.html#gab15fca12d387c69b4998a4d2b48e5b32">api.h</a>
</li>
<li>sp_playlist_add_ref()
: <a class="el" href="group__playlist.html#gacb10979add5a954e5c1600ef9c5b17a8">api.h</a>
</li>
<li>sp_playlist_add_tracks()
: <a class="el" href="group__playlist.html#ga2344a47133f7f0aed0a67e154ecc4dc4">api.h</a>
</li>
<li>sp_playlist_create()
: <a class="el" href="group__playlist.html#ga342a6a0cfe10531ef7cb3c6629c1e8e7">api.h</a>
</li>
<li>sp_playlist_get_description()
: <a class="el" href="group__playlist.html#gab1d8e0ee9b436ecbb104bbd6cc0665be">api.h</a>
</li>
<li>sp_playlist_get_image()
: <a class="el" href="group__playlist.html#ga409cb6b2a88db7242ec939b6644e8c30">api.h</a>
</li>
<li>sp_playlist_get_offline_download_completed()
: <a class="el" href="group__playlist.html#ga83ca1a25f50834f8e6f8ee1e883a8c6e">api.h</a>
</li>
<li>sp_playlist_get_offline_status()
: <a class="el" href="group__playlist.html#ga7170157af21445c37a21a2241f91ff06">api.h</a>
</li>
<li>sp_playlist_has_pending_changes()
: <a class="el" href="group__playlist.html#gaf0e39b5969259d10625eb398af0f3f43">api.h</a>
</li>
<li>sp_playlist_is_collaborative()
: <a class="el" href="group__playlist.html#ga8ad160f654f02f13690568070dd57353">api.h</a>
</li>
<li>sp_playlist_is_in_ram()
: <a class="el" href="group__playlist.html#ga28456d1242693c6d890516dc782ab3ec">api.h</a>
</li>
<li>sp_playlist_is_loaded()
: <a class="el" href="group__playlist.html#gaee8ea6c07dfdca3397e27b278fa4870a">api.h</a>
</li>
<li>sp_playlist_name()
: <a class="el" href="group__playlist.html#ga61b7e33cc1aedb4e31a2af75ae0ac8cc">api.h</a>
</li>
<li>sp_playlist_num_subscribers()
: <a class="el" href="group__playlist.html#ga967ad87f0db702513ecda82546f667c5">api.h</a>
</li>
<li>sp_playlist_num_tracks()
: <a class="el" href="group__playlist.html#ga684a3acc60f99b3b26488ed813ee5d23">api.h</a>
</li>
<li>sp_playlist_owner()
: <a class="el" href="group__playlist.html#gac3e4295d3353eb9998402aedfdbd55de">api.h</a>
</li>
<li>sp_playlist_release()
: <a class="el" href="group__playlist.html#gacb9250eb530869b039541a8b62dfab6c">api.h</a>
</li>
<li>sp_playlist_remove_callbacks()
: <a class="el" href="group__playlist.html#ga7fcbf909a0fa8bf25f0b1d1e7dd0e160">api.h</a>
</li>
<li>sp_playlist_remove_tracks()
: <a class="el" href="group__playlist.html#gabd62cd7ff9484b4c31ff7f159ec41b6a">api.h</a>
</li>
<li>sp_playlist_rename()
: <a class="el" href="group__playlist.html#gad6c3880c514353e204fdd90830b516ec">api.h</a>
</li>
<li>sp_playlist_reorder_tracks()
: <a class="el" href="group__playlist.html#ga90ffd8c9fc6abc7375e89f4cb49adb11">api.h</a>
</li>
<li>sp_playlist_set_autolink_tracks()
: <a class="el" href="group__playlist.html#ga0bde47f340e0cd590a78007c6af69307">api.h</a>
</li>
<li>sp_playlist_set_collaborative()
: <a class="el" href="group__playlist.html#gad15410bcc2ebd986adabda865830bce4">api.h</a>
</li>
<li>sp_playlist_set_in_ram()
: <a class="el" href="group__playlist.html#gaf6ca8a349bdd982f6c8dda52ed691017">api.h</a>
</li>
<li>sp_playlist_set_offline_mode()
: <a class="el" href="group__playlist.html#ga784f648f9cc431ef3b51f3491c2f169f">api.h</a>
</li>
<li>sp_playlist_subscribers()
: <a class="el" href="group__playlist.html#gad49f491babc475f8d4aeea1b4452ff8b">api.h</a>
</li>
<li>sp_playlist_subscribers_free()
: <a class="el" href="group__playlist.html#gae7754b74b1c3c8f5222ca43b6608ce6a">api.h</a>
</li>
<li>sp_playlist_track()
: <a class="el" href="group__playlist.html#ga7a03854fe6072476306780d23c6cac16">api.h</a>
</li>
<li>sp_playlist_track_create_time()
: <a class="el" href="group__playlist.html#gab8e77f8d63e787f8aa1a066d74daa74c">api.h</a>
</li>
<li>sp_playlist_track_creator()
: <a class="el" href="group__playlist.html#ga80fcd9e7b40c791433c07d66e2ad432a">api.h</a>
</li>
<li>sp_playlist_track_message()
: <a class="el" href="group__playlist.html#ga6887b9dabb30a060b10bdb75f8b3f971">api.h</a>
</li>
<li>sp_playlist_track_seen()
: <a class="el" href="group__playlist.html#gab9e00ee5bc6b5dc0b3d58cbdb32c0c7b">api.h</a>
</li>
<li>sp_playlist_track_set_seen()
: <a class="el" href="group__playlist.html#ga69f5cc1bdd7dbdcdb476a7b1d2b7834d">api.h</a>
</li>
<li>sp_playlist_update_subscribers()
: <a class="el" href="group__playlist.html#ga9ebbf147230b3ca98b68e556cf24e6bd">api.h</a>
</li>
<li>sp_playlistcontainer_add_callbacks()
: <a class="el" href="group__playlist.html#ga1976cb49c391cdd2dbe7c40d1bc71570">api.h</a>
</li>
<li>sp_playlistcontainer_add_folder()
: <a class="el" href="group__playlist.html#ga0862502eea52fc5f2465ebad6fd98796">api.h</a>
</li>
<li>sp_playlistcontainer_add_new_playlist()
: <a class="el" href="group__playlist.html#ga840b82b1074a7ca1c9eacd351bed24c2">api.h</a>
</li>
<li>sp_playlistcontainer_add_playlist()
: <a class="el" href="group__playlist.html#ga87699479087915b741ceef4eebe69ad8">api.h</a>
</li>
<li>sp_playlistcontainer_add_ref()
: <a class="el" href="group__playlist.html#ga2138c537a6ebcd35a01eea54d0dd1e8f">api.h</a>
</li>
<li>sp_playlistcontainer_clear_unseen_tracks()
: <a class="el" href="group__playlist.html#gadaad604c35e543363e1dd5b23c462db0">api.h</a>
</li>
<li>sp_playlistcontainer_get_unseen_tracks()
: <a class="el" href="group__playlist.html#gad9e11b45843ee4a147b43038a2e55f13">api.h</a>
</li>
<li>sp_playlistcontainer_is_loaded()
: <a class="el" href="group__playlist.html#gae23cb67b4b26bca663034997c4418fa8">api.h</a>
</li>
<li>sp_playlistcontainer_move_playlist()
: <a class="el" href="group__playlist.html#gad9be708159957d4c1e5ef905550808c5">api.h</a>
</li>
<li>sp_playlistcontainer_num_playlists()
: <a class="el" href="group__playlist.html#ga7a1cbf558b2b364b8249d4ce432df700">api.h</a>
</li>
<li>sp_playlistcontainer_owner()
: <a class="el" href="group__playlist.html#gad4fc67d1386dd637f778f4e735a36894">api.h</a>
</li>
<li>sp_playlistcontainer_playlist()
: <a class="el" href="group__playlist.html#ga5ddd8c8064c281a14c6fd7877f522dc6">api.h</a>
</li>
<li>sp_playlistcontainer_playlist_folder_id()
: <a class="el" href="group__playlist.html#ga6939f9db71199612fc5a19d395e3a7f8">api.h</a>
</li>
<li>sp_playlistcontainer_playlist_folder_name()
: <a class="el" href="group__playlist.html#ga852e5f5bcd4520be2e3d6d5d94def44a">api.h</a>
</li>
<li>sp_playlistcontainer_playlist_type()
: <a class="el" href="group__playlist.html#ga79286860a3eeada495e97c5ad1fd7ebf">api.h</a>
</li>
<li>sp_playlistcontainer_release()
: <a class="el" href="group__playlist.html#ga0311c7c3c4f26028e5edd4aacb36dbf8">api.h</a>
</li>
<li>sp_playlistcontainer_remove_callbacks()
: <a class="el" href="group__playlist.html#gafb5242b8f0f9964cec29d32f4d6c1164">api.h</a>
</li>
<li>sp_playlistcontainer_remove_playlist()
: <a class="el" href="group__playlist.html#ga1ae1d51c4305940ae5c5c98c12be0afc">api.h</a>
</li>
<li>sp_search_add_ref()
: <a class="el" href="group__search.html#ga92e45a5edb1e33e64fdb857bd8eb9ad5">api.h</a>
</li>
<li>sp_search_album()
: <a class="el" href="group__search.html#ga4ba7723e70db0c6a4569c4bcd44f0e98">api.h</a>
</li>
<li>sp_search_artist()
: <a class="el" href="group__search.html#ga79b3d532d5a20a3b2bf2a087eead7888">api.h</a>
</li>
<li>sp_search_create()
: <a class="el" href="group__search.html#ga2f64dfbcc1313e7d5179998cb28208d4">api.h</a>
</li>
<li>sp_search_did_you_mean()
: <a class="el" href="group__search.html#ga8561c1da8b93ecdc8f2d325a9d19199b">api.h</a>
</li>
<li>sp_search_error()
: <a class="el" href="group__search.html#ga7cf655e37a823f952d30270d4fb60f10">api.h</a>
</li>
<li>sp_search_is_loaded()
: <a class="el" href="group__search.html#ga70e8c404d8c7ce0bbef70c2b274417cd">api.h</a>
</li>
<li>sp_search_num_albums()
: <a class="el" href="group__search.html#ga0c456a6396c4c05fbc8677ea641ef1f7">api.h</a>
</li>
<li>sp_search_num_artists()
: <a class="el" href="group__search.html#gabd375a613c2dadecad8c13f8aca6f2d3">api.h</a>
</li>
<li>sp_search_num_playlists()
: <a class="el" href="group__search.html#gaa9f007f439d8241bf632f9abb8d926c9">api.h</a>
</li>
<li>sp_search_num_tracks()
: <a class="el" href="group__search.html#ga1dd18cf7b3b3b7f4bf6e92a2140378d0">api.h</a>
</li>
<li>sp_search_playlist()
: <a class="el" href="group__search.html#ga4175fba17f355b1c0bd361357181ea35">api.h</a>
</li>
<li>sp_search_playlist_image_uri()
: <a class="el" href="group__search.html#gac4463fab4ea25e0a5d5079c959a1781c">api.h</a>
</li>
<li>sp_search_playlist_name()
: <a class="el" href="group__search.html#ga933cd5d5a0ccca9906082ca4549a4ed7">api.h</a>
</li>
<li>sp_search_playlist_uri()
: <a class="el" href="group__search.html#ga0071a3d30f0f0c4e477bf923e9014ff5">api.h</a>
</li>
<li>sp_search_query()
: <a class="el" href="group__search.html#ga127e9c2bf98e3602ecfc2926b9d242bf">api.h</a>
</li>
<li>sp_search_release()
: <a class="el" href="group__search.html#ga4e01d43067d9f8c533c985f90143821b">api.h</a>
</li>
<li>sp_search_total_albums()
: <a class="el" href="group__search.html#gaafd3b228adbc028937383d0d45730581">api.h</a>
</li>
<li>sp_search_total_artists()
: <a class="el" href="group__search.html#ga305a4118625e0f70cfb14161a0112fd5">api.h</a>
</li>
<li>sp_search_total_playlists()
: <a class="el" href="group__search.html#ga2e286415a6ba8dbf85ea677906f2798c">api.h</a>
</li>
<li>sp_search_total_tracks()
: <a class="el" href="group__search.html#gab4e50582c517b4639fd1afd6fb011587">api.h</a>
</li>
<li>sp_search_track()
: <a class="el" href="group__search.html#gae9da7ca59ce0bbd73f7bcef4e15c4da8">api.h</a>
</li>
<li>sp_session_connectionstate()
: <a class="el" href="group__session.html#ga34a7c9527705ab7d23b742006d81ea35">api.h</a>
</li>
<li>sp_session_create()
: <a class="el" href="group__session.html#gaf2891f2daced4ff6da84219d6376b3aa">api.h</a>
</li>
<li>sp_session_flush_caches()
: <a class="el" href="group__session.html#ga34005bb06ee3de8ee4221597a0335cca">api.h</a>
</li>
<li>sp_session_forget_me()
: <a class="el" href="group__session.html#ga61e6b796d9e07682c018e888b901a191">api.h</a>
</li>
<li>sp_session_get_volume_normalization()
: <a class="el" href="group__session.html#ga7913df06394360f255c77fb87af0f1fe">api.h</a>
</li>
<li>sp_session_inbox_create()
: <a class="el" href="group__session.html#gac72ccb51031c846101134b73195bb9ec">api.h</a>
</li>
<li>sp_session_is_private_session()
: <a class="el" href="group__session.html#ga72702ee06bc96c074804388d24344149">api.h</a>
</li>
<li>sp_session_is_scrobbling()
: <a class="el" href="group__session.html#ga6a56bc82ff0b369bb6e0f035534ce33d">api.h</a>
</li>
<li>sp_session_is_scrobbling_possible()
: <a class="el" href="group__session.html#ga0fad03ceabcf8d68af78f0f35fcbcc8d">api.h</a>
</li>
<li>sp_session_login()
: <a class="el" href="group__session.html#ga4533a992a120cacb109c892a852afe2a">api.h</a>
</li>
<li>sp_session_logout()
: <a class="el" href="group__session.html#gab7f08ca0939985b30ae2d1ed9db1d726">api.h</a>
</li>
<li>sp_session_player_load()
: <a class="el" href="group__session.html#gac73bf2c569a43d824439b557d5e4b293">api.h</a>
</li>
<li>sp_session_player_play()
: <a class="el" href="group__session.html#gab66c5915967e4f90db945b118e620624">api.h</a>
</li>
<li>sp_session_player_prefetch()
: <a class="el" href="group__session.html#gaf42e30a1f430ac7c436c7d9f0485368d">api.h</a>
</li>
<li>sp_session_player_seek()
: <a class="el" href="group__session.html#ga3430cd4f11541868d3f83eaa31aecf44">api.h</a>
</li>
<li>sp_session_player_unload()
: <a class="el" href="group__session.html#gafa7ee2803f119451bb8be3bf28746975">api.h</a>
</li>
<li>sp_session_playlistcontainer()
: <a class="el" href="group__session.html#ga319767f0b795f1c46a08390b587c5671">api.h</a>
</li>
<li>sp_session_preferred_bitrate()
: <a class="el" href="group__session.html#gacd590e095b011af42fb10046117846fe">api.h</a>
</li>
<li>sp_session_preferred_offline_bitrate()
: <a class="el" href="group__session.html#ga4bba5f828d6c87692f2c355cc8f07c61">api.h</a>
</li>
<li>sp_session_process_events()
: <a class="el" href="group__session.html#gaff27cb730db6debf55e750e39e7fadd7">api.h</a>
</li>
<li>sp_session_publishedcontainer_for_user_create()
: <a class="el" href="group__session.html#ga4ad3a1de596a41f275120dad3bb4685d">api.h</a>
</li>
<li>sp_session_release()
: <a class="el" href="group__session.html#gab81c540b76f7425a9cc0dbf270c09674">api.h</a>
</li>
<li>sp_session_relogin()
: <a class="el" href="group__session.html#gae1bc9bebd230226c3d48925cd1be6edf">api.h</a>
</li>
<li>sp_session_remembered_user()
: <a class="el" href="group__session.html#gab349c7bfe59e10e167bd75c20df9fc97">api.h</a>
</li>
<li>sp_session_set_cache_size()
: <a class="el" href="group__session.html#ga6f27c55d1ce9f3f794fcce7bee7adfea">api.h</a>
</li>
<li>sp_session_set_connection_rules()
: <a class="el" href="group__session.html#ga0ac85299c37710321b6d64713e1d6ba8">api.h</a>
</li>
<li>sp_session_set_connection_type()
: <a class="el" href="group__session.html#gaf81c61799e0ccdbba048fb79ec050930">api.h</a>
</li>
<li>sp_session_set_private_session()
: <a class="el" href="group__session.html#ga42a8f0999316ac7f141926092879ad2f">api.h</a>
</li>
<li>sp_session_set_scrobbling()
: <a class="el" href="group__session.html#ga2475a1fbc2eeacccb96b7f36efd36725">api.h</a>
</li>
<li>sp_session_set_social_credentials()
: <a class="el" href="group__session.html#ga9e5ee46ef5e75aa462607caac984f2de">api.h</a>
</li>
<li>sp_session_set_volume_normalization()
: <a class="el" href="group__session.html#ga4e14f58356d00e3693be84623bf6bd11">api.h</a>
</li>
<li>sp_session_starred_create()
: <a class="el" href="group__session.html#ga02391c9e28cff0a602f7139542e0238f">api.h</a>
</li>
<li>sp_session_starred_for_user_create()
: <a class="el" href="group__session.html#ga9be806a719a6399bfe1fd0d4c125e0eb">api.h</a>
</li>
<li>sp_session_user()
: <a class="el" href="group__session.html#ga267bbcae24b6bb1fd56de56678a5f455">api.h</a>
</li>
<li>sp_session_user_country()
: <a class="el" href="group__session.html#ga54c7693afa9be664f3ea870feb0df8d9">api.h</a>
</li>
<li>sp_session_user_name()
: <a class="el" href="group__session.html#gac7a365c2166738909cdb901edebc3f70">api.h</a>
</li>
<li>sp_session_userdata()
: <a class="el" href="group__session.html#gabfb3f59b20ae0b225e154eb9095152b2">api.h</a>
</li>
<li>sp_toplistbrowse_add_ref()
: <a class="el" href="group__toplist.html#ga421a19f128e5f3ae4b36e63a133a2a83">api.h</a>
</li>
<li>sp_toplistbrowse_album()
: <a class="el" href="group__toplist.html#gaa080ace445d269f56942ac3d7f1f157e">api.h</a>
</li>
<li>sp_toplistbrowse_artist()
: <a class="el" href="group__toplist.html#ga504cc45074d40c817dffbcc2906ef57f">api.h</a>
</li>
<li>sp_toplistbrowse_backend_request_duration()
: <a class="el" href="group__toplist.html#gab9cf87d6b6a8cbd8d36cd6e94a3270ee">api.h</a>
</li>
<li>sp_toplistbrowse_create()
: <a class="el" href="group__toplist.html#gac2fe366e0050747438e09cdd22ed0e31">api.h</a>
</li>
<li>sp_toplistbrowse_error()
: <a class="el" href="group__toplist.html#ga9b881929e74d97f64814ae54953ce4d7">api.h</a>
</li>
<li>sp_toplistbrowse_is_loaded()
: <a class="el" href="group__toplist.html#gaff81156c09d311c4f6a82d28a32d7968">api.h</a>
</li>
<li>sp_toplistbrowse_num_albums()
: <a class="el" href="group__toplist.html#ga69f5e70269c1eb08e1ddb1c77bb8c3e3">api.h</a>
</li>
<li>sp_toplistbrowse_num_artists()
: <a class="el" href="group__toplist.html#gae2f5c09fbbf947834b1b1e73461f1fb3">api.h</a>
</li>
<li>sp_toplistbrowse_num_tracks()
: <a class="el" href="group__toplist.html#gaeb0ddfd565474dc7e444aabebbc119b7">api.h</a>
</li>
<li>sp_toplistbrowse_release()
: <a class="el" href="group__toplist.html#gac6cf969c9cb6b431aeaa4723820ca8de">api.h</a>
</li>
<li>sp_toplistbrowse_track()
: <a class="el" href="group__toplist.html#gaf3d00b8bf089134a4f320a8d3d6ab683">api.h</a>
</li>
<li>sp_track_add_ref()
: <a class="el" href="group__track.html#ga7d86041a2bf75590f55978521c08e38c">api.h</a>
</li>
<li>sp_track_album()
: <a class="el" href="group__track.html#ga39a0f52244472cb2d450ea9ba6807304">api.h</a>
</li>
<li>sp_track_artist()
: <a class="el" href="group__track.html#ga67cd0c035627a1e4a54642213fdf1d75">api.h</a>
</li>
<li>sp_track_disc()
: <a class="el" href="group__track.html#ga9d464ee4a5c8836b59888952b960223a">api.h</a>
</li>
<li>sp_track_duration()
: <a class="el" href="group__track.html#gac817937bd8d8355b6a1949b76d0b5560">api.h</a>
</li>
<li>sp_track_error()
: <a class="el" href="group__track.html#ga947c0f7755b0c4955ca0b0993db0f2b5">api.h</a>
</li>
<li>sp_track_get_availability()
: <a class="el" href="group__track.html#ga9c78846badae6567fe9f9a3792fd06c8">api.h</a>
</li>
<li>sp_track_get_playable()
: <a class="el" href="group__track.html#ga112dca47d0bac39818b55119ef134ffd">api.h</a>
</li>
<li>sp_track_index()
: <a class="el" href="group__track.html#ga25c1df9d32fd58f243397740b29c3f61">api.h</a>
</li>
<li>sp_track_is_autolinked()
: <a class="el" href="group__track.html#ga4eeb86de13187697cd9dfe0b0934988d">api.h</a>
</li>
<li>sp_track_is_loaded()
: <a class="el" href="group__track.html#ga8b69cf193679c7e00031ae43e61c6a54">api.h</a>
</li>
<li>sp_track_is_local()
: <a class="el" href="group__track.html#gabcb75da69e0338006bdbd2f2f467f082">api.h</a>
</li>
<li>sp_track_is_placeholder()
: <a class="el" href="group__track.html#ga2367d906c578e674d0d470d8c1ee3b33">api.h</a>
</li>
<li>sp_track_is_starred()
: <a class="el" href="group__track.html#gab17d380ac941e102af0f308ad885b3c3">api.h</a>
</li>
<li>sp_track_name()
: <a class="el" href="group__track.html#ga8eb423d3cc2cbfb743c7f23ffb8d0fad">api.h</a>
</li>
<li>sp_track_num_artists()
: <a class="el" href="group__track.html#ga0aa945fc43e35d36cc334a52735d83b2">api.h</a>
</li>
<li>sp_track_offline_get_status()
: <a class="el" href="group__track.html#ga281e0ad4373579c5d24202ea1f93fe7b">api.h</a>
</li>
<li>sp_track_popularity()
: <a class="el" href="group__track.html#ga4570f08f968edbff519b44d2241d2255">api.h</a>
</li>
<li>sp_track_release()
: <a class="el" href="group__track.html#gaa11098d82e6c2ae42fc2ea1486e741de">api.h</a>
</li>
<li>sp_track_set_starred()
: <a class="el" href="group__track.html#ga34b5a712fb2c683402ff78df73e7545c">api.h</a>
</li>
<li>sp_user_add_ref()
: <a class="el" href="group__user.html#ga232816a3c8f42ef2663b8d99261f2dae">api.h</a>
</li>
<li>sp_user_canonical_name()
: <a class="el" href="group__user.html#gad9ac5456cd129c31d2c577ba14e88f8c">api.h</a>
</li>
<li>sp_user_display_name()
: <a class="el" href="group__user.html#ga0052befb81a93bb7106ca863de892610">api.h</a>
</li>
<li>sp_user_is_loaded()
: <a class="el" href="group__user.html#ga0996fb9814564e4ad39b8a500cb3de21">api.h</a>
</li>
<li>sp_user_release()
: <a class="el" href="group__user.html#gab1ffba4355073e1f72594c9e1b22ebb4">api.h</a>
</li>
</ul>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/globals_type.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Data Fields</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="files.html"><span>File&nbsp;List</span></a></li>
      <li class="current"><a href="globals.html"><span>Globals</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="globals.html"><span>All</span></a></li>
      <li><a href="globals_func.html"><span>Functions</span></a></li>
      <li class="current"><a href="globals_type.html"><span>Typedefs</span></a></li>
      <li><a href="globals_enum.html"><span>Enumerations</span></a></li>
      <li><a href="globals_eval.html"><span>Enumerator</span></a></li>
      <li><a href="globals_defs.html"><span>Defines</span></a></li>
    </ul>
  </div>
  <div class="tabs3">
    <ul class="tablist">
      <li><a href="#index_a"><span>a</span></a></li>
      <li><a href="#index_i"><span>i</span></a></li>
      <li><a href="#index_s"><span>s</span></a></li>
      <li><a href="#index_t"><span>t</span></a></li>
    </ul>
  </div>
</div>
<div class="contents">
&nbsp;

<h3><a class="anchor" id="index_a"></a>- a -</h3><ul>
<li>albumbrowse_complete_cb
: <a class="el" href="group__albumbrowse.html#gabd76254f89048e6d368929015a0c739f">api.h</a>
</li>
<li>artistbrowse_complete_cb
: <a class="el" href="group__artistbrowse.html#ga8077aa18c043210e859479be2616a3e7">api.h</a>
</li>
</ul>


<h3><a class="anchor" id="index_i"></a>- i -</h3><ul>
<li>image_loaded_cb
: <a class="el" href="group__image.html#ga713bef7c5dedba7d91b9710cd9b5faa4">api.h</a>
</li>
<li>inboxpost_complete_cb
: <a class="el" href="group__inbox.html#ga5084d6ab753294730402a0c43b82e60c">api.h</a>
</li>
</ul>


<h3><a class="anchor" id="index_s"></a>- s -</h3><ul>
<li>search_complete_cb
: <a class="el" href="group__search.html#gabcd51c99a318b9f36dfe2948d8209bb1">api.h</a>
</li>
<li>sp_album
: <a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">api.h</a>
</li>
<li>sp_albumbrowse
: <a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">api.h</a>
</li>
<li>sp_artist
: <a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">api.h</a>
</li>
<li>sp_artistbrowse
: <a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">api.h</a>
</li>
<li>sp_artistbrowse_type
: <a class="el" href="group__session.html#gab947eba77c176504c69cbb2f1de9830d">api.h</a>
</li>
<li>sp_audio_buffer_stats
: <a class="el" href="group__session.html#ga25462859a596a247ba5cc1853fc32cca">api.h</a>
</li>
<li>sp_audioformat
: <a class="el" href="group__session.html#ga5338d4a10576ba8d6ab11b70892d503c">api.h</a>
</li>
<li>sp_bitrate
: <a class="el" href="group__session.html#ga83d3de45241a44e787410993c5fac0ea">api.h</a>
</li>
<li>sp_connection_rules
: <a class="el" href="group__session.html#ga24ee483cdceef9af3b415c020b197a75">api.h</a>
</li>
<li>sp_connection_type
: <a class="el" href="group__session.html#ga05a7dbb946a9c47bf011f3f3d77964c3">api.h</a>
</li>
<li>sp_connectionstate
: <a class="el" href="group__session.html#gac0fa3d4cc60bd2e3d666026f88980e8c">api.h</a>
</li>
<li>sp_error
: <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">api.h</a>
</li>
<li>sp_image
: <a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">api.h</a>
</li>
<li>sp_image_size
: <a class="el" href="group__session.html#gaca320fd41bd0556b7fa1f2fa6e14faee">api.h</a>
</li>
<li>sp_inbox
: <a class="el" href="group__types.html#gaec0f2e5098cebc05ce56adfc9b346510">api.h</a>
</li>
<li>sp_link
: <a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">api.h</a>
</li>
<li>sp_offline_sync_status
: <a class="el" href="group__session.html#gaa7f24f13d6d105869c405045a4cc2a20">api.h</a>
</li>
<li>sp_playlist
: <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">api.h</a>
</li>
<li>sp_playlist_callbacks
: <a class="el" href="group__playlist.html#ga8249fe3d53c6dce0f154d0bfd3e80c6a">api.h</a>
</li>
<li>sp_playlist_offline_status
: <a class="el" href="group__session.html#gac507efa32e8c122fbe9ea41d96180d06">api.h</a>
</li>
<li>sp_playlist_type
: <a class="el" href="group__session.html#ga86723f553db2db6a8f507cd748948ad4">api.h</a>
</li>
<li>sp_playlistcontainer
: <a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">api.h</a>
</li>
<li>sp_playlistcontainer_callbacks
: <a class="el" href="group__playlist.html#ga8786e3840bb3774fc929183e3a9df281">api.h</a>
</li>
<li>sp_relation_type
: <a class="el" href="group__user.html#ga3a5dbf9aee629d8a9b43dfb24881a9b4">api.h</a>
</li>
<li>sp_sampletype
: <a class="el" href="group__session.html#ga5ef462e78d5a5af60dd0e7085b1ba512">api.h</a>
</li>
<li>sp_search
: <a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">api.h</a>
</li>
<li>sp_search_type
: <a class="el" href="group__session.html#ga647e4de81e5ac0a2e5d1193b1005ed3e">api.h</a>
</li>
<li>sp_session
: <a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">api.h</a>
</li>
<li>sp_session_callbacks
: <a class="el" href="group__session.html#gaf1d92302cd5d0d4a032e1408188c8fd5">api.h</a>
</li>
<li>sp_session_config
: <a class="el" href="group__session.html#ga372b25a93da38d4d707b0c2eaa7b3ebb">api.h</a>
</li>
<li>sp_subscribers
: <a class="el" href="group__session.html#gafb515e30d134c61b8eaaff3177af0b5b">api.h</a>
</li>
<li>sp_toplistbrowse
: <a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">api.h</a>
</li>
<li>sp_track
: <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">api.h</a>
</li>
<li>sp_track_availability
: <a class="el" href="group__session.html#ga60c7ff53ddbc04c036a23181b7275d69">api.h</a>
</li>
<li>sp_track_offline_status
: <a class="el" href="group__session.html#gae689044941537050de641a1dcd4c75d5">api.h</a>
</li>
<li>sp_user
: <a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">api.h</a>
</li>
</ul>


<h3><a class="anchor" id="index_t"></a>- t -</h3><ul>
<li>toplistbrowse_complete_cb
: <a class="el" href="group__toplist.html#gafe8e94ae23133105f35c03b9e3836a0a">api.h</a>
</li>
</ul>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/group__album.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Album subsystem</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#enum-members">Enumerations</a> &#124;
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<h1>Album subsystem</h1>  </div>
</div>
<div class="contents">
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="enum-members"></a>
Enumerations</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__album.html#ga019b49a9d1633b61daa79c80ea01d5c3">sp_albumtype</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__album.html#gga019b49a9d1633b61daa79c80ea01d5c3ad1693d93a2c05c053fc4fd77886af8dd">SP_ALBUMTYPE_ALBUM</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__album.html#gga019b49a9d1633b61daa79c80ea01d5c3a3b6f78b733f1bc18a5e4fa18c020fc73">SP_ALBUMTYPE_SINGLE</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__album.html#gga019b49a9d1633b61daa79c80ea01d5c3a8fee6ba46e8876037f4f2e46c6d6c6af">SP_ALBUMTYPE_COMPILATION</a> =  2, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__album.html#gga019b49a9d1633b61daa79c80ea01d5c3ad564ed5f1f0659929fe5ec700513873f">SP_ALBUMTYPE_UNKNOWN</a> =  3
<br/>
 }</td></tr>
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__album.html#ga46fbfa98be12c2f4067d5e679552cfb9">sp_album_is_loaded</a> (<a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__album.html#ga89eb8dc73a76f5e0509b1066426495f7">sp_album_is_available</a> (<a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__album.html#ga42309972141dab10c32d741d357c01de">sp_album_artist</a> (<a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const byte *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__album.html#ga6616ef3df724af185c5eb58e8a0fb808">sp_album_cover</a> (<a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album, <a class="el" href="group__session.html#ga61bc424465d776af3ceeb69eee2bb492">sp_image_size</a> size)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__album.html#ga0e828c991a8184d60026513f944e19ad">sp_album_name</a> (<a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__album.html#ga2aadf934b0af43c3ef6ee98b6a8065fd">sp_album_year</a> (<a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__album.html#ga019b49a9d1633b61daa79c80ea01d5c3">sp_albumtype</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__album.html#ga8dceb04a62bdb3ffc112ed0efc359e51">sp_album_type</a> (<a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__album.html#ga08192dd38d1c628f7b51615fffa33017">sp_album_add_ref</a> (<a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__album.html#ga5c6e49d04ffb05c722db5e78c9434b88">sp_album_release</a> (<a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album)</td></tr>
</table>
<hr/><h2>Enumeration Type Documentation</h2>
<a class="anchor" id="ga019b49a9d1633b61daa79c80ea01d5c3"></a><!-- doxytag: member="api.h::sp_albumtype" ref="ga019b49a9d1633b61daa79c80ea01d5c3" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="group__album.html#ga019b49a9d1633b61daa79c80ea01d5c3">sp_albumtype</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Album types </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="gga019b49a9d1633b61daa79c80ea01d5c3ad1693d93a2c05c053fc4fd77886af8dd"></a><!-- doxytag: member="SP_ALBUMTYPE_ALBUM" ref="gga019b49a9d1633b61daa79c80ea01d5c3ad1693d93a2c05c053fc4fd77886af8dd" args="" -->SP_ALBUMTYPE_ALBUM</em>&nbsp;</td><td>
<p>Normal album. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga019b49a9d1633b61daa79c80ea01d5c3a3b6f78b733f1bc18a5e4fa18c020fc73"></a><!-- doxytag: member="SP_ALBUMTYPE_SINGLE" ref="gga019b49a9d1633b61daa79c80ea01d5c3a3b6f78b733f1bc18a5e4fa18c020fc73" args="" -->SP_ALBUMTYPE_SINGLE</em>&nbsp;</td><td>
<p>Single. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga019b49a9d1633b61daa79c80ea01d5c3a8fee6ba46e8876037f4f2e46c6d6c6af"></a><!-- doxytag: member="SP_ALBUMTYPE_COMPILATION" ref="gga019b49a9d1633b61daa79c80ea01d5c3a8fee6ba46e8876037f4f2e46c6d6c6af" args="" -->SP_ALBUMTYPE_COMPILATION</em>&nbsp;</td><td>
<p>Compilation. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga019b49a9d1633b61daa79c80ea01d5c3ad564ed5f1f0659929fe5ec700513873f"></a><!-- doxytag: member="SP_ALBUMTYPE_UNKNOWN" ref="gga019b49a9d1633b61daa79c80ea01d5c3ad564ed5f1f0659929fe5ec700513873f" args="" -->SP_ALBUMTYPE_UNKNOWN</em>&nbsp;</td><td>
<p>Unknown type. </p>
</td></tr>
</table>
</dd>
</dl>

</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="ga08192dd38d1c628f7b51615fffa33017"></a><!-- doxytag: member="api.h::sp_album_add_ref" ref="ga08192dd38d1c628f7b51615fffa33017" args="(sp_album *album)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_album_add_ref </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td>
          <td class="paramname"> <em>album</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Increase the reference count of an album</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>album</em>&nbsp;</td><td>The album object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="ga42309972141dab10c32d741d357c01de"></a><!-- doxytag: member="api.h::sp_album_artist" ref="ga42309972141dab10c32d741d357c01de" args="(sp_album *album)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a>* sp_album_artist </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td>
          <td class="paramname"> <em>album</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Get the artist associated with the given album</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>album</em>&nbsp;</td><td>Album object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A reference to the artist. NULL if the metadata has not been loaded yet </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="toplist_8c-example.html#a2">toplist.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga6616ef3df724af185c5eb58e8a0fb808"></a><!-- doxytag: member="api.h::sp_album_cover" ref="ga6616ef3df724af185c5eb58e8a0fb808" args="(sp_album *album, sp_image_size size)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const byte* sp_album_cover </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td>
          <td class="paramname"> <em>album</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__session.html#ga61bc424465d776af3ceeb69eee2bb492">sp_image_size</a>&nbsp;</td>
          <td class="paramname"> <em>size</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return image ID representing the album's coverart.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>album</em>&nbsp;</td><td>Album object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>size</em>&nbsp;</td><td>The desired size of the image</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>ID byte sequence that can be passed to <a class="el" href="group__image.html#gaf29e89f45945db2b3667bf9db4279c33">sp_image_create()</a> If the album has no image or the metadata for the album is not loaded yet, this function returns NULL.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__image.html#gaf29e89f45945db2b3667bf9db4279c33">sp_image_create</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga89eb8dc73a76f5e0509b1066426495f7"></a><!-- doxytag: member="api.h::sp_album_is_available" ref="ga89eb8dc73a76f5e0509b1066426495f7" args="(sp_album *album)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_album_is_available </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td>
          <td class="paramname"> <em>album</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return true if the album is available in the current region.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>album</em>&nbsp;</td><td>The album</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>True if album is available for playback, otherwise false.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>The album must be loaded or this function will always return false. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__album.html#ga46fbfa98be12c2f4067d5e679552cfb9">sp_album_is_loaded()</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga46fbfa98be12c2f4067d5e679552cfb9"></a><!-- doxytag: member="api.h::sp_album_is_loaded" ref="ga46fbfa98be12c2f4067d5e679552cfb9" args="(sp_album *album)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_album_is_loaded </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td>
          <td class="paramname"> <em>album</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Check if the album object is populated with data</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>album</em>&nbsp;</td><td>Album object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>True if metadata is present, false if not </dd></dl>

</div>
</div>
<a class="anchor" id="ga0e828c991a8184d60026513f944e19ad"></a><!-- doxytag: member="api.h::sp_album_name" ref="ga0e828c991a8184d60026513f944e19ad" args="(sp_album *album)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* sp_album_name </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td>
          <td class="paramname"> <em>album</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return name of album</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>album</em>&nbsp;</td><td>Album object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Name of album. Returned string is valid as long as the album object stays allocated and no longer than the next call to <a class="el" href="group__session.html#gaff27cb730db6debf55e750e39e7fadd7">sp_session_process_events()</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a13">browse.c</a>, <a class="el" href="search_8c-example.html#a0">search.c</a>, and <a class="el" href="toplist_8c-example.html#a0">toplist.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga5c6e49d04ffb05c722db5e78c9434b88"></a><!-- doxytag: member="api.h::sp_album_release" ref="ga5c6e49d04ffb05c722db5e78c9434b88" args="(sp_album *album)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_album_release </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td>
          <td class="paramname"> <em>album</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Decrease the reference count of an album</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>album</em>&nbsp;</td><td>The album object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="ga8dceb04a62bdb3ffc112ed0efc359e51"></a><!-- doxytag: member="api.h::sp_album_type" ref="ga8dceb04a62bdb3ffc112ed0efc359e51" args="(sp_album *album)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__album.html#ga019b49a9d1633b61daa79c80ea01d5c3">sp_albumtype</a> sp_album_type </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td>
          <td class="paramname"> <em>album</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return type of specified album</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>album</em>&nbsp;</td><td>Album object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>sp_albumtype </dd></dl>

</div>
</div>
<a class="anchor" id="ga2aadf934b0af43c3ef6ee98b6a8065fd"></a><!-- doxytag: member="api.h::sp_album_year" ref="ga2aadf934b0af43c3ef6ee98b6a8065fd" args="(sp_album *album)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_album_year </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td>
          <td class="paramname"> <em>album</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return release year of specified album</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>album</em>&nbsp;</td><td>Album object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Release year </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a15">browse.c</a>, and <a class="el" href="search_8c-example.html#a1">search.c</a>.</dd>
</dl>
</div>
</div>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/group__albumbrowse.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Album browsing</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#typedef-members">Typedefs</a> &#124;
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<h1>Album browsing</h1>  </div>
</div>
<div class="contents">
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#gabd76254f89048e6d368929015a0c739f">albumbrowse_complete_cb</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *result, void *userdata)</td></tr>
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#gaf1bc3042e748efea5ca7ac159e5cbfbe">sp_albumbrowse_create</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album, <a class="el" href="group__albumbrowse.html#gabd76254f89048e6d368929015a0c739f">albumbrowse_complete_cb</a> *callback, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#gad618d2752eb55173ab373d1407971960">sp_albumbrowse_is_loaded</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#ga153417eee319e7711b66503f88fba88b">sp_albumbrowse_error</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#gaf0dadfc4edb48a3558b606e30e8bedfa">sp_albumbrowse_album</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#ga4f835537a65bcac9ec52cef1058a44bc">sp_albumbrowse_artist</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#gab53fa74ee1958dad5186be09e70ddc4a">sp_albumbrowse_num_copyrights</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#ga34b205daa2960e8d02a6e1accd80ab92">sp_albumbrowse_copyright</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#ga3fb91de745ca07d3801a57288f2d9da7">sp_albumbrowse_num_tracks</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#gad3c8df4b75158bba2c06aaefa74c5aa1">sp_albumbrowse_track</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#ga868f3f3263f5033ae1fba60f403be712">sp_albumbrowse_review</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#ga2f1e1049065e8c090c010f8e43061bd4">sp_albumbrowse_backend_request_duration</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#ga1afd6a10febf31a61cf356673cb34bef">sp_albumbrowse_add_ref</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__albumbrowse.html#gabdd5a4e3b2098166b67e35979f59613d">sp_albumbrowse_release</a> (<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *alb)</td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Browsing adds additional information to what an <a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad" title="An album handle.">sp_album</a> holds. It retrieves copyrights, reviews and tracks of the album. </p>
<hr/><h2>Typedef Documentation</h2>
<a class="anchor" id="gabd76254f89048e6d368929015a0c739f"></a><!-- doxytag: member="api.h::albumbrowse_complete_cb" ref="gabd76254f89048e6d368929015a0c739f" args="(sp_albumbrowse *result, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef void <a class="el" href="group__albumbrowse.html#gabd76254f89048e6d368929015a0c739f">albumbrowse_complete_cb</a>(<a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *result, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>The type of a callback used in <a class="el" href="group__albumbrowse.html#gaf1bc3042e748efea5ca7ac159e5cbfbe">sp_albumbrowse_create()</a></p>
<p>When the callback is called, the metadata of all tracks belonging to it will have been loaded, so <a class="el" href="group__track.html#ga8b69cf193679c7e00031ae43e61c6a54">sp_track_is_loaded()</a> will return non-zero. The <a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc" title="An artist handle.">sp_artist</a> of the album will also have been fully loaded.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>result</em>&nbsp;</td><td>The same pointer returned by <a class="el" href="group__albumbrowse.html#gaf1bc3042e748efea5ca7ac159e5cbfbe">sp_albumbrowse_create()</a> </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>The opaque pointer given to <a class="el" href="group__albumbrowse.html#gaf1bc3042e748efea5ca7ac159e5cbfbe">sp_albumbrowse_create()</a> </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="ga1afd6a10febf31a61cf356673cb34bef"></a><!-- doxytag: member="api.h::sp_albumbrowse_add_ref" ref="ga1afd6a10febf31a61cf356673cb34bef" args="(sp_albumbrowse *alb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_albumbrowse_add_ref </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>alb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Increase the reference count of an album browse result</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>alb</em>&nbsp;</td><td>The album browse result object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="gaf0dadfc4edb48a3558b606e30e8bedfa"></a><!-- doxytag: member="api.h::sp_albumbrowse_album" ref="gaf0dadfc4edb48a3558b606e30e8bedfa" args="(sp_albumbrowse *alb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a>* sp_albumbrowse_album </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>alb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Given an album browse object, return the pointer to its album object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>alb</em>&nbsp;</td><td>Album browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Album object </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a14">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga4f835537a65bcac9ec52cef1058a44bc"></a><!-- doxytag: member="api.h::sp_albumbrowse_artist" ref="ga4f835537a65bcac9ec52cef1058a44bc" args="(sp_albumbrowse *alb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a>* sp_albumbrowse_artist </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>alb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Given an album browse object, return the pointer to its artist object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>alb</em>&nbsp;</td><td>Album browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Artist object </dd></dl>

</div>
</div>
<a class="anchor" id="ga2f1e1049065e8c090c010f8e43061bd4"></a><!-- doxytag: member="api.h::sp_albumbrowse_backend_request_duration" ref="ga2f1e1049065e8c090c010f8e43061bd4" args="(sp_albumbrowse *alb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_albumbrowse_backend_request_duration </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>alb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the time (in ms) that was spent waiting for the Spotify backend to serve the request</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>alb</em>&nbsp;</td><td>Album browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>-1 if the request was served from the local cache If the result is not yet loaded the return value is undefined </dd></dl>

</div>
</div>
<a class="anchor" id="ga34b205daa2960e8d02a6e1accd80ab92"></a><!-- doxytag: member="api.h::sp_albumbrowse_copyright" ref="ga34b205daa2960e8d02a6e1accd80ab92" args="(sp_albumbrowse *alb, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* sp_albumbrowse_copyright </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>alb</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Given an album browse object, return one of its copyright strings</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>alb</em>&nbsp;</td><td>Album browse object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>The index for the copyright string. Should be in the interval [0, <a class="el" href="group__albumbrowse.html#gab53fa74ee1958dad5186be09e70ddc4a">sp_albumbrowse_num_copyrights()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Copyright string in UTF-8 format, or NULL if the index is invalid. Returned string is valid as long as the album object stays allocated and no longer than the next call to <a class="el" href="group__session.html#gaff27cb730db6debf55e750e39e7fadd7">sp_session_process_events()</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a17">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gaf1bc3042e748efea5ca7ac159e5cbfbe"></a><!-- doxytag: member="api.h::sp_albumbrowse_create" ref="gaf1bc3042e748efea5ca7ac159e5cbfbe" args="(sp_session *session, sp_album *album, albumbrowse_complete_cb *callback, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a>* sp_albumbrowse_create </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td>
          <td class="paramname"> <em>album</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__albumbrowse.html#gabd76254f89048e6d368929015a0c739f">albumbrowse_complete_cb</a> *&nbsp;</td>
          <td class="paramname"> <em>callback</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">void *&nbsp;</td>
          <td class="paramname"> <em>userdata</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Initiate a request for browsing an album</p>
<p>The user is responsible for freeing the returned album browse using <a class="el" href="group__albumbrowse.html#gabdd5a4e3b2098166b67e35979f59613d">sp_albumbrowse_release()</a>. This can be done in the callback.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>album</em>&nbsp;</td><td>Album to be browsed. The album metadata does not have to be loaded </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>callback</em>&nbsp;</td><td>Callback to be invoked when browsing has been completed. Pass NULL if you are not interested in this event. </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata passed to callback.</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Album browse object</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__albumbrowse.html#gabd76254f89048e6d368929015a0c739f">albumbrowse_complete_cb</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a48">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga153417eee319e7711b66503f88fba88b"></a><!-- doxytag: member="api.h::sp_albumbrowse_error" ref="ga153417eee319e7711b66503f88fba88b" args="(sp_albumbrowse *alb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_albumbrowse_error </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>alb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Check if browsing returned an error code.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>alb</em>&nbsp;</td><td>Album browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_IS_LOADING SP_ERROR_OTHER_PERMANENT SP_ERROR_OTHER_TRANSIENT </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a28">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gad618d2752eb55173ab373d1407971960"></a><!-- doxytag: member="api.h::sp_albumbrowse_is_loaded" ref="gad618d2752eb55173ab373d1407971960" args="(sp_albumbrowse *alb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_albumbrowse_is_loaded </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>alb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Check if an album browse request is completed</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>alb</em>&nbsp;</td><td>Album browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>True if browsing is completed, false if not </dd></dl>

</div>
</div>
<a class="anchor" id="gab53fa74ee1958dad5186be09e70ddc4a"></a><!-- doxytag: member="api.h::sp_albumbrowse_num_copyrights" ref="gab53fa74ee1958dad5186be09e70ddc4a" args="(sp_albumbrowse *alb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_albumbrowse_num_copyrights </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>alb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Given an album browse object, return number of copyright strings</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>alb</em>&nbsp;</td><td>Album browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of copyright strings available, 0 if unknown </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a16">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga3fb91de745ca07d3801a57288f2d9da7"></a><!-- doxytag: member="api.h::sp_albumbrowse_num_tracks" ref="ga3fb91de745ca07d3801a57288f2d9da7" args="(sp_albumbrowse *alb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_albumbrowse_num_tracks </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>alb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Given an album browse object, return number of tracks</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>alb</em>&nbsp;</td><td>Album browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of tracks on album </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a18">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gabdd5a4e3b2098166b67e35979f59613d"></a><!-- doxytag: member="api.h::sp_albumbrowse_release" ref="gabdd5a4e3b2098166b67e35979f59613d" args="(sp_albumbrowse *alb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_albumbrowse_release </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>alb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Decrease the reference count of an album browse result</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>alb</em>&nbsp;</td><td>The album browse result object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a31">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga868f3f3263f5033ae1fba60f403be712"></a><!-- doxytag: member="api.h::sp_albumbrowse_review" ref="ga868f3f3263f5033ae1fba60f403be712" args="(sp_albumbrowse *alb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* sp_albumbrowse_review </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>alb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Given an album browse object, return its review</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>alb</em>&nbsp;</td><td>Album browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Review string in UTF-8 format. Returned string is valid as long as the album object stays allocated and no longer than the next call to <a class="el" href="group__session.html#gaff27cb730db6debf55e750e39e7fadd7">sp_session_process_events()</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a19">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gad3c8df4b75158bba2c06aaefa74c5aa1"></a><!-- doxytag: member="api.h::sp_albumbrowse_track" ref="gad3c8df4b75158bba2c06aaefa74c5aa1" args="(sp_albumbrowse *alb, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a>* sp_albumbrowse_track </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>alb</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Given an album browse object, return a pointer to one of its tracks</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>alb</em>&nbsp;</td><td>Album browse object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>The index for the track. Should be in the interval [0, <a class="el" href="group__albumbrowse.html#ga3fb91de745ca07d3801a57288f2d9da7">sp_albumbrowse_num_tracks()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A track.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__track.html">Track subsystem</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a20">browse.c</a>.</dd>
</dl>
</div>
</div>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/group__artist.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Artist subsystem</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<h1>Artist subsystem</h1>  </div>
</div>
<div class="contents">
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artist.html#gad2895555bb48514986823733a7afe5e2">sp_artist_name</a> (<a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *artist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artist.html#gafc98f5093184a7ac7ce608302b0971ea">sp_artist_is_loaded</a> (<a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *artist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const byte *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artist.html#ga87d366ac7479c717005c2c059d5f2be9">sp_artist_portrait</a> (<a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *artist, <a class="el" href="group__session.html#ga61bc424465d776af3ceeb69eee2bb492">sp_image_size</a> size)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artist.html#gac70d7467f580aa497d1a5d610e06d273">sp_artist_add_ref</a> (<a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *artist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artist.html#ga7b0da8f7ce09454bd0821d06d52e2d12">sp_artist_release</a> (<a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *artist)</td></tr>
</table>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="gac70d7467f580aa497d1a5d610e06d273"></a><!-- doxytag: member="api.h::sp_artist_add_ref" ref="gac70d7467f580aa497d1a5d610e06d273" args="(sp_artist *artist)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_artist_add_ref </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td>
          <td class="paramname"> <em>artist</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Increase the reference count of a artist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>artist</em>&nbsp;</td><td>The artist object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="gafc98f5093184a7ac7ce608302b0971ea"></a><!-- doxytag: member="api.h::sp_artist_is_loaded" ref="gafc98f5093184a7ac7ce608302b0971ea" args="(sp_artist *artist)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_artist_is_loaded </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td>
          <td class="paramname"> <em>artist</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Check if the artist object is populated with data</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>artist</em>&nbsp;</td><td>An artist object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>True if metadata is present, false if not </dd></dl>

</div>
</div>
<a class="anchor" id="gad2895555bb48514986823733a7afe5e2"></a><!-- doxytag: member="api.h::sp_artist_name" ref="gad2895555bb48514986823733a7afe5e2" args="(sp_artist *artist)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* sp_artist_name </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td>
          <td class="paramname"> <em>artist</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return name of artist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>artist</em>&nbsp;</td><td>Artist object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Name of artist. Returned string is valid as long as the artist object stays allocated and no longer than the next call to <a class="el" href="group__session.html#gaff27cb730db6debf55e750e39e7fadd7">sp_session_process_events()</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a9">browse.c</a>, <a class="el" href="search_8c-example.html#a2">search.c</a>, and <a class="el" href="toplist_8c-example.html#a1">toplist.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga87d366ac7479c717005c2c059d5f2be9"></a><!-- doxytag: member="api.h::sp_artist_portrait" ref="ga87d366ac7479c717005c2c059d5f2be9" args="(sp_artist *artist, sp_image_size size)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const byte* sp_artist_portrait </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td>
          <td class="paramname"> <em>artist</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__session.html#ga61bc424465d776af3ceeb69eee2bb492">sp_image_size</a>&nbsp;</td>
          <td class="paramname"> <em>size</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return portrait for artist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>artist</em>&nbsp;</td><td>The artist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>size</em>&nbsp;</td><td>The desired size of the image</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>ID byte sequence that can be passed to <a class="el" href="group__image.html#gaf29e89f45945db2b3667bf9db4279c33">sp_image_create()</a> If the artist has no image or the metadata for the album is not loaded yet, this function returns NULL. </dd></dl>

</div>
</div>
<a class="anchor" id="ga7b0da8f7ce09454bd0821d06d52e2d12"></a><!-- doxytag: member="api.h::sp_artist_release" ref="ga7b0da8f7ce09454bd0821d06d52e2d12" args="(sp_artist *artist)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_artist_release </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td>
          <td class="paramname"> <em>artist</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Decrease the reference count of a artist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>artist</em>&nbsp;</td><td>The artist object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/group__artistbrowse.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Artist browsing</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#typedef-members">Typedefs</a> &#124;
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<h1>Artist browsing</h1>  </div>
</div>
<div class="contents">
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga8077aa18c043210e859479be2616a3e7">artistbrowse_complete_cb</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *result, void *userdata)</td></tr>
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga8dd8364b2fcd29c846209660bd9a69b2">sp_artistbrowse_create</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *artist, <a class="el" href="group__session.html#gac86504cc9e8cadbc30c8aa8dbf355034">sp_artistbrowse_type</a> type, <a class="el" href="group__artistbrowse.html#ga8077aa18c043210e859479be2616a3e7">artistbrowse_complete_cb</a> *callback, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga966b0f59e7b2b3d0037e44bb49dcdabc">sp_artistbrowse_is_loaded</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga203e757088ff7a5098f16a1367da25d2">sp_artistbrowse_error</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga5f6a046b2bd261d7628582b986a9019f">sp_artistbrowse_artist</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga98dc47d36d2789999bfe62707c5041d7">sp_artistbrowse_num_portraits</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const byte *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga5f164b2f9609a7bf2c89b3a1407ec239">sp_artistbrowse_portrait</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga8c862caa2234125ffcc4e93287b1e029">sp_artistbrowse_num_tracks</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga45d28771a856f935dc40ab40e27dec4c">sp_artistbrowse_track</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga0c26782796af954300ce92fddea97637">sp_artistbrowse_num_tophit_tracks</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga5da55f43def03fe9f0d2c8b252b9755a">sp_artistbrowse_tophit_track</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#gaf0055361abd53425d89a4636a32b5c83">sp_artistbrowse_num_albums</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga5b36c9a34876beea8fda8674b93d4fd3">sp_artistbrowse_album</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga2559638742416ac621af0e919e017d17">sp_artistbrowse_num_similar_artists</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#gac60ef4f9e006a920f1d72b6098743fbc">sp_artistbrowse_similar_artist</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga8b93b9e5630662855f35694280ba4d2b">sp_artistbrowse_biography</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#gadce357748b82abce8a7b093882850fdb">sp_artistbrowse_backend_request_duration</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga69fc2e1d2d5e8d91a724486cbfd0c4dc">sp_artistbrowse_add_ref</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__artistbrowse.html#ga14626a4f6a60b1caf61cb54c26783671">sp_artistbrowse_release</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb)</td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Artist browsing initiates the fetching of information for a certain artist.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>There is currently no built-in functionality available for getting the albums belonging to an artist. For now, just iterate over all tracks and note the album to build a list of all albums. This feature will be added in a future version of the library. </dd></dl>
<hr/><h2>Typedef Documentation</h2>
<a class="anchor" id="ga8077aa18c043210e859479be2616a3e7"></a><!-- doxytag: member="api.h::artistbrowse_complete_cb" ref="ga8077aa18c043210e859479be2616a3e7" args="(sp_artistbrowse *result, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef void <a class="el" href="group__artistbrowse.html#ga8077aa18c043210e859479be2616a3e7">artistbrowse_complete_cb</a>(<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *result, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>The type of a callback used in <a class="el" href="group__artistbrowse.html#ga8dd8364b2fcd29c846209660bd9a69b2">sp_artistbrowse_create()</a></p>
<p>When the callback is called, the metadata of all tracks belonging to it will have been loaded, so <a class="el" href="group__track.html#ga8b69cf193679c7e00031ae43e61c6a54">sp_track_is_loaded()</a> will return non-zero. The same goes for the similar artist data.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>result</em>&nbsp;</td><td>The same pointer returned by <a class="el" href="group__artistbrowse.html#ga8dd8364b2fcd29c846209660bd9a69b2">sp_artistbrowse_create()</a> </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>The opaque pointer given to <a class="el" href="group__artistbrowse.html#ga8dd8364b2fcd29c846209660bd9a69b2">sp_artistbrowse_create()</a> </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="ga69fc2e1d2d5e8d91a724486cbfd0c4dc"></a><!-- doxytag: member="api.h::sp_artistbrowse_add_ref" ref="ga69fc2e1d2d5e8d91a724486cbfd0c4dc" args="(sp_artistbrowse *arb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_artistbrowse_add_ref </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>arb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Increase the reference count of an artist browse result</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>arb</em>&nbsp;</td><td>The artist browse result object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="ga5b36c9a34876beea8fda8674b93d4fd3"></a><!-- doxytag: member="api.h::sp_artistbrowse_album" ref="ga5b36c9a34876beea8fda8674b93d4fd3" args="(sp_artistbrowse *arb, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a>* sp_artistbrowse_album </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>arb</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Given an artist browse object, return one of its albums</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>arb</em>&nbsp;</td><td>Album browse object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>The index for the album. Should be in the interval [0, <a class="el" href="group__artistbrowse.html#gaf0055361abd53425d89a4636a32b5c83">sp_artistbrowse_num_albums()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A album object, or NULL if the index is out of range.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__album.html">Album subsystem</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga5f6a046b2bd261d7628582b986a9019f"></a><!-- doxytag: member="api.h::sp_artistbrowse_artist" ref="ga5f6a046b2bd261d7628582b986a9019f" args="(sp_artistbrowse *arb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a>* sp_artistbrowse_artist </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>arb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Given an artist browse object, return a pointer to its artist object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>arb</em>&nbsp;</td><td>Artist browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Artist object </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a21">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gadce357748b82abce8a7b093882850fdb"></a><!-- doxytag: member="api.h::sp_artistbrowse_backend_request_duration" ref="gadce357748b82abce8a7b093882850fdb" args="(sp_artistbrowse *arb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_artistbrowse_backend_request_duration </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>arb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the time (in ms) that was spent waiting for the Spotify backend to serve the request</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>arb</em>&nbsp;</td><td>Artist browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>-1 if the request was served from the local cache If the result is not yet loaded the return value is undefined </dd></dl>

</div>
</div>
<a class="anchor" id="ga8b93b9e5630662855f35694280ba4d2b"></a><!-- doxytag: member="api.h::sp_artistbrowse_biography" ref="ga8b93b9e5630662855f35694280ba4d2b" args="(sp_artistbrowse *arb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* sp_artistbrowse_biography </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>arb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Given an artist browse object, return the artists biography</p>
<dl class="note"><dt><b>Note:</b></dt><dd>This function must be called from the same thread that did <a class="el" href="group__session.html#gaf2891f2daced4ff6da84219d6376b3aa">sp_session_create()</a> </dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>arb</em>&nbsp;</td><td>Artist browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Biography string in UTF-8 format. Returned string is valid as long as the album object stays allocated and no longer than the next call to <a class="el" href="group__session.html#gaff27cb730db6debf55e750e39e7fadd7">sp_session_process_events()</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a26">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga8dd8364b2fcd29c846209660bd9a69b2"></a><!-- doxytag: member="api.h::sp_artistbrowse_create" ref="ga8dd8364b2fcd29c846209660bd9a69b2" args="(sp_session *session, sp_artist *artist, sp_artistbrowse_type type, artistbrowse_complete_cb *callback, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a>* sp_artistbrowse_create </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td>
          <td class="paramname"> <em>artist</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__session.html#gac86504cc9e8cadbc30c8aa8dbf355034">sp_artistbrowse_type</a>&nbsp;</td>
          <td class="paramname"> <em>type</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__artistbrowse.html#ga8077aa18c043210e859479be2616a3e7">artistbrowse_complete_cb</a> *&nbsp;</td>
          <td class="paramname"> <em>callback</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">void *&nbsp;</td>
          <td class="paramname"> <em>userdata</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Initiate a request for browsing an artist</p>
<p>The user is responsible for freeing the returned artist browse using <a class="el" href="group__artistbrowse.html#ga14626a4f6a60b1caf61cb54c26783671">sp_artistbrowse_release()</a>. This can be done in the callback.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>artist</em>&nbsp;</td><td>Artist to be browsed. The artist metadata does not have to be loaded </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>type</em>&nbsp;</td><td>Type of data requested, see the sp_artistbrowse_type enum for details </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>callback</em>&nbsp;</td><td>Callback to be invoked when browsing has been completed. Pass NULL if you are not interested in this event. </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata passed to callback.</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Artist browse object</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__artistbrowse.html#ga8077aa18c043210e859479be2616a3e7">artistbrowse_complete_cb</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a51">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga203e757088ff7a5098f16a1367da25d2"></a><!-- doxytag: member="api.h::sp_artistbrowse_error" ref="ga203e757088ff7a5098f16a1367da25d2" args="(sp_artistbrowse *arb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_artistbrowse_error </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>arb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Check if browsing returned an error code.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>arb</em>&nbsp;</td><td>Artist browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_IS_LOADING SP_ERROR_OTHER_PERMANENT SP_ERROR_OTHER_TRANSIENT </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a32">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga966b0f59e7b2b3d0037e44bb49dcdabc"></a><!-- doxytag: member="api.h::sp_artistbrowse_is_loaded" ref="ga966b0f59e7b2b3d0037e44bb49dcdabc" args="(sp_artistbrowse *arb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_artistbrowse_is_loaded </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>arb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Check if an artist browse request is completed</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>arb</em>&nbsp;</td><td>Artist browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>True if browsing is completed, false if not </dd></dl>

</div>
</div>
<a class="anchor" id="gaf0055361abd53425d89a4636a32b5c83"></a><!-- doxytag: member="api.h::sp_artistbrowse_num_albums" ref="gaf0055361abd53425d89a4636a32b5c83" args="(sp_artistbrowse *arb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_artistbrowse_num_albums </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>arb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Given an artist browse object, return number of albums</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>arb</em>&nbsp;</td><td>Artist browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of albums for given artist </dd></dl>

</div>
</div>
<a class="anchor" id="ga98dc47d36d2789999bfe62707c5041d7"></a><!-- doxytag: member="api.h::sp_artistbrowse_num_portraits" ref="ga98dc47d36d2789999bfe62707c5041d7" args="(sp_artistbrowse *arb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_artistbrowse_num_portraits </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>arb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Given an artist browse object, return number of portraits available</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>arb</em>&nbsp;</td><td>Artist browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of portraits for given artist </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a24">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga2559638742416ac621af0e919e017d17"></a><!-- doxytag: member="api.h::sp_artistbrowse_num_similar_artists" ref="ga2559638742416ac621af0e919e017d17" args="(sp_artistbrowse *arb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_artistbrowse_num_similar_artists </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>arb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Given an artist browse object, return number of similar artists</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>arb</em>&nbsp;</td><td>Artist browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of similar artists for given artist </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a22">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga0c26782796af954300ce92fddea97637"></a><!-- doxytag: member="api.h::sp_artistbrowse_num_tophit_tracks" ref="ga0c26782796af954300ce92fddea97637" args="(sp_artistbrowse *arb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_artistbrowse_num_tophit_tracks </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>arb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Given an artist browse object, return number of tophit tracks This is a set of tracks for the artist with highest popularity</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>arb</em>&nbsp;</td><td>Artist browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of tophit tracks for given artist </dd></dl>

</div>
</div>
<a class="anchor" id="ga8c862caa2234125ffcc4e93287b1e029"></a><!-- doxytag: member="api.h::sp_artistbrowse_num_tracks" ref="ga8c862caa2234125ffcc4e93287b1e029" args="(sp_artistbrowse *arb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_artistbrowse_num_tracks </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>arb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Given an artist browse object, return number of tracks</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>arb</em>&nbsp;</td><td>Artist browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of tracks for given artist </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a25">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga5f164b2f9609a7bf2c89b3a1407ec239"></a><!-- doxytag: member="api.h::sp_artistbrowse_portrait" ref="ga5f164b2f9609a7bf2c89b3a1407ec239" args="(sp_artistbrowse *arb, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const byte* sp_artistbrowse_portrait </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>arb</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return image ID representing a portrait of the artist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>arb</em>&nbsp;</td><td>Artist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>The index of the portrait. Should be in the interval [0, <a class="el" href="group__artistbrowse.html#ga98dc47d36d2789999bfe62707c5041d7">sp_artistbrowse_num_portraits()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>ID byte sequence that can be passed to <a class="el" href="group__image.html#gaf29e89f45945db2b3667bf9db4279c33">sp_image_create()</a></dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__image.html#gaf29e89f45945db2b3667bf9db4279c33">sp_image_create</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga14626a4f6a60b1caf61cb54c26783671"></a><!-- doxytag: member="api.h::sp_artistbrowse_release" ref="ga14626a4f6a60b1caf61cb54c26783671" args="(sp_artistbrowse *arb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_artistbrowse_release </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>arb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Decrease the reference count of an artist browse result</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>arb</em>&nbsp;</td><td>The artist browse result object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a33">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gac60ef4f9e006a920f1d72b6098743fbc"></a><!-- doxytag: member="api.h::sp_artistbrowse_similar_artist" ref="gac60ef4f9e006a920f1d72b6098743fbc" args="(sp_artistbrowse *arb, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a>* sp_artistbrowse_similar_artist </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>arb</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Given an artist browse object, return a similar artist by index</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>arb</em>&nbsp;</td><td>Album browse object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>The index for the artist. Should be in the interval [0, <a class="el" href="group__artistbrowse.html#ga2559638742416ac621af0e919e017d17">sp_artistbrowse_num_similar_artists()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A pointer to an artist object.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__artist.html">Artist subsystem</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a23">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga5da55f43def03fe9f0d2c8b252b9755a"></a><!-- doxytag: member="api.h::sp_artistbrowse_tophit_track" ref="ga5da55f43def03fe9f0d2c8b252b9755a" args="(sp_artistbrowse *arb, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a>* sp_artistbrowse_tophit_track </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>arb</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Given an artist browse object, return one of its tophit tracks This is a set of tracks for the artist with highest popularity</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>arb</em>&nbsp;</td><td>Album browse object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>The index for the track. Should be in the interval [0, <a class="el" href="group__artistbrowse.html#ga0c26782796af954300ce92fddea97637">sp_artistbrowse_num_tophit_tracks()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A track object, or NULL if the index is out of range.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__track.html">Track subsystem</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga45d28771a856f935dc40ab40e27dec4c"></a><!-- doxytag: member="api.h::sp_artistbrowse_track" ref="ga45d28771a856f935dc40ab40e27dec4c" args="(sp_artistbrowse *arb, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a>* sp_artistbrowse_track </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>arb</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Given an artist browse object, return one of its tracks</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>arb</em>&nbsp;</td><td>Album browse object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>The index for the track. Should be in the interval [0, <a class="el" href="group__artistbrowse.html#ga8c862caa2234125ffcc4e93287b1e029">sp_artistbrowse_num_tracks()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A track object, or NULL if the index is out of range.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__track.html">Track subsystem</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a27">browse.c</a>.</dd>
</dl>
</div>
</div>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/group__error.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Error Handling</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#typedef-members">Typedefs</a> &#124;
<a href="#enum-members">Enumerations</a> &#124;
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<h1>Error Handling</h1>  </div>
</div>
<div class="contents">
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a></td></tr>
<tr><td colspan="2"><h2><a name="enum-members"></a>
Enumerations</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba16cb277dc84328e4b2c0cf6d5a0c0b8d">SP_ERROR_OK</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba17c588fa9648e3649185e595bdb88d6f">SP_ERROR_BAD_API_VERSION</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6bac8c438bd52975d14edf23d040e93d114">SP_ERROR_API_INITIALIZATION_FAILED</a> =  2, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba7b94fe2b53f58d91d4c3cda7bb706ff3">SP_ERROR_TRACK_NOT_PLAYABLE</a> =  3, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba2bad808a467ee4418adaa40f4844d059">SP_ERROR_BAD_APPLICATION_KEY</a> =  5, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba41052a4a158fa18bb1b8bfdd8c37f7dc">SP_ERROR_BAD_USERNAME_OR_PASSWORD</a> =  6, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba822f4031a82ab428cd04f2ecdc0e757f">SP_ERROR_USER_BANNED</a> =  7, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba9d11d66176b6ae95bf00486e9e39866b">SP_ERROR_UNABLE_TO_CONTACT_SERVER</a> =  8, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba995344026c012b3f59dc73e12c28b1ba">SP_ERROR_CLIENT_TOO_OLD</a> =  9, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba3f68775a5c001bd1de26afdf5ea4e09d">SP_ERROR_OTHER_PERMANENT</a> =  10, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baf3597d4af35adb4fc0d0793ea26f77b4">SP_ERROR_BAD_USER_AGENT</a> =  11, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6babb1116e69e1d651f9f175dbc8bb5fa32">SP_ERROR_MISSING_CALLBACK</a> =  12, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6bac9f65a7270391d35342ca9e6c01d519d">SP_ERROR_INVALID_INDATA</a> =  13, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba44b3f132578cbf9a43b5c048efcf63a2">SP_ERROR_INDEX_OUT_OF_RANGE</a> =  14, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba96c08adfcda17005c63142cd4e4cd9bb">SP_ERROR_USER_NEEDS_PREMIUM</a> =  15, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baf139c18351a543862bd9393ccebc5f91">SP_ERROR_OTHER_TRANSIENT</a> =  16, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba17f54c30d01baedc24547e62ed417cdd">SP_ERROR_IS_LOADING</a> =  17, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba71307cc7b8460042603f3f322d1096f4">SP_ERROR_NO_STREAM_AVAILABLE</a> =  18, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baaddac1f3b82e905711ab9ffe5b4b0329">SP_ERROR_PERMISSION_DENIED</a> =  19, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baa4bdf4298c9653549464d21ee528c881">SP_ERROR_INBOX_IS_FULL</a> =  20, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba3b8851ee3ba2bd7ad1fe377d94ac38c0">SP_ERROR_NO_CACHE</a> =  21, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baf8ade144869c958de534ecec9f9a36a9">SP_ERROR_NO_SUCH_USER</a> =  22, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba9ad34b997313d790f142f24e77e78e2d">SP_ERROR_NO_CREDENTIALS</a> =  23, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba8fda4dd3ee6ac931337a871fbee02978">SP_ERROR_NETWORK_DISABLED</a> =  24, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba846d94ada9e8db0c2bd5153f5801afa2">SP_ERROR_INVALID_DEVICE_ID</a> =  25, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6badb3af1736912156cbe0b1e39eaeee1c8">SP_ERROR_CANT_OPEN_TRACE_FILE</a> =  26, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba46c3b6173bb5b09445164402ac5ed81f">SP_ERROR_APPLICATION_BANNED</a> =  27, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba32fd1f63fd4dc7ec50bd11791f02953f">SP_ERROR_OFFLINE_TOO_MANY_TRACKS</a> =  31, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6bae6b9d9b013f1243548e4fbcf961559ff">SP_ERROR_OFFLINE_DISK_CACHE</a> =  32, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba7e16a1962fd4de081d73dc4a4e32eb04">SP_ERROR_OFFLINE_EXPIRED</a> =  33, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6bae102b46f4fae3b7b6b34e21ea80d656f">SP_ERROR_OFFLINE_NOT_ALLOWED</a> =  34, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba2c87afb46df21783f172a06b2c25d8f9">SP_ERROR_OFFLINE_LICENSE_LOST</a> =  35, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba9149b343017c0dea431839c8b4d9198c">SP_ERROR_OFFLINE_LICENSE_ERROR</a> =  36, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6baf588c0f7a2d8d11acea28ac2a4de43c4">SP_ERROR_LASTFM_AUTH_ERROR</a> =  39, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba7f8be4d478e51d2b205157c7c538a3e5">SP_ERROR_INVALID_ARGUMENT</a> =  40, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba73d533e0f25f4ba4cecd6d2e2502b80b">SP_ERROR_SYSTEM_FAILURE</a> =  41
<br/>
 }</td></tr>
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__error.html#ga983dee341d3c2008830513b7cffe7bf3">sp_error_message</a> (<a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> error)</td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>All functions in libspotify use the same set of error codes. Most of them return an error code, and let the result of the operation be stored in an out-parameter. </p>
<hr/><h2>Typedef Documentation</h2>
<a class="anchor" id="ga83154178d3a32668658734d2facfa22b"></a><!-- doxytag: member="api.h::sp_error" ref="ga83154178d3a32668658734d2facfa22b" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef enum <a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>  <a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Error codes returned by various functions </p>

</div>
</div>
<hr/><h2>Enumeration Type Documentation</h2>
<a class="anchor" id="gafd27986ce4cd9eeaeca8adda83c9eb6b"></a><!-- doxytag: member="api.h::sp_error" ref="gafd27986ce4cd9eeaeca8adda83c9eb6b" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Error codes returned by various functions </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba16cb277dc84328e4b2c0cf6d5a0c0b8d"></a><!-- doxytag: member="SP_ERROR_OK" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba16cb277dc84328e4b2c0cf6d5a0c0b8d" args="" -->SP_ERROR_OK</em>&nbsp;</td><td>
<p>No errors encountered. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba17c588fa9648e3649185e595bdb88d6f"></a><!-- doxytag: member="SP_ERROR_BAD_API_VERSION" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba17c588fa9648e3649185e595bdb88d6f" args="" -->SP_ERROR_BAD_API_VERSION</em>&nbsp;</td><td>
<p>The library version targeted does not match the one you claim you support. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6bac8c438bd52975d14edf23d040e93d114"></a><!-- doxytag: member="SP_ERROR_API_INITIALIZATION_FAILED" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6bac8c438bd52975d14edf23d040e93d114" args="" -->SP_ERROR_API_INITIALIZATION_FAILED</em>&nbsp;</td><td>
<p>Initialization of library failed - are cache locations etc. valid? </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba7b94fe2b53f58d91d4c3cda7bb706ff3"></a><!-- doxytag: member="SP_ERROR_TRACK_NOT_PLAYABLE" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba7b94fe2b53f58d91d4c3cda7bb706ff3" args="" -->SP_ERROR_TRACK_NOT_PLAYABLE</em>&nbsp;</td><td>
<p>The track specified for playing cannot be played. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba2bad808a467ee4418adaa40f4844d059"></a><!-- doxytag: member="SP_ERROR_BAD_APPLICATION_KEY" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba2bad808a467ee4418adaa40f4844d059" args="" -->SP_ERROR_BAD_APPLICATION_KEY</em>&nbsp;</td><td>
<p>The application key is invalid. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba41052a4a158fa18bb1b8bfdd8c37f7dc"></a><!-- doxytag: member="SP_ERROR_BAD_USERNAME_OR_PASSWORD" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba41052a4a158fa18bb1b8bfdd8c37f7dc" args="" -->SP_ERROR_BAD_USERNAME_OR_PASSWORD</em>&nbsp;</td><td>
<p>Login failed because of bad username and/or password. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba822f4031a82ab428cd04f2ecdc0e757f"></a><!-- doxytag: member="SP_ERROR_USER_BANNED" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba822f4031a82ab428cd04f2ecdc0e757f" args="" -->SP_ERROR_USER_BANNED</em>&nbsp;</td><td>
<p>The specified username is banned. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba9d11d66176b6ae95bf00486e9e39866b"></a><!-- doxytag: member="SP_ERROR_UNABLE_TO_CONTACT_SERVER" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba9d11d66176b6ae95bf00486e9e39866b" args="" -->SP_ERROR_UNABLE_TO_CONTACT_SERVER</em>&nbsp;</td><td>
<p>Cannot connect to the Spotify backend system. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba995344026c012b3f59dc73e12c28b1ba"></a><!-- doxytag: member="SP_ERROR_CLIENT_TOO_OLD" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba995344026c012b3f59dc73e12c28b1ba" args="" -->SP_ERROR_CLIENT_TOO_OLD</em>&nbsp;</td><td>
<p>Client is too old, library will need to be updated. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba3f68775a5c001bd1de26afdf5ea4e09d"></a><!-- doxytag: member="SP_ERROR_OTHER_PERMANENT" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba3f68775a5c001bd1de26afdf5ea4e09d" args="" -->SP_ERROR_OTHER_PERMANENT</em>&nbsp;</td><td>
<p>Some other error occurred, and it is permanent (e.g. trying to relogin will not help). </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6baf3597d4af35adb4fc0d0793ea26f77b4"></a><!-- doxytag: member="SP_ERROR_BAD_USER_AGENT" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6baf3597d4af35adb4fc0d0793ea26f77b4" args="" -->SP_ERROR_BAD_USER_AGENT</em>&nbsp;</td><td>
<p>The user agent string is invalid or too long. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6babb1116e69e1d651f9f175dbc8bb5fa32"></a><!-- doxytag: member="SP_ERROR_MISSING_CALLBACK" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6babb1116e69e1d651f9f175dbc8bb5fa32" args="" -->SP_ERROR_MISSING_CALLBACK</em>&nbsp;</td><td>
<p>No valid callback registered to handle events. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6bac9f65a7270391d35342ca9e6c01d519d"></a><!-- doxytag: member="SP_ERROR_INVALID_INDATA" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6bac9f65a7270391d35342ca9e6c01d519d" args="" -->SP_ERROR_INVALID_INDATA</em>&nbsp;</td><td>
<p>Input data was either missing or invalid. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba44b3f132578cbf9a43b5c048efcf63a2"></a><!-- doxytag: member="SP_ERROR_INDEX_OUT_OF_RANGE" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba44b3f132578cbf9a43b5c048efcf63a2" args="" -->SP_ERROR_INDEX_OUT_OF_RANGE</em>&nbsp;</td><td>
<p>Index out of range. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba96c08adfcda17005c63142cd4e4cd9bb"></a><!-- doxytag: member="SP_ERROR_USER_NEEDS_PREMIUM" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba96c08adfcda17005c63142cd4e4cd9bb" args="" -->SP_ERROR_USER_NEEDS_PREMIUM</em>&nbsp;</td><td>
<p>The specified user needs a premium account. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6baf139c18351a543862bd9393ccebc5f91"></a><!-- doxytag: member="SP_ERROR_OTHER_TRANSIENT" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6baf139c18351a543862bd9393ccebc5f91" args="" -->SP_ERROR_OTHER_TRANSIENT</em>&nbsp;</td><td>
<p>A transient error occurred. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba17f54c30d01baedc24547e62ed417cdd"></a><!-- doxytag: member="SP_ERROR_IS_LOADING" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba17f54c30d01baedc24547e62ed417cdd" args="" -->SP_ERROR_IS_LOADING</em>&nbsp;</td><td>
<p>The resource is currently loading. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba71307cc7b8460042603f3f322d1096f4"></a><!-- doxytag: member="SP_ERROR_NO_STREAM_AVAILABLE" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba71307cc7b8460042603f3f322d1096f4" args="" -->SP_ERROR_NO_STREAM_AVAILABLE</em>&nbsp;</td><td>
<p>Could not find any suitable stream to play. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6baaddac1f3b82e905711ab9ffe5b4b0329"></a><!-- doxytag: member="SP_ERROR_PERMISSION_DENIED" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6baaddac1f3b82e905711ab9ffe5b4b0329" args="" -->SP_ERROR_PERMISSION_DENIED</em>&nbsp;</td><td>
<p>Requested operation is not allowed. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6baa4bdf4298c9653549464d21ee528c881"></a><!-- doxytag: member="SP_ERROR_INBOX_IS_FULL" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6baa4bdf4298c9653549464d21ee528c881" args="" -->SP_ERROR_INBOX_IS_FULL</em>&nbsp;</td><td>
<p>Target inbox is full. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba3b8851ee3ba2bd7ad1fe377d94ac38c0"></a><!-- doxytag: member="SP_ERROR_NO_CACHE" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba3b8851ee3ba2bd7ad1fe377d94ac38c0" args="" -->SP_ERROR_NO_CACHE</em>&nbsp;</td><td>
<p>Cache is not enabled. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6baf8ade144869c958de534ecec9f9a36a9"></a><!-- doxytag: member="SP_ERROR_NO_SUCH_USER" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6baf8ade144869c958de534ecec9f9a36a9" args="" -->SP_ERROR_NO_SUCH_USER</em>&nbsp;</td><td>
<p>Requested user does not exist. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba9ad34b997313d790f142f24e77e78e2d"></a><!-- doxytag: member="SP_ERROR_NO_CREDENTIALS" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba9ad34b997313d790f142f24e77e78e2d" args="" -->SP_ERROR_NO_CREDENTIALS</em>&nbsp;</td><td>
<p>No credentials are stored. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba8fda4dd3ee6ac931337a871fbee02978"></a><!-- doxytag: member="SP_ERROR_NETWORK_DISABLED" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba8fda4dd3ee6ac931337a871fbee02978" args="" -->SP_ERROR_NETWORK_DISABLED</em>&nbsp;</td><td>
<p>Network disabled. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba846d94ada9e8db0c2bd5153f5801afa2"></a><!-- doxytag: member="SP_ERROR_INVALID_DEVICE_ID" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba846d94ada9e8db0c2bd5153f5801afa2" args="" -->SP_ERROR_INVALID_DEVICE_ID</em>&nbsp;</td><td>
<p>Invalid device ID. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6badb3af1736912156cbe0b1e39eaeee1c8"></a><!-- doxytag: member="SP_ERROR_CANT_OPEN_TRACE_FILE" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6badb3af1736912156cbe0b1e39eaeee1c8" args="" -->SP_ERROR_CANT_OPEN_TRACE_FILE</em>&nbsp;</td><td>
<p>Unable to open trace file. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba46c3b6173bb5b09445164402ac5ed81f"></a><!-- doxytag: member="SP_ERROR_APPLICATION_BANNED" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba46c3b6173bb5b09445164402ac5ed81f" args="" -->SP_ERROR_APPLICATION_BANNED</em>&nbsp;</td><td>
<p>This application is no longer allowed to use the Spotify service. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba32fd1f63fd4dc7ec50bd11791f02953f"></a><!-- doxytag: member="SP_ERROR_OFFLINE_TOO_MANY_TRACKS" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba32fd1f63fd4dc7ec50bd11791f02953f" args="" -->SP_ERROR_OFFLINE_TOO_MANY_TRACKS</em>&nbsp;</td><td>
<p>Reached the device limit for number of tracks to download. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6bae6b9d9b013f1243548e4fbcf961559ff"></a><!-- doxytag: member="SP_ERROR_OFFLINE_DISK_CACHE" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6bae6b9d9b013f1243548e4fbcf961559ff" args="" -->SP_ERROR_OFFLINE_DISK_CACHE</em>&nbsp;</td><td>
<p>Disk cache is full so no more tracks can be downloaded to offline mode. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba7e16a1962fd4de081d73dc4a4e32eb04"></a><!-- doxytag: member="SP_ERROR_OFFLINE_EXPIRED" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba7e16a1962fd4de081d73dc4a4e32eb04" args="" -->SP_ERROR_OFFLINE_EXPIRED</em>&nbsp;</td><td>
<p>Offline key has expired, the user needs to go online again. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6bae102b46f4fae3b7b6b34e21ea80d656f"></a><!-- doxytag: member="SP_ERROR_OFFLINE_NOT_ALLOWED" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6bae102b46f4fae3b7b6b34e21ea80d656f" args="" -->SP_ERROR_OFFLINE_NOT_ALLOWED</em>&nbsp;</td><td>
<p>This user is not allowed to use offline mode. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba2c87afb46df21783f172a06b2c25d8f9"></a><!-- doxytag: member="SP_ERROR_OFFLINE_LICENSE_LOST" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba2c87afb46df21783f172a06b2c25d8f9" args="" -->SP_ERROR_OFFLINE_LICENSE_LOST</em>&nbsp;</td><td>
<p>The license for this device has been lost. Most likely because the user used offline on three other device. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba9149b343017c0dea431839c8b4d9198c"></a><!-- doxytag: member="SP_ERROR_OFFLINE_LICENSE_ERROR" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba9149b343017c0dea431839c8b4d9198c" args="" -->SP_ERROR_OFFLINE_LICENSE_ERROR</em>&nbsp;</td><td>
<p>The Spotify license server does not respond correctly. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6baf588c0f7a2d8d11acea28ac2a4de43c4"></a><!-- doxytag: member="SP_ERROR_LASTFM_AUTH_ERROR" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6baf588c0f7a2d8d11acea28ac2a4de43c4" args="" -->SP_ERROR_LASTFM_AUTH_ERROR</em>&nbsp;</td><td>
<p>A LastFM scrobble authentication error has occurred. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba7f8be4d478e51d2b205157c7c538a3e5"></a><!-- doxytag: member="SP_ERROR_INVALID_ARGUMENT" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba7f8be4d478e51d2b205157c7c538a3e5" args="" -->SP_ERROR_INVALID_ARGUMENT</em>&nbsp;</td><td>
<p>An invalid argument was specified. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafd27986ce4cd9eeaeca8adda83c9eb6ba73d533e0f25f4ba4cecd6d2e2502b80b"></a><!-- doxytag: member="SP_ERROR_SYSTEM_FAILURE" ref="ggafd27986ce4cd9eeaeca8adda83c9eb6ba73d533e0f25f4ba4cecd6d2e2502b80b" args="" -->SP_ERROR_SYSTEM_FAILURE</em>&nbsp;</td><td>
<p>An operating system error. </p>
</td></tr>
</table>
</dd>
</dl>

</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="ga983dee341d3c2008830513b7cffe7bf3"></a><!-- doxytag: member="api.h::sp_error_message" ref="ga983dee341d3c2008830513b7cffe7bf3" args="(sp_error error)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* sp_error_message </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td>
          <td class="paramname"> <em>error</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Convert a numeric libspotify error code to a text string. The error message is in English. This function is useful for logging purposes.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>error</em>&nbsp;</td><td>The error code to lookup </td></tr>
  </table>
  </dd>
</dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a30">browse.c</a>, <a class="el" href="jukebox_8c-example.html#a15">jukebox.c</a>, and <a class="el" href="search_8c-example.html#a16">search.c</a>.</dd>
</dl>
</div>
</div>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/group__image.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Image handling</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#typedef-members">Typedefs</a> &#124;
<a href="#enum-members">Enumerations</a> &#124;
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<h1>Image handling</h1>  </div>
</div>
<div class="contents">
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#ga713bef7c5dedba7d91b9710cd9b5faa4">image_loaded_cb</a> (<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image, void *userdata)</td></tr>
<tr><td colspan="2"><h2><a name="enum-members"></a>
Enumerations</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#ga2cda19baf2460da5e81fb1917f54626b">sp_imageformat</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__image.html#gga2cda19baf2460da5e81fb1917f54626ba2fec8a1b400bd6cd5396b9852e4279b6">SP_IMAGE_FORMAT_UNKNOWN</a> =  -1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__image.html#gga2cda19baf2460da5e81fb1917f54626ba6263674800bea702c4d913d4b07c135d">SP_IMAGE_FORMAT_JPEG</a> =  0
<br/>
 }</td></tr>
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#gaf29e89f45945db2b3667bf9db4279c33">sp_image_create</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, const byte image_id[20])</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#ga70fb25cd2b0caaf15f637f36e75524b9">sp_image_create_from_link</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *l)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#gaa414f26ad1b9095645a83361597c92ce">sp_image_add_load_callback</a> (<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image, <a class="el" href="group__image.html#ga713bef7c5dedba7d91b9710cd9b5faa4">image_loaded_cb</a> *callback, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#gaaee68c65d9eab3499f2b6be5d048d6ba">sp_image_remove_load_callback</a> (<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image, <a class="el" href="group__image.html#ga713bef7c5dedba7d91b9710cd9b5faa4">image_loaded_cb</a> *callback, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#ga45312b1b9b5e5565485d61a8f0300e18">sp_image_is_loaded</a> (<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#gae40103df87426b346e0d0413d8d3b0ff">sp_image_error</a> (<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__image.html#ga2cda19baf2460da5e81fb1917f54626b">sp_imageformat</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#ga04448e81ca4916ba7ed223d0d817e803">sp_image_format</a> (<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const void *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#ga03700a7dfa90bfc8200b89f15acd91aa">sp_image_data</a> (<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image, size_t *data_size)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const byte *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#ga0ee0b98cc25c995fe208a992cc87d145">sp_image_image_id</a> (<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#ga98c93dbedfb182243742131a5224b83b">sp_image_add_ref</a> (<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__image.html#ga3df9af5f68b18df5a598b7510e9b587f">sp_image_release</a> (<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image)</td></tr>
</table>
<hr/><h2>Typedef Documentation</h2>
<a class="anchor" id="ga713bef7c5dedba7d91b9710cd9b5faa4"></a><!-- doxytag: member="api.h::image_loaded_cb" ref="ga713bef7c5dedba7d91b9710cd9b5faa4" args="(sp_image *image, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef void <a class="el" href="group__image.html#ga713bef7c5dedba7d91b9710cd9b5faa4">image_loaded_cb</a>(<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>The type of a callback used to notify the application that an image is done loading. </p>

</div>
</div>
<hr/><h2>Enumeration Type Documentation</h2>
<a class="anchor" id="ga2cda19baf2460da5e81fb1917f54626b"></a><!-- doxytag: member="api.h::sp_imageformat" ref="ga2cda19baf2460da5e81fb1917f54626b" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="group__image.html#ga2cda19baf2460da5e81fb1917f54626b">sp_imageformat</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Image format </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="gga2cda19baf2460da5e81fb1917f54626ba2fec8a1b400bd6cd5396b9852e4279b6"></a><!-- doxytag: member="SP_IMAGE_FORMAT_UNKNOWN" ref="gga2cda19baf2460da5e81fb1917f54626ba2fec8a1b400bd6cd5396b9852e4279b6" args="" -->SP_IMAGE_FORMAT_UNKNOWN</em>&nbsp;</td><td>
<p>Unknown image format. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga2cda19baf2460da5e81fb1917f54626ba6263674800bea702c4d913d4b07c135d"></a><!-- doxytag: member="SP_IMAGE_FORMAT_JPEG" ref="gga2cda19baf2460da5e81fb1917f54626ba6263674800bea702c4d913d4b07c135d" args="" -->SP_IMAGE_FORMAT_JPEG</em>&nbsp;</td><td>
<p>JPEG image. </p>
</td></tr>
</table>
</dd>
</dl>

</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="gaa414f26ad1b9095645a83361597c92ce"></a><!-- doxytag: member="api.h::sp_image_add_load_callback" ref="gaa414f26ad1b9095645a83361597c92ce" args="(sp_image *image, image_loaded_cb *callback, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_image_add_load_callback </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *&nbsp;</td>
          <td class="paramname"> <em>image</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__image.html#ga713bef7c5dedba7d91b9710cd9b5faa4">image_loaded_cb</a> *&nbsp;</td>
          <td class="paramname"> <em>callback</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">void *&nbsp;</td>
          <td class="paramname"> <em>userdata</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Add a callback that will be invoked when the image is loaded</p>
<p>If an image is loaded, and loading fails, the image will behave like an empty image.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>image</em>&nbsp;</td><td>Image object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>callback</em>&nbsp;</td><td>Callback that will be called when image has been fetched. </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Opaque pointer passed to <code>callback</code> </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="ga98c93dbedfb182243742131a5224b83b"></a><!-- doxytag: member="api.h::sp_image_add_ref" ref="ga98c93dbedfb182243742131a5224b83b" args="(sp_image *image)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_image_add_ref </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *&nbsp;</td>
          <td class="paramname"> <em>image</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Increase the reference count of an image</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>image</em>&nbsp;</td><td>The image object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="gaf29e89f45945db2b3667bf9db4279c33"></a><!-- doxytag: member="api.h::sp_image_create" ref="gaf29e89f45945db2b3667bf9db4279c33" args="(sp_session *session, const byte image_id[20])" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a>* sp_image_create </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const byte&nbsp;</td>
          <td class="paramname"> <em>image_id</em>[20]</td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Create an image object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>image_id</em>&nbsp;</td><td>Spotify image ID</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Pointer to an image object. To free the object, use <a class="el" href="group__image.html#ga3df9af5f68b18df5a598b7510e9b587f">sp_image_release()</a></dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__album.html#ga6616ef3df724af185c5eb58e8a0fb808">sp_album_cover</a> </dd>
<dd>
<a class="el" href="group__artistbrowse.html#ga5f164b2f9609a7bf2c89b3a1407ec239">sp_artistbrowse_portrait</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga70fb25cd2b0caaf15f637f36e75524b9"></a><!-- doxytag: member="api.h::sp_image_create_from_link" ref="ga70fb25cd2b0caaf15f637f36e75524b9" args="(sp_session *session, sp_link *l)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a>* sp_image_create_from_link </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td>
          <td class="paramname"> <em>l</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Create an image object from a link</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>l</em>&nbsp;</td><td>Spotify link object. This must be of SP_LINKTYPE_IMAGE type</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Pointer to an image object. To free the object, use <a class="el" href="group__image.html#ga3df9af5f68b18df5a598b7510e9b587f">sp_image_release()</a></dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__image.html#gaf29e89f45945db2b3667bf9db4279c33">sp_image_create</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga03700a7dfa90bfc8200b89f15acd91aa"></a><!-- doxytag: member="api.h::sp_image_data" ref="ga03700a7dfa90bfc8200b89f15acd91aa" args="(sp_image *image, size_t *data_size)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const void* sp_image_data </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *&nbsp;</td>
          <td class="paramname"> <em>image</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">size_t *&nbsp;</td>
          <td class="paramname"> <em>data_size</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Get image data</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>image</em>&nbsp;</td><td>Image object </td></tr>
    <tr><td valign="top"><tt>[out]</tt>&nbsp;</td><td valign="top"><em>data_size</em>&nbsp;</td><td>Size of raw image data</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Pointer to raw image data </dd></dl>

</div>
</div>
<a class="anchor" id="gae40103df87426b346e0d0413d8d3b0ff"></a><!-- doxytag: member="api.h::sp_image_error" ref="gae40103df87426b346e0d0413d8d3b0ff" args="(sp_image *image)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_image_error </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *&nbsp;</td>
          <td class="paramname"> <em>image</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Check if image retrieval returned an error code.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>image</em>&nbsp;</td><td>Image object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_IS_LOADING SP_ERROR_OTHER_PERMANENT SP_ERROR_OTHER_TRANSIENT </dd></dl>

</div>
</div>
<a class="anchor" id="ga04448e81ca4916ba7ed223d0d817e803"></a><!-- doxytag: member="api.h::sp_image_format" ref="ga04448e81ca4916ba7ed223d0d817e803" args="(sp_image *image)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__image.html#ga2cda19baf2460da5e81fb1917f54626b">sp_imageformat</a> sp_image_format </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *&nbsp;</td>
          <td class="paramname"> <em>image</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Get image format</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>image</em>&nbsp;</td><td>Image object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Image format as described by sp_imageformat </dd></dl>

</div>
</div>
<a class="anchor" id="ga0ee0b98cc25c995fe208a992cc87d145"></a><!-- doxytag: member="api.h::sp_image_image_id" ref="ga0ee0b98cc25c995fe208a992cc87d145" args="(sp_image *image)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const byte* sp_image_image_id </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *&nbsp;</td>
          <td class="paramname"> <em>image</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Get image ID</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>image</em>&nbsp;</td><td>Image object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Image ID </dd></dl>

</div>
</div>
<a class="anchor" id="ga45312b1b9b5e5565485d61a8f0300e18"></a><!-- doxytag: member="api.h::sp_image_is_loaded" ref="ga45312b1b9b5e5565485d61a8f0300e18" args="(sp_image *image)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_image_is_loaded </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *&nbsp;</td>
          <td class="paramname"> <em>image</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Check if an image is loaded. Before the image is loaded, the rest of the methods will behave as if the image is empty.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>image</em>&nbsp;</td><td>Image object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>True if image is loaded, false otherwise </dd></dl>

</div>
</div>
<a class="anchor" id="ga3df9af5f68b18df5a598b7510e9b587f"></a><!-- doxytag: member="api.h::sp_image_release" ref="ga3df9af5f68b18df5a598b7510e9b587f" args="(sp_image *image)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_image_release </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *&nbsp;</td>
          <td class="paramname"> <em>image</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Decrease the reference count of an image</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>image</em>&nbsp;</td><td>The image object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="gaaee68c65d9eab3499f2b6be5d048d6ba"></a><!-- doxytag: member="api.h::sp_image_remove_load_callback" ref="gaaee68c65d9eab3499f2b6be5d048d6ba" args="(sp_image *image, image_loaded_cb *callback, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_image_remove_load_callback </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *&nbsp;</td>
          <td class="paramname"> <em>image</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__image.html#ga713bef7c5dedba7d91b9710cd9b5faa4">image_loaded_cb</a> *&nbsp;</td>
          <td class="paramname"> <em>callback</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">void *&nbsp;</td>
          <td class="paramname"> <em>userdata</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Remove an image load callback previously added with <a class="el" href="group__image.html#gaa414f26ad1b9095645a83361597c92ce">sp_image_add_load_callback()</a></p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>image</em>&nbsp;</td><td>Image object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>callback</em>&nbsp;</td><td>Callback that will not be called when image has been fetched. </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Opaque pointer passed to <code>callback</code> </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/group__inbox.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Inbox subsystem</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#typedef-members">Typedefs</a> &#124;
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<h1>Inbox subsystem</h1>  </div>
</div>
<div class="contents">
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__inbox.html#ga5084d6ab753294730402a0c43b82e60c">inboxpost_complete_cb</a> (<a class="el" href="group__types.html#gaec0f2e5098cebc05ce56adfc9b346510">sp_inbox</a> *result, void *userdata)</td></tr>
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaec0f2e5098cebc05ce56adfc9b346510">sp_inbox</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__inbox.html#gaee29e747ca10b36597d91689ae074aa2">sp_inbox_post_tracks</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, const char *user, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *const *tracks, int num_tracks, const char *message, <a class="el" href="group__inbox.html#ga5084d6ab753294730402a0c43b82e60c">inboxpost_complete_cb</a> *callback, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__inbox.html#gaa452e9fe1fa7c9e2c780d28ce2ed63c5">sp_inbox_error</a> (<a class="el" href="group__types.html#gaec0f2e5098cebc05ce56adfc9b346510">sp_inbox</a> *inbox)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__inbox.html#gadb6b607bc26b9d362de4da09ec1c864f">sp_inbox_add_ref</a> (<a class="el" href="group__types.html#gaec0f2e5098cebc05ce56adfc9b346510">sp_inbox</a> *inbox)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__inbox.html#ga73659a65af92d30e4ac1cf3e06e74a0a">sp_inbox_release</a> (<a class="el" href="group__types.html#gaec0f2e5098cebc05ce56adfc9b346510">sp_inbox</a> *inbox)</td></tr>
</table>
<hr/><h2>Typedef Documentation</h2>
<a class="anchor" id="ga5084d6ab753294730402a0c43b82e60c"></a><!-- doxytag: member="api.h::inboxpost_complete_cb" ref="ga5084d6ab753294730402a0c43b82e60c" args="(sp_inbox *result, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef void <a class="el" href="group__inbox.html#ga5084d6ab753294730402a0c43b82e60c">inboxpost_complete_cb</a>(<a class="el" href="group__types.html#gaec0f2e5098cebc05ce56adfc9b346510">sp_inbox</a> *result, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>The type of a callback used in sp_inbox_post()</p>
<p>When this callback is called, the <a class="el" href="group__track.html#ga8b69cf193679c7e00031ae43e61c6a54">sp_track_is_loaded()</a>, <a class="el" href="group__album.html#ga46fbfa98be12c2f4067d5e679552cfb9">sp_album_is_loaded()</a>, and <a class="el" href="group__artist.html#gafc98f5093184a7ac7ce608302b0971ea">sp_artist_is_loaded()</a> functions will return non-zero for the objects contained in the search result.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>result</em>&nbsp;</td><td>The same pointer returned by <a class="el" href="group__search.html#ga2f64dfbcc1313e7d5179998cb28208d4">sp_search_create()</a> </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>The opaque pointer given to <a class="el" href="group__search.html#ga2f64dfbcc1313e7d5179998cb28208d4">sp_search_create()</a> </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="gadb6b607bc26b9d362de4da09ec1c864f"></a><!-- doxytag: member="api.h::sp_inbox_add_ref" ref="gadb6b607bc26b9d362de4da09ec1c864f" args="(sp_inbox *inbox)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_inbox_add_ref </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gaec0f2e5098cebc05ce56adfc9b346510">sp_inbox</a> *&nbsp;</td>
          <td class="paramname"> <em>inbox</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Increase the reference count of a inbox result</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>inbox</em>&nbsp;</td><td>The inbox result object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="gaa452e9fe1fa7c9e2c780d28ce2ed63c5"></a><!-- doxytag: member="api.h::sp_inbox_error" ref="gaa452e9fe1fa7c9e2c780d28ce2ed63c5" args="(sp_inbox *inbox)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_inbox_error </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gaec0f2e5098cebc05ce56adfc9b346510">sp_inbox</a> *&nbsp;</td>
          <td class="paramname"> <em>inbox</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Check if inbox operation returned an error code.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>inbox</em>&nbsp;</td><td>Inbox object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_OTHER_TRANSIENT SP_ERROR_PERMISSION_DENIED SP_ERROR_INVALID_INDATA SP_ERROR_INBOX_IS_FULL SP_ERROR_NO_SUCH_USER SP_ERROR_OTHER_PERMANENT </dd></dl>

</div>
</div>
<a class="anchor" id="gaee29e747ca10b36597d91689ae074aa2"></a><!-- doxytag: member="api.h::sp_inbox_post_tracks" ref="gaee29e747ca10b36597d91689ae074aa2" args="(sp_session *session, const char *user, sp_track *const *tracks, int num_tracks, const char *message, inboxpost_complete_cb *callback, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#gaec0f2e5098cebc05ce56adfc9b346510">sp_inbox</a>* sp_inbox_post_tracks </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>user</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *const *&nbsp;</td>
          <td class="paramname"> <em>tracks</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>num_tracks</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>message</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__inbox.html#ga5084d6ab753294730402a0c43b82e60c">inboxpost_complete_cb</a> *&nbsp;</td>
          <td class="paramname"> <em>callback</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">void *&nbsp;</td>
          <td class="paramname"> <em>userdata</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Add to inbox</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>user</em>&nbsp;</td><td>Canonical username of recipient </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>tracks</em>&nbsp;</td><td>Array of tracks to post </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>num_tracks</em>&nbsp;</td><td>Number of tracks in <code>tracks</code> </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>message</em>&nbsp;</td><td>Message to attach to tracks. UTF-8 </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>callback</em>&nbsp;</td><td>Callback to be invoked when the request has completed </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata passed to callback</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>sp_inbox object if the request has been sent, NULL if request failed to initialize </dd></dl>

</div>
</div>
<a class="anchor" id="ga73659a65af92d30e4ac1cf3e06e74a0a"></a><!-- doxytag: member="api.h::sp_inbox_release" ref="ga73659a65af92d30e4ac1cf3e06e74a0a" args="(sp_inbox *inbox)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_inbox_release </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gaec0f2e5098cebc05ce56adfc9b346510">sp_inbox</a> *&nbsp;</td>
          <td class="paramname"> <em>inbox</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Decrease the reference count of a inbox result</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>inbox</em>&nbsp;</td><td>The inbox result object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/group__link.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Links (Spotify URIs)</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#enum-members">Enumerations</a> &#124;
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<h1>Links (Spotify URIs)</h1>  </div>
</div>
<div class="contents">
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="enum-members"></a>
Enumerations</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#gabe9611f04086cdbed6e4e6e1fd913b98">sp_linktype</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a88b0098486cde586b4dcffb623ac6e63">SP_LINKTYPE_INVALID</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a5911dbb7258ed160b2f9c114cef152f1">SP_LINKTYPE_TRACK</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a7716eb95eed852d08300e6e64febc7f3">SP_LINKTYPE_ALBUM</a> =  2, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a4402b3b001aebb39fd55296f83c60b7e">SP_LINKTYPE_ARTIST</a> =  3, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98ad5909ab9b1cca702163e116b04b6ee8e">SP_LINKTYPE_SEARCH</a> =  4, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a2640ed065a64b6a9f67e71bbeb2af2dd">SP_LINKTYPE_PLAYLIST</a> =  5, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98ab7a356adce8b1ea34daf21532c7b50e6">SP_LINKTYPE_PROFILE</a> =  6, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98ab649bd86d0fc55ab3fafed3050261353">SP_LINKTYPE_STARRED</a> =  7, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a0698cd0123190c7af55daf79bb642805">SP_LINKTYPE_LOCALTRACK</a> =  8, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__link.html#ggabe9611f04086cdbed6e4e6e1fd913b98a1b20b8e2b8773df47b241dc7d28ea0e8">SP_LINKTYPE_IMAGE</a> =  9
<br/>
 }</td></tr>
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#gaea9c39f35f7986fc9fed4584fa211127">sp_link_create_from_string</a> (const char *link)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga82c29419ce70e2b504670e3d45167d5d">sp_link_create_from_track</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track, int offset)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga040627b0df84425947c82cd8890122ad">sp_link_create_from_album</a> (<a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#gaa87e346c29f1077d7a62c364719d4a55">sp_link_create_from_album_cover</a> (<a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *album, <a class="el" href="group__session.html#ga61bc424465d776af3ceeb69eee2bb492">sp_image_size</a> size)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga3196ce9de3da4f1d5944a0b58bd80540">sp_link_create_from_artist</a> (<a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *artist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#gaafb25ee14bfb27f9cbbab1b039d4d225">sp_link_create_from_artist_portrait</a> (<a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *artist, <a class="el" href="group__session.html#ga61bc424465d776af3ceeb69eee2bb492">sp_image_size</a> size)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga32218fbd912ddddbb749cb42a72b6bcd">sp_link_create_from_artistbrowse_portrait</a> (<a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *arb, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga95c97ba4de9c4040047276ad618a108e">sp_link_create_from_search</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga805392bfa8e526eebedc1cf5a7bcae0f">sp_link_create_from_playlist</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#gaaa78b1750179c17f8152408cea43efef">sp_link_create_from_user</a> (<a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *user)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#gaa85fbea312127db44685b7e9dc492042">sp_link_create_from_image</a> (<a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *image)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga9f169be53f098adcf12f7a10b8bd3ef7">sp_link_as_string</a> (<a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *link, char *buffer, int buffer_size)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__link.html#gabe9611f04086cdbed6e4e6e1fd913b98">sp_linktype</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga6140f924c696d53469bb8930cd53e1e6">sp_link_type</a> (<a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *link)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga2560687997d7ce0fbf4f05251d87d32a">sp_link_as_track</a> (<a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *link)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga80f6f752832f76c268c0bfd3ca45e6d2">sp_link_as_track_and_offset</a> (<a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *link, int *offset)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#gaafa98628d0abadcca27dd3b227c7337b">sp_link_as_album</a> (<a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *link)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#gab32979d26dcf68936202fa7aed7b6e49">sp_link_as_artist</a> (<a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *link)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga3e29975f47fc0a51be813b4774a3d6f3">sp_link_as_user</a> (<a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *link)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#gac5a808b15bceed41508bd3863c8f4b3b">sp_link_add_ref</a> (<a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *link)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__link.html#ga2b06ab16d1f6436cd8d36dbff2b5c022">sp_link_release</a> (<a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *link)</td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>These functions handle links to Spotify entities in a way that allows you to not care about the textual representation of the link. </p>
<hr/><h2>Enumeration Type Documentation</h2>
<a class="anchor" id="gabe9611f04086cdbed6e4e6e1fd913b98"></a><!-- doxytag: member="api.h::sp_linktype" ref="gabe9611f04086cdbed6e4e6e1fd913b98" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="group__link.html#gabe9611f04086cdbed6e4e6e1fd913b98">sp_linktype</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Link types </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="ggabe9611f04086cdbed6e4e6e1fd913b98a88b0098486cde586b4dcffb623ac6e63"></a><!-- doxytag: member="SP_LINKTYPE_INVALID" ref="ggabe9611f04086cdbed6e4e6e1fd913b98a88b0098486cde586b4dcffb623ac6e63" args="" -->SP_LINKTYPE_INVALID</em>&nbsp;</td><td>
<p>Link type not valid - default until the library has parsed the link, or when parsing failed. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabe9611f04086cdbed6e4e6e1fd913b98a5911dbb7258ed160b2f9c114cef152f1"></a><!-- doxytag: member="SP_LINKTYPE_TRACK" ref="ggabe9611f04086cdbed6e4e6e1fd913b98a5911dbb7258ed160b2f9c114cef152f1" args="" -->SP_LINKTYPE_TRACK</em>&nbsp;</td><td>
<p>Link type is track. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabe9611f04086cdbed6e4e6e1fd913b98a7716eb95eed852d08300e6e64febc7f3"></a><!-- doxytag: member="SP_LINKTYPE_ALBUM" ref="ggabe9611f04086cdbed6e4e6e1fd913b98a7716eb95eed852d08300e6e64febc7f3" args="" -->SP_LINKTYPE_ALBUM</em>&nbsp;</td><td>
<p>Link type is album. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabe9611f04086cdbed6e4e6e1fd913b98a4402b3b001aebb39fd55296f83c60b7e"></a><!-- doxytag: member="SP_LINKTYPE_ARTIST" ref="ggabe9611f04086cdbed6e4e6e1fd913b98a4402b3b001aebb39fd55296f83c60b7e" args="" -->SP_LINKTYPE_ARTIST</em>&nbsp;</td><td>
<p>Link type is artist. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabe9611f04086cdbed6e4e6e1fd913b98ad5909ab9b1cca702163e116b04b6ee8e"></a><!-- doxytag: member="SP_LINKTYPE_SEARCH" ref="ggabe9611f04086cdbed6e4e6e1fd913b98ad5909ab9b1cca702163e116b04b6ee8e" args="" -->SP_LINKTYPE_SEARCH</em>&nbsp;</td><td>
<p>Link type is search. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabe9611f04086cdbed6e4e6e1fd913b98a2640ed065a64b6a9f67e71bbeb2af2dd"></a><!-- doxytag: member="SP_LINKTYPE_PLAYLIST" ref="ggabe9611f04086cdbed6e4e6e1fd913b98a2640ed065a64b6a9f67e71bbeb2af2dd" args="" -->SP_LINKTYPE_PLAYLIST</em>&nbsp;</td><td>
<p>Link type is playlist. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabe9611f04086cdbed6e4e6e1fd913b98ab7a356adce8b1ea34daf21532c7b50e6"></a><!-- doxytag: member="SP_LINKTYPE_PROFILE" ref="ggabe9611f04086cdbed6e4e6e1fd913b98ab7a356adce8b1ea34daf21532c7b50e6" args="" -->SP_LINKTYPE_PROFILE</em>&nbsp;</td><td>
<p>Link type is profile. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabe9611f04086cdbed6e4e6e1fd913b98ab649bd86d0fc55ab3fafed3050261353"></a><!-- doxytag: member="SP_LINKTYPE_STARRED" ref="ggabe9611f04086cdbed6e4e6e1fd913b98ab649bd86d0fc55ab3fafed3050261353" args="" -->SP_LINKTYPE_STARRED</em>&nbsp;</td><td>
<p>Link type is starred. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabe9611f04086cdbed6e4e6e1fd913b98a0698cd0123190c7af55daf79bb642805"></a><!-- doxytag: member="SP_LINKTYPE_LOCALTRACK" ref="ggabe9611f04086cdbed6e4e6e1fd913b98a0698cd0123190c7af55daf79bb642805" args="" -->SP_LINKTYPE_LOCALTRACK</em>&nbsp;</td><td>
<p>Link type is a local file. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabe9611f04086cdbed6e4e6e1fd913b98a1b20b8e2b8773df47b241dc7d28ea0e8"></a><!-- doxytag: member="SP_LINKTYPE_IMAGE" ref="ggabe9611f04086cdbed6e4e6e1fd913b98a1b20b8e2b8773df47b241dc7d28ea0e8" args="" -->SP_LINKTYPE_IMAGE</em>&nbsp;</td><td>
<p>Link type is an image. </p>
</td></tr>
</table>
</dd>
</dl>

</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="gac5a808b15bceed41508bd3863c8f4b3b"></a><!-- doxytag: member="api.h::sp_link_add_ref" ref="gac5a808b15bceed41508bd3863c8f4b3b" args="(sp_link *link)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_link_add_ref </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td>
          <td class="paramname"> <em>link</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Increase the reference count of a link</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>link</em>&nbsp;</td><td>The link object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="gaafa98628d0abadcca27dd3b227c7337b"></a><!-- doxytag: member="api.h::sp_link_as_album" ref="gaafa98628d0abadcca27dd3b227c7337b" args="(sp_link *link)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a>* sp_link_as_album </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td>
          <td class="paramname"> <em>link</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>The album representation for the given link</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>link</em>&nbsp;</td><td>The Spotify link whose album you are interested in</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The album representation of the given album link If the link is not of album type then NULL is returned </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a49">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gab32979d26dcf68936202fa7aed7b6e49"></a><!-- doxytag: member="api.h::sp_link_as_artist" ref="gab32979d26dcf68936202fa7aed7b6e49" args="(sp_link *link)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a>* sp_link_as_artist </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td>
          <td class="paramname"> <em>link</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>The artist representation for the given link</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>link</em>&nbsp;</td><td>The Spotify link whose artist you are interested in</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The artist representation of the given link If the link is not of artist type then NULL is returned </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a52">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga9f169be53f098adcf12f7a10b8bd3ef7"></a><!-- doxytag: member="api.h::sp_link_as_string" ref="ga9f169be53f098adcf12f7a10b8bd3ef7" args="(sp_link *link, char *buffer, int buffer_size)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_link_as_string </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td>
          <td class="paramname"> <em>link</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">char *&nbsp;</td>
          <td class="paramname"> <em>buffer</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>buffer_size</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Create a string representation of the given Spotify link</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>link</em>&nbsp;</td><td>The Spotify link whose string representation you are interested in </td></tr>
    <tr><td valign="top"><tt>[out]</tt>&nbsp;</td><td valign="top"><em>buffer</em>&nbsp;</td><td>The buffer to hold the string representation of link </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>buffer_size</em>&nbsp;</td><td>The max size of the buffer that will hold the string representation The resulting string is guaranteed to always be null terminated if buffer_size &gt; 0</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The number of characters in the string representation of the link. If this value is greater or equal than <code>buffer_size</code>, output was truncated. </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a11">browse.c</a>, and <a class="el" href="toplist_8c-example.html#a5">toplist.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga2560687997d7ce0fbf4f05251d87d32a"></a><!-- doxytag: member="api.h::sp_link_as_track" ref="ga2560687997d7ce0fbf4f05251d87d32a" args="(sp_link *link)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a>* sp_link_as_track </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td>
          <td class="paramname"> <em>link</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>The track representation for the given link</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>link</em>&nbsp;</td><td>The Spotify link whose track you are interested in</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The track representation of the given track link If the link is not of track type then NULL is returned. </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a56">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga80f6f752832f76c268c0bfd3ca45e6d2"></a><!-- doxytag: member="api.h::sp_link_as_track_and_offset" ref="ga80f6f752832f76c268c0bfd3ca45e6d2" args="(sp_link *link, int *offset)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a>* sp_link_as_track_and_offset </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td>
          <td class="paramname"> <em>link</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int *&nbsp;</td>
          <td class="paramname"> <em>offset</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>The track and offset into track representation for the given link</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>link</em>&nbsp;</td><td>The Spotify link whose track you are interested in </td></tr>
    <tr><td valign="top"><tt>[out]</tt>&nbsp;</td><td valign="top"><em>offset</em>&nbsp;</td><td>Pointer to offset into track (in milliseconds). If the link does not contain an offset this will be set to 0.</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The track representation of the given track link If the link is not of track type then NULL is returned. </dd></dl>

</div>
</div>
<a class="anchor" id="ga3e29975f47fc0a51be813b4774a3d6f3"></a><!-- doxytag: member="api.h::sp_link_as_user" ref="ga3e29975f47fc0a51be813b4774a3d6f3" args="(sp_link *link)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a>* sp_link_as_user </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td>
          <td class="paramname"> <em>link</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>The user representation for the given link</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>link</em>&nbsp;</td><td>The Spotify link whose user you are interested in</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The user representation of the given link If the link is not of user type then NULL is returned </dd></dl>

</div>
</div>
<a class="anchor" id="ga040627b0df84425947c82cd8890122ad"></a><!-- doxytag: member="api.h::sp_link_create_from_album" ref="ga040627b0df84425947c82cd8890122ad" args="(sp_album *album)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a>* sp_link_create_from_album </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td>
          <td class="paramname"> <em>album</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Create a link object from an album</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>album</em>&nbsp;</td><td>An album object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A link representing the album</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>You need to release the link when you are done with it. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__link.html#ga2b06ab16d1f6436cd8d36dbff2b5c022">sp_link_release()</a> </dd></dl>

</div>
</div>
<a class="anchor" id="gaa87e346c29f1077d7a62c364719d4a55"></a><!-- doxytag: member="api.h::sp_link_create_from_album_cover" ref="gaa87e346c29f1077d7a62c364719d4a55" args="(sp_album *album, sp_image_size size)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a>* sp_link_create_from_album_cover </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td>
          <td class="paramname"> <em>album</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__session.html#ga61bc424465d776af3ceeb69eee2bb492">sp_image_size</a>&nbsp;</td>
          <td class="paramname"> <em>size</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Create an image link object from an album</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>album</em>&nbsp;</td><td>An album object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>size</em>&nbsp;</td><td>The desired size of the image</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A link representing the album cover. Type is set to SP_LINKTYPE_IMAGE</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>You need to release the link when you are done with it. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__link.html#ga2b06ab16d1f6436cd8d36dbff2b5c022">sp_link_release()</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga3196ce9de3da4f1d5944a0b58bd80540"></a><!-- doxytag: member="api.h::sp_link_create_from_artist" ref="ga3196ce9de3da4f1d5944a0b58bd80540" args="(sp_artist *artist)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a>* sp_link_create_from_artist </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td>
          <td class="paramname"> <em>artist</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Creates a link object from an artist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>artist</em>&nbsp;</td><td>An artist object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A link object representing the artist</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>You need to release the link when you are done with it. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__link.html#ga2b06ab16d1f6436cd8d36dbff2b5c022">sp_link_release()</a> </dd></dl>

</div>
</div>
<a class="anchor" id="gaafb25ee14bfb27f9cbbab1b039d4d225"></a><!-- doxytag: member="api.h::sp_link_create_from_artist_portrait" ref="gaafb25ee14bfb27f9cbbab1b039d4d225" args="(sp_artist *artist, sp_image_size size)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a>* sp_link_create_from_artist_portrait </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td>
          <td class="paramname"> <em>artist</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__session.html#ga61bc424465d776af3ceeb69eee2bb492">sp_image_size</a>&nbsp;</td>
          <td class="paramname"> <em>size</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Creates a link object pointing to an artist portrait</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>artist</em>&nbsp;</td><td>Artist browse object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>size</em>&nbsp;</td><td>The desired size of the image</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A link object representing an image</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>You need to release the link when you are done with it. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__link.html#ga2b06ab16d1f6436cd8d36dbff2b5c022">sp_link_release()</a> </dd>
<dd>
<a class="el" href="group__artistbrowse.html#ga98dc47d36d2789999bfe62707c5041d7">sp_artistbrowse_num_portraits()</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="toplist_8c-example.html#a3">toplist.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga32218fbd912ddddbb749cb42a72b6bcd"></a><!-- doxytag: member="api.h::sp_link_create_from_artistbrowse_portrait" ref="ga32218fbd912ddddbb749cb42a72b6bcd" args="(sp_artistbrowse *arb, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a>* sp_link_create_from_artistbrowse_portrait </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>arb</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Creates a link object from an artist portrait</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>arb</em>&nbsp;</td><td>Artist browse object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>The index of the portrait. Should be in the interval [0, <a class="el" href="group__artistbrowse.html#ga98dc47d36d2789999bfe62707c5041d7">sp_artistbrowse_num_portraits()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A link object representing an image</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>You need to release the link when you are done with it. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__link.html#ga2b06ab16d1f6436cd8d36dbff2b5c022">sp_link_release()</a> </dd>
<dd>
<a class="el" href="group__artistbrowse.html#ga98dc47d36d2789999bfe62707c5041d7">sp_artistbrowse_num_portraits()</a></dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>The difference from <a class="el" href="group__link.html#gaafb25ee14bfb27f9cbbab1b039d4d225">sp_link_create_from_artist_portrait()</a> is that the artist browse object may contain multiple portraits. </dd></dl>

</div>
</div>
<a class="anchor" id="gaa85fbea312127db44685b7e9dc492042"></a><!-- doxytag: member="api.h::sp_link_create_from_image" ref="gaa85fbea312127db44685b7e9dc492042" args="(sp_image *image)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a>* sp_link_create_from_image </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a> *&nbsp;</td>
          <td class="paramname"> <em>image</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Create a link object representing the given image</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>image</em>&nbsp;</td><td>Image object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A link representing the image.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>You need to release the link when you are done with it. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__link.html#ga2b06ab16d1f6436cd8d36dbff2b5c022">sp_link_release()</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga805392bfa8e526eebedc1cf5a7bcae0f"></a><!-- doxytag: member="api.h::sp_link_create_from_playlist" ref="ga805392bfa8e526eebedc1cf5a7bcae0f" args="(sp_playlist *playlist)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a>* sp_link_create_from_playlist </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Create a link object representing the given playlist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A link representing the playlist</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>You need to release the link when you are done with it. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__link.html#ga2b06ab16d1f6436cd8d36dbff2b5c022">sp_link_release()</a></dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Due to reasons in the playlist backend design and the Spotify URI scheme you need to wait for the playlist to be loaded before you can successfully construct an URI. If <a class="el" href="group__link.html#ga805392bfa8e526eebedc1cf5a7bcae0f">sp_link_create_from_playlist()</a> returns NULL, try again after teh playlist_state_changed callback has fired. </dd></dl>

</div>
</div>
<a class="anchor" id="ga95c97ba4de9c4040047276ad618a108e"></a><!-- doxytag: member="api.h::sp_link_create_from_search" ref="ga95c97ba4de9c4040047276ad618a108e" args="(sp_search *search)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a>* sp_link_create_from_search </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td>
          <td class="paramname"> <em>search</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Generate a link object representing the current search</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search</em>&nbsp;</td><td>Search object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A link representing the search</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>You need to release the link when you are done with it. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__link.html#ga2b06ab16d1f6436cd8d36dbff2b5c022">sp_link_release()</a> </dd></dl>

</div>
</div>
<a class="anchor" id="gaea9c39f35f7986fc9fed4584fa211127"></a><!-- doxytag: member="api.h::sp_link_create_from_string" ref="gaea9c39f35f7986fc9fed4584fa211127" args="(const char *link)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a>* sp_link_create_from_string </td>
          <td>(</td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>link</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Create a Spotify link given a string</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>link</em>&nbsp;</td><td>A string representation of a Spotify link</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A link representation of the given string representation. If the link could not be parsed, this function returns NULL.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>You need to release the link when you are done with it. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__link.html#ga6140f924c696d53469bb8930cd53e1e6">sp_link_type()</a> </dd>
<dd>
<a class="el" href="group__link.html#ga2b06ab16d1f6436cd8d36dbff2b5c022">sp_link_release()</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a45">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga82c29419ce70e2b504670e3d45167d5d"></a><!-- doxytag: member="api.h::sp_link_create_from_track" ref="ga82c29419ce70e2b504670e3d45167d5d" args="(sp_track *track, int offset)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a>* sp_link_create_from_track </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td>
          <td class="paramname"> <em>track</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>offset</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Generates a link object from a track</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track</em>&nbsp;</td><td>A track object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>offset</em>&nbsp;</td><td>Offset in track in ms.</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A link representing the track</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>You need to release the link when you are done with it. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__link.html#ga2b06ab16d1f6436cd8d36dbff2b5c022">sp_link_release()</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a10">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gaaa78b1750179c17f8152408cea43efef"></a><!-- doxytag: member="api.h::sp_link_create_from_user" ref="gaaa78b1750179c17f8152408cea43efef" args="(sp_user *user)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a>* sp_link_create_from_user </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *&nbsp;</td>
          <td class="paramname"> <em>user</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Create a link object representing the given playlist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>user</em>&nbsp;</td><td>User object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A link representing the profile.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>You need to release the link when you are done with it. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__link.html#ga2b06ab16d1f6436cd8d36dbff2b5c022">sp_link_release()</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga2b06ab16d1f6436cd8d36dbff2b5c022"></a><!-- doxytag: member="api.h::sp_link_release" ref="ga2b06ab16d1f6436cd8d36dbff2b5c022" args="(sp_link *link)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_link_release </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td>
          <td class="paramname"> <em>link</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Decrease the reference count of a link</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>link</em>&nbsp;</td><td>The link object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a12">browse.c</a>, and <a class="el" href="toplist_8c-example.html#a6">toplist.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga6140f924c696d53469bb8930cd53e1e6"></a><!-- doxytag: member="api.h::sp_link_type" ref="ga6140f924c696d53469bb8930cd53e1e6" args="(sp_link *link)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__link.html#gabe9611f04086cdbed6e4e6e1fd913b98">sp_linktype</a> sp_link_type </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td>
          <td class="paramname"> <em>link</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>The link type of the specified link</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>link</em>&nbsp;</td><td>The Spotify link whose type you are interested in</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The link type of the specified link - see the sp_linktype enum for possible values </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a46">browse.c</a>.</dd>
</dl>
</div>
</div>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/group__playlist.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Playlist subsystem</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#nested-classes">Data Structures</a> &#124;
<a href="#typedef-members">Typedefs</a> &#124;
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<h1>Playlist subsystem</h1>  </div>
</div>
<div class="contents">
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="nested-classes"></a>
Data Structures</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__playlist__callbacks.html">sp_playlist_callbacks</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__playlistcontainer__callbacks.html">sp_playlistcontainer_callbacks</a></td></tr>
<tr><td colspan="2"><h2><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef struct <br class="typebreak"/>
<a class="el" href="structsp__playlist__callbacks.html">sp_playlist_callbacks</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga8249fe3d53c6dce0f154d0bfd3e80c6a">sp_playlist_callbacks</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef struct <br class="typebreak"/>
<a class="el" href="structsp__playlistcontainer__callbacks.html">sp_playlistcontainer_callbacks</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga8786e3840bb3774fc929183e3a9df281">sp_playlistcontainer_callbacks</a></td></tr>
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gaee8ea6c07dfdca3397e27b278fa4870a">sp_playlist_is_loaded</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gab15fca12d387c69b4998a4d2b48e5b32">sp_playlist_add_callbacks</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, <a class="el" href="structsp__playlist__callbacks.html">sp_playlist_callbacks</a> *callbacks, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga7fcbf909a0fa8bf25f0b1d1e7dd0e160">sp_playlist_remove_callbacks</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, <a class="el" href="structsp__playlist__callbacks.html">sp_playlist_callbacks</a> *callbacks, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga684a3acc60f99b3b26488ed813ee5d23">sp_playlist_num_tracks</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga7a03854fe6072476306780d23c6cac16">sp_playlist_track</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gab8e77f8d63e787f8aa1a066d74daa74c">sp_playlist_track_create_time</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga80fcd9e7b40c791433c07d66e2ad432a">sp_playlist_track_creator</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gab9e00ee5bc6b5dc0b3d58cbdb32c0c7b">sp_playlist_track_seen</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga69f5cc1bdd7dbdcdb476a7b1d2b7834d">sp_playlist_track_set_seen</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, int index, bool seen)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga6887b9dabb30a060b10bdb75f8b3f971">sp_playlist_track_message</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga61b7e33cc1aedb4e31a2af75ae0ac8cc">sp_playlist_name</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gad6c3880c514353e204fdd90830b516ec">sp_playlist_rename</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, const char *new_name)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gac3e4295d3353eb9998402aedfdbd55de">sp_playlist_owner</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga8ad160f654f02f13690568070dd57353">sp_playlist_is_collaborative</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gad15410bcc2ebd986adabda865830bce4">sp_playlist_set_collaborative</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, bool collaborative)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga0bde47f340e0cd590a78007c6af69307">sp_playlist_set_autolink_tracks</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, bool link)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gab1d8e0ee9b436ecbb104bbd6cc0665be">sp_playlist_get_description</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga409cb6b2a88db7242ec939b6644e8c30">sp_playlist_get_image</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, byte image[20])</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gaf0e39b5969259d10625eb398af0f3f43">sp_playlist_has_pending_changes</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga2344a47133f7f0aed0a67e154ecc4dc4">sp_playlist_add_tracks</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *const *tracks, int num_tracks, int position, <a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gabd62cd7ff9484b4c31ff7f159ec41b6a">sp_playlist_remove_tracks</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, const int *tracks, int num_tracks)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga90ffd8c9fc6abc7375e89f4cb49adb11">sp_playlist_reorder_tracks</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, const int *tracks, int num_tracks, int new_position)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">unsigned int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga967ad87f0db702513ecda82546f667c5">sp_playlist_num_subscribers</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="structsp__subscribers.html">sp_subscribers</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gad49f491babc475f8d4aeea1b4452ff8b">sp_playlist_subscribers</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gae7754b74b1c3c8f5222ca43b6608ce6a">sp_playlist_subscribers_free</a> (<a class="el" href="structsp__subscribers.html">sp_subscribers</a> *subscribers)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga9ebbf147230b3ca98b68e556cf24e6bd">sp_playlist_update_subscribers</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga28456d1242693c6d890516dc782ab3ec">sp_playlist_is_in_ram</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gaf6ca8a349bdd982f6c8dda52ed691017">sp_playlist_set_in_ram</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, bool in_ram)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga342a6a0cfe10531ef7cb3c6629c1e8e7">sp_playlist_create</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *link)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga784f648f9cc431ef3b51f3491c2f169f">sp_playlist_set_offline_mode</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, bool offline)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__session.html#ga811fa52ed0fdb5cda732682e27e40417">sp_playlist_offline_status</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga7170157af21445c37a21a2241f91ff06">sp_playlist_get_offline_status</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga83ca1a25f50834f8e6f8ee1e883a8c6e">sp_playlist_get_offline_download_completed</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gacb10979add5a954e5c1600ef9c5b17a8">sp_playlist_add_ref</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gacb9250eb530869b039541a8b62dfab6c">sp_playlist_release</a> (<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga1976cb49c391cdd2dbe7c40d1bc71570">sp_playlistcontainer_add_callbacks</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, <a class="el" href="structsp__playlistcontainer__callbacks.html">sp_playlistcontainer_callbacks</a> *callbacks, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gafb5242b8f0f9964cec29d32f4d6c1164">sp_playlistcontainer_remove_callbacks</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, <a class="el" href="structsp__playlistcontainer__callbacks.html">sp_playlistcontainer_callbacks</a> *callbacks, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga7a1cbf558b2b364b8249d4ce432df700">sp_playlistcontainer_num_playlists</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gae23cb67b4b26bca663034997c4418fa8">sp_playlistcontainer_is_loaded</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga5ddd8c8064c281a14c6fd7877f522dc6">sp_playlistcontainer_playlist</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__session.html#gafdd7117213605e6f2671c4f289b44609">sp_playlist_type</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga79286860a3eeada495e97c5ad1fd7ebf">sp_playlistcontainer_playlist_type</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga852e5f5bcd4520be2e3d6d5d94def44a">sp_playlistcontainer_playlist_folder_name</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, int index, char *buffer, int buffer_size)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">sp_uint64&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga6939f9db71199612fc5a19d395e3a7f8">sp_playlistcontainer_playlist_folder_id</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga840b82b1074a7ca1c9eacd351bed24c2">sp_playlistcontainer_add_new_playlist</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, const char *name)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga87699479087915b741ceef4eebe69ad8">sp_playlistcontainer_add_playlist</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, <a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *link)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga1ae1d51c4305940ae5c5c98c12be0afc">sp_playlistcontainer_remove_playlist</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gad9be708159957d4c1e5ef905550808c5">sp_playlistcontainer_move_playlist</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, int index, int new_position, bool dry_run)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga0862502eea52fc5f2465ebad6fd98796">sp_playlistcontainer_add_folder</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, int index, const char *name)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gad4fc67d1386dd637f778f4e735a36894">sp_playlistcontainer_owner</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga2138c537a6ebcd35a01eea54d0dd1e8f">sp_playlistcontainer_add_ref</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#ga0311c7c3c4f26028e5edd4aacb36dbf8">sp_playlistcontainer_release</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gad9e11b45843ee4a147b43038a2e55f13">sp_playlistcontainer_get_unseen_tracks</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> **tracks, int num_tracks)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__playlist.html#gadaad604c35e543363e1dd5b23c462db0">sp_playlistcontainer_clear_unseen_tracks</a> (<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist)</td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>The playlist subsystem handles playlists and playlist containers (list of playlists).</p>
<p>The playlist container functions are always valid, but your playlists are not guaranteed to be loaded until the <a class="el" href="structsp__session__callbacks.html#a52d509962541f7d8fdd71284f40d8415">sp_session_callbacks::logged_in</a> callback has been issued. </p>
<hr/><h2>Typedef Documentation</h2>
<a class="anchor" id="ga8249fe3d53c6dce0f154d0bfd3e80c6a"></a><!-- doxytag: member="api.h::sp_playlist_callbacks" ref="ga8249fe3d53c6dce0f154d0bfd3e80c6a" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef struct <a class="el" href="structsp__playlist__callbacks.html">sp_playlist_callbacks</a>  <a class="el" href="structsp__playlist__callbacks.html">sp_playlist_callbacks</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Playlist callbacks</p>
<p>Used to get notifications when playlists are updated. If some callbacks should not be of interest, set them to NULL. </p>

</div>
</div>
<a class="anchor" id="ga8786e3840bb3774fc929183e3a9df281"></a><!-- doxytag: member="api.h::sp_playlistcontainer_callbacks" ref="ga8786e3840bb3774fc929183e3a9df281" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef struct <a class="el" href="structsp__playlistcontainer__callbacks.html">sp_playlistcontainer_callbacks</a>  <a class="el" href="structsp__playlistcontainer__callbacks.html">sp_playlistcontainer_callbacks</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Playlist container callbacks. If some callbacks should not be of interest, set them to NULL.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__playlist.html#ga1976cb49c391cdd2dbe7c40d1bc71570">sp_playlistcontainer_add_callbacks</a> </dd>
<dd>
<a class="el" href="group__playlist.html#gafb5242b8f0f9964cec29d32f4d6c1164">sp_playlistcontainer_remove_callbacks</a> </dd></dl>

</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="gab15fca12d387c69b4998a4d2b48e5b32"></a><!-- doxytag: member="api.h::sp_playlist_add_callbacks" ref="gab15fca12d387c69b4998a4d2b48e5b32" args="(sp_playlist *playlist, sp_playlist_callbacks *callbacks, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlist_add_callbacks </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="structsp__playlist__callbacks.html">sp_playlist_callbacks</a> *&nbsp;</td>
          <td class="paramname"> <em>callbacks</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">void *&nbsp;</td>
          <td class="paramname"> <em>userdata</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Register interest in the given playlist</p>
<p>Here is a snippet from <code>jukebox.c:</code>  <div class="fragment"><pre class="fragment">    <a class="code" href="group__playlist.html#gab15fca12d387c69b4998a4d2b48e5b32">sp_playlist_add_callbacks</a>(pl, &amp;pl_callbacks, NULL);
</pre></div></p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>callbacks</em>&nbsp;</td><td>Callbacks, see <a class="el" href="structsp__playlist__callbacks.html">sp_playlist_callbacks</a> </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata to be passed to callbacks </td></tr>
  </table>
  </dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__playlist.html#ga7fcbf909a0fa8bf25f0b1d1e7dd0e160">sp_playlist_remove_callbacks</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a44">browse.c</a>, and <a class="el" href="jukebox_8c-example.html#a10">jukebox.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gacb10979add5a954e5c1600ef9c5b17a8"></a><!-- doxytag: member="api.h::sp_playlist_add_ref" ref="gacb10979add5a954e5c1600ef9c5b17a8" args="(sp_playlist *playlist)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlist_add_ref </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Increase the reference count of a playlist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>The playlist object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="ga2344a47133f7f0aed0a67e154ecc4dc4"></a><!-- doxytag: member="api.h::sp_playlist_add_tracks" ref="ga2344a47133f7f0aed0a67e154ecc4dc4" args="(sp_playlist *playlist, sp_track *const *tracks, int num_tracks, int position, sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlist_add_tracks </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *const *&nbsp;</td>
          <td class="paramname"> <em>tracks</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>num_tracks</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>position</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Add tracks to a playlist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>tracks</em>&nbsp;</td><td>Array of pointer to tracks. </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>num_tracks</em>&nbsp;</td><td>Length of <code>tracks</code> array </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>position</em>&nbsp;</td><td>Start position in playlist where to insert the tracks </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Your session object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_INVALID_INDATA - position is &gt; current playlist length SP_ERROR_PERMISSION_DENIED </dd></dl>

</div>
</div>
<a class="anchor" id="ga342a6a0cfe10531ef7cb3c6629c1e8e7"></a><!-- doxytag: member="api.h::sp_playlist_create" ref="ga342a6a0cfe10531ef7cb3c6629c1e8e7" args="(sp_session *session, sp_link *link)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a>* sp_playlist_create </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td>
          <td class="paramname"> <em>link</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Load an already existing playlist without adding it to a playlistcontainer.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>link</em>&nbsp;</td><td>Link object referring to a playlist</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A playlist. The reference is owned by the caller and should be released with <a class="el" href="group__playlist.html#gacb9250eb530869b039541a8b62dfab6c">sp_playlist_release()</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a59">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gab1d8e0ee9b436ecbb104bbd6cc0665be"></a><!-- doxytag: member="api.h::sp_playlist_get_description" ref="gab1d8e0ee9b436ecbb104bbd6cc0665be" args="(sp_playlist *playlist)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* sp_playlist_get_description </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Get description for a playlist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Playlist description or NULL if unset </dd></dl>

</div>
</div>
<a class="anchor" id="ga409cb6b2a88db7242ec939b6644e8c30"></a><!-- doxytag: member="api.h::sp_playlist_get_image" ref="ga409cb6b2a88db7242ec939b6644e8c30" args="(sp_playlist *playlist, byte image[20])" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_playlist_get_image </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">byte&nbsp;</td>
          <td class="paramname"> <em>image</em>[20]</td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Get description for a playlist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[out]</tt>&nbsp;</td><td valign="top"><em>image</em>&nbsp;</td><td>20 byte image id</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>TRUE if playlist has an image, FALSE if not </dd></dl>

</div>
</div>
<a class="anchor" id="ga83ca1a25f50834f8e6f8ee1e883a8c6e"></a><!-- doxytag: member="api.h::sp_playlist_get_offline_download_completed" ref="ga83ca1a25f50834f8e6f8ee1e883a8c6e" args="(sp_session *session, sp_playlist *playlist)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_playlist_get_offline_download_completed </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Get download progress for an offline playlist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Value from 0 - 100 that indicates amount of playlist that is downloaded or 0 if the playlist is not in the SP_PLAYLIST_OFFLINE_STATUS_DOWNLOADING mode.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__session.html#ga811fa52ed0fdb5cda732682e27e40417">sp_playlist_offline_status()</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga7170157af21445c37a21a2241f91ff06"></a><!-- doxytag: member="api.h::sp_playlist_get_offline_status" ref="ga7170157af21445c37a21a2241f91ff06" args="(sp_session *session, sp_playlist *playlist)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__session.html#ga811fa52ed0fdb5cda732682e27e40417">sp_playlist_offline_status</a> sp_playlist_get_offline_status </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Get offline status for a playlist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>sp_playlist_offline_status</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd>When in <a class="el" href="group__session.html#gga811fa52ed0fdb5cda732682e27e40417abc999c70761d392b26753708e9a2cfa1" title="This playlist is currently downloading. Only one playlist can be in this state any given time...">SP_PLAYLIST_OFFLINE_STATUS_DOWNLOADING</a> mode the <a class="el" href="group__playlist.html#ga83ca1a25f50834f8e6f8ee1e883a8c6e">sp_playlist_get_offline_download_completed()</a> method can be used to query progress of the download </dd></dl>

</div>
</div>
<a class="anchor" id="gaf0e39b5969259d10625eb398af0f3f43"></a><!-- doxytag: member="api.h::sp_playlist_has_pending_changes" ref="gaf0e39b5969259d10625eb398af0f3f43" args="(sp_playlist *playlist)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_playlist_has_pending_changes </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Check if a playlist has pending changes</p>
<p>Pending changes are local changes that have not yet been acknowledged by the server.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A flag representing if there are pending changes or not </dd></dl>

</div>
</div>
<a class="anchor" id="ga8ad160f654f02f13690568070dd57353"></a><!-- doxytag: member="api.h::sp_playlist_is_collaborative" ref="ga8ad160f654f02f13690568070dd57353" args="(sp_playlist *playlist)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_playlist_is_collaborative </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return collaborative status for a playlist.</p>
<p>A playlist in collaborative state can be modifed by all users, not only the user owning the list</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if playlist is collaborative, otherwise false </dd></dl>

</div>
</div>
<a class="anchor" id="ga28456d1242693c6d890516dc782ab3ec"></a><!-- doxytag: member="api.h::sp_playlist_is_in_ram" ref="ga28456d1242693c6d890516dc782ab3ec" args="(sp_session *session, sp_playlist *playlist)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_playlist_is_in_ram </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return whether a playlist is loaded in RAM (as opposed to only stored on disk)</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>True iff playlist is in RAM, False otherwise</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>When a playlist is no longer in RAM it will appear empty. However, libspotify will retain information about the list metadata (owner, title, picture, etc) in RAM. There is one caveat tough: If libspotify has never seen the playlist before this metadata will also be unset. In order for libspotify to get the metadata the playlist needs to be loaded at least once. In order words, if libspotify starts with an empty playlist cache and the application has set 'initially_unload_playlists' config parameter to True all playlists will be empty. It will not be possible to generate URI's to the playlists nor extract playlist title until the application calls sp_playlist_set_in_ram(..., true). So an application that needs to stay within a low memory profile would need to cycle thru all new playlists in order to extract metadata.</dd></dl>
<p>The easiest way to detect this case is when <a class="el" href="group__playlist.html#ga28456d1242693c6d890516dc782ab3ec">sp_playlist_is_in_ram()</a> returns false and <a class="el" href="group__link.html#ga805392bfa8e526eebedc1cf5a7bcae0f">sp_link_create_from_playlist()</a> returns NULL </p>

</div>
</div>
<a class="anchor" id="gaee8ea6c07dfdca3397e27b278fa4870a"></a><!-- doxytag: member="api.h::sp_playlist_is_loaded" ref="gaee8ea6c07dfdca3397e27b278fa4870a" args="(sp_playlist *playlist)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_playlist_is_loaded </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Get load status for the specified playlist. If it's false, you have to wait until playlist_state_changed happens, and check again if is_loaded has changed</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>True if playlist is loaded, otherwise false </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a37">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga61b7e33cc1aedb4e31a2af75ae0ac8cc"></a><!-- doxytag: member="api.h::sp_playlist_name" ref="ga61b7e33cc1aedb4e31a2af75ae0ac8cc" args="(sp_playlist *playlist)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* sp_playlist_name </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return name of given playlist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The name of the given playlist </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a43">browse.c</a>, and <a class="el" href="jukebox_8c-example.html#a8">jukebox.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga967ad87f0db702513ecda82546f667c5"></a><!-- doxytag: member="api.h::sp_playlist_num_subscribers" ref="ga967ad87f0db702513ecda82546f667c5" args="(sp_playlist *playlist)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">unsigned int sp_playlist_num_subscribers </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return number of subscribers for a given playlist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of subscribers </dd></dl>

</div>
</div>
<a class="anchor" id="ga684a3acc60f99b3b26488ed813ee5d23"></a><!-- doxytag: member="api.h::sp_playlist_num_tracks" ref="ga684a3acc60f99b3b26488ed813ee5d23" args="(sp_playlist *playlist)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_playlist_num_tracks </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return number of tracks in the given playlist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The number of tracks in the playlist </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a38">browse.c</a>, and <a class="el" href="jukebox_8c-example.html#a0">jukebox.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gac3e4295d3353eb9998402aedfdbd55de"></a><!-- doxytag: member="api.h::sp_playlist_owner" ref="gac3e4295d3353eb9998402aedfdbd55de" args="(sp_playlist *playlist)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a>* sp_playlist_owner </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return a pointer to the user for the given playlist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>User object </dd></dl>

</div>
</div>
<a class="anchor" id="gacb9250eb530869b039541a8b62dfab6c"></a><!-- doxytag: member="api.h::sp_playlist_release" ref="gacb9250eb530869b039541a8b62dfab6c" args="(sp_playlist *playlist)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlist_release </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Decrease the reference count of a playlist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>The playlist object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a42">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga7fcbf909a0fa8bf25f0b1d1e7dd0e160"></a><!-- doxytag: member="api.h::sp_playlist_remove_callbacks" ref="ga7fcbf909a0fa8bf25f0b1d1e7dd0e160" args="(sp_playlist *playlist, sp_playlist_callbacks *callbacks, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlist_remove_callbacks </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="structsp__playlist__callbacks.html">sp_playlist_callbacks</a> *&nbsp;</td>
          <td class="paramname"> <em>callbacks</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">void *&nbsp;</td>
          <td class="paramname"> <em>userdata</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Unregister interest in the given playlist</p>
<p>The combination of (<code>callbacks</code>, <code>userdata</code>) is used to find the entry to be removed</p>
<p>Here is a snippet from <code>jukebox.c:</code>  <div class="fragment"><pre class="fragment">    <a class="code" href="group__playlist.html#ga7fcbf909a0fa8bf25f0b1d1e7dd0e160">sp_playlist_remove_callbacks</a>(pl, &amp;pl_callbacks, NULL);
</pre></div></p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>callbacks</em>&nbsp;</td><td>Callbacks, see <a class="el" href="structsp__playlist__callbacks.html">sp_playlist_callbacks</a> </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata to be passed to callbacks </td></tr>
  </table>
  </dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__playlist.html#gab15fca12d387c69b4998a4d2b48e5b32">sp_playlist_add_callbacks</a> </dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a41">browse.c</a>, and <a class="el" href="jukebox_8c-example.html#a11">jukebox.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gabd62cd7ff9484b4c31ff7f159ec41b6a"></a><!-- doxytag: member="api.h::sp_playlist_remove_tracks" ref="gabd62cd7ff9484b4c31ff7f159ec41b6a" args="(sp_playlist *playlist, const int *tracks, int num_tracks)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlist_remove_tracks </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const int *&nbsp;</td>
          <td class="paramname"> <em>tracks</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>num_tracks</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Remove tracks from a playlist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>tracks</em>&nbsp;</td><td>Array of pointer to track indices. A certain track index should be present at most once, e.g. [0, 1, 2] is valid indata, whereas [0, 1, 1] is invalid. </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>num_tracks</em>&nbsp;</td><td>Length of <code>tracks</code> array</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_PERMISSION_DENIED </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="jukebox_8c-example.html#a23">jukebox.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gad6c3880c514353e204fdd90830b516ec"></a><!-- doxytag: member="api.h::sp_playlist_rename" ref="gad6c3880c514353e204fdd90830b516ec" args="(sp_playlist *playlist, const char *new_name)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlist_rename </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>new_name</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Rename the given playlist The name must not consist of only spaces and it must be shorter than 256 characters.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>new_name</em>&nbsp;</td><td>New name for playlist</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_INVALID_INDATA SP_ERROR_PERMISSION_DENIED </dd></dl>

</div>
</div>
<a class="anchor" id="ga90ffd8c9fc6abc7375e89f4cb49adb11"></a><!-- doxytag: member="api.h::sp_playlist_reorder_tracks" ref="ga90ffd8c9fc6abc7375e89f4cb49adb11" args="(sp_playlist *playlist, const int *tracks, int num_tracks, int new_position)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlist_reorder_tracks </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const int *&nbsp;</td>
          <td class="paramname"> <em>tracks</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>num_tracks</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>new_position</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Move tracks in playlist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>tracks</em>&nbsp;</td><td>Array of pointer to track indices to be moved. A certain track index should be present at most once, e.g. [0, 1, 2] is valid indata, whereas [0, 1, 1] is invalid. </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>num_tracks</em>&nbsp;</td><td>Length of <code>tracks</code> array </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>new_position</em>&nbsp;</td><td>New position for tracks</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_INVALID_INDATA - position is &gt; current playlist length SP_ERROR_PERMISSION_DENIED </dd></dl>

</div>
</div>
<a class="anchor" id="ga0bde47f340e0cd590a78007c6af69307"></a><!-- doxytag: member="api.h::sp_playlist_set_autolink_tracks" ref="ga0bde47f340e0cd590a78007c6af69307" args="(sp_playlist *playlist, bool link)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlist_set_autolink_tracks </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">bool&nbsp;</td>
          <td class="paramname"> <em>link</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Set autolinking state for a playlist.</p>
<p>If a playlist is autolinked, unplayable tracks will be made playable by linking them to other Spotify tracks, where possible.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>link</em>&nbsp;</td><td>True or false </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="gad15410bcc2ebd986adabda865830bce4"></a><!-- doxytag: member="api.h::sp_playlist_set_collaborative" ref="gad15410bcc2ebd986adabda865830bce4" args="(sp_playlist *playlist, bool collaborative)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlist_set_collaborative </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">bool&nbsp;</td>
          <td class="paramname"> <em>collaborative</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Set collaborative status for a playlist.</p>
<p>A playlist in collaborative state can be modified by all users, not only the user owning the list</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>collaborative</em>&nbsp;</td><td>True or false </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="gaf6ca8a349bdd982f6c8dda52ed691017"></a><!-- doxytag: member="api.h::sp_playlist_set_in_ram" ref="gaf6ca8a349bdd982f6c8dda52ed691017" args="(sp_session *session, sp_playlist *playlist, bool in_ram)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlist_set_in_ram </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">bool&nbsp;</td>
          <td class="paramname"> <em>in_ram</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return whether a playlist is loaded in RAM (as opposed to only stored on disk)</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>in_ram</em>&nbsp;</td><td>Controls whether or not to keep the list in RAM </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="ga784f648f9cc431ef3b51f3491c2f169f"></a><!-- doxytag: member="api.h::sp_playlist_set_offline_mode" ref="ga784f648f9cc431ef3b51f3491c2f169f" args="(sp_session *session, sp_playlist *playlist, bool offline)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlist_set_offline_mode </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">bool&nbsp;</td>
          <td class="paramname"> <em>offline</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Mark a playlist to be synchronized for offline playback. The playlist must be in the users playlistcontainer</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>offline</em>&nbsp;</td><td>True iff playlist should be offline, false otherwise </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="gad49f491babc475f8d4aeea1b4452ff8b"></a><!-- doxytag: member="api.h::sp_playlist_subscribers" ref="gad49f491babc475f8d4aeea1b4452ff8b" args="(sp_playlist *playlist)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="structsp__subscribers.html">sp_subscribers</a>* sp_playlist_subscribers </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return subscribers for a playlist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><a class="el" href="structsp__subscribers.html">sp_subscribers</a> struct with array of canonical usernames. This object should be free'd using <a class="el" href="group__playlist.html#gae7754b74b1c3c8f5222ca43b6608ce6a">sp_playlist_subscribers_free()</a></dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>The count returned for this function may be less than those returned by <a class="el" href="group__playlist.html#ga967ad87f0db702513ecda82546f667c5">sp_playlist_num_subscribers()</a>. Spotify does not track each user subscribed to a playlist for playlist with many (&gt;500) subscribers. </dd></dl>

</div>
</div>
<a class="anchor" id="gae7754b74b1c3c8f5222ca43b6608ce6a"></a><!-- doxytag: member="api.h::sp_playlist_subscribers_free" ref="gae7754b74b1c3c8f5222ca43b6608ce6a" args="(sp_subscribers *subscribers)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlist_subscribers_free </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structsp__subscribers.html">sp_subscribers</a> *&nbsp;</td>
          <td class="paramname"> <em>subscribers</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Free object returned from <a class="el" href="group__playlist.html#gad49f491babc475f8d4aeea1b4452ff8b">sp_playlist_subscribers()</a></p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>subscribers</em>&nbsp;</td><td>Subscribers object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="ga7a03854fe6072476306780d23c6cac16"></a><!-- doxytag: member="api.h::sp_playlist_track" ref="ga7a03854fe6072476306780d23c6cac16" args="(sp_playlist *playlist, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a>* sp_playlist_track </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the track at the given index in a playlist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Index into playlist container. Should be in the interval [0, <a class="el" href="group__playlist.html#ga684a3acc60f99b3b26488ed813ee5d23">sp_playlist_num_tracks()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The track at the given index </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a39">browse.c</a>, and <a class="el" href="jukebox_8c-example.html#a1">jukebox.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gab8e77f8d63e787f8aa1a066d74daa74c"></a><!-- doxytag: member="api.h::sp_playlist_track_create_time" ref="gab8e77f8d63e787f8aa1a066d74daa74c" args="(sp_playlist *playlist, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_playlist_track_create_time </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return when the given index was added to the playlist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Index into playlist container. Should be in the interval [0, <a class="el" href="group__playlist.html#ga684a3acc60f99b3b26488ed813ee5d23">sp_playlist_num_tracks()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Time, Seconds since unix epoch. </dd></dl>

</div>
</div>
<a class="anchor" id="ga80fcd9e7b40c791433c07d66e2ad432a"></a><!-- doxytag: member="api.h::sp_playlist_track_creator" ref="ga80fcd9e7b40c791433c07d66e2ad432a" args="(sp_playlist *playlist, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a>* sp_playlist_track_creator </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return user that added the given index in the playlist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Index into playlist container. Should be in the interval [0, <a class="el" href="group__playlist.html#ga684a3acc60f99b3b26488ed813ee5d23">sp_playlist_num_tracks()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>User object </dd></dl>

</div>
</div>
<a class="anchor" id="ga6887b9dabb30a060b10bdb75f8b3f971"></a><!-- doxytag: member="api.h::sp_playlist_track_message" ref="ga6887b9dabb30a060b10bdb75f8b3f971" args="(sp_playlist *playlist, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* sp_playlist_track_message </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return a message attached to a playlist item. Typically used on inbox.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Index into playlist container. Should be in the interval [0, <a class="el" href="group__playlist.html#ga684a3acc60f99b3b26488ed813ee5d23">sp_playlist_num_tracks()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>UTF-8 encoded message, or NULL if no message is present </dd></dl>

</div>
</div>
<a class="anchor" id="gab9e00ee5bc6b5dc0b3d58cbdb32c0c7b"></a><!-- doxytag: member="api.h::sp_playlist_track_seen" ref="gab9e00ee5bc6b5dc0b3d58cbdb32c0c7b" args="(sp_playlist *playlist, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_playlist_track_seen </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return if a playlist entry is marked as seen or not</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Index into playlist container. Should be in the interval [0, <a class="el" href="group__playlist.html#ga684a3acc60f99b3b26488ed813ee5d23">sp_playlist_num_tracks()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Seen state </dd></dl>

</div>
</div>
<a class="anchor" id="ga69f5cc1bdd7dbdcdb476a7b1d2b7834d"></a><!-- doxytag: member="api.h::sp_playlist_track_set_seen" ref="ga69f5cc1bdd7dbdcdb476a7b1d2b7834d" args="(sp_playlist *playlist, int index, bool seen)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlist_track_set_seen </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">bool&nbsp;</td>
          <td class="paramname"> <em>seen</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Set seen status of a playlist entry</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Index into playlist container. Should be in the interval [0, <a class="el" href="group__playlist.html#ga684a3acc60f99b3b26488ed813ee5d23">sp_playlist_num_tracks()</a> - 1] </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>seen</em>&nbsp;</td><td>Seen status to be set</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>error One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_INDEX_OUT_OF_RANGE </dd></dl>

</div>
</div>
<a class="anchor" id="ga9ebbf147230b3ca98b68e556cf24e6bd"></a><!-- doxytag: member="api.h::sp_playlist_update_subscribers" ref="ga9ebbf147230b3ca98b68e556cf24e6bd" args="(sp_session *session, sp_playlist *playlist)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlist_update_subscribers </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Ask library to update the subscription count for a playlist</p>
<p>When the subscription info has been fetched from the Spotify backend the playlist subscribers_changed() callback will be invoked. In that callback use <a class="el" href="group__playlist.html#ga967ad87f0db702513ecda82546f667c5">sp_playlist_num_subscribers()</a> and/or <a class="el" href="group__playlist.html#gad49f491babc475f8d4aeea1b4452ff8b">sp_playlist_subscribers()</a> to get information about the subscribers. You can call those two functions anytime you want but the information might not be up to date in such cases</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="ga1976cb49c391cdd2dbe7c40d1bc71570"></a><!-- doxytag: member="api.h::sp_playlistcontainer_add_callbacks" ref="ga1976cb49c391cdd2dbe7c40d1bc71570" args="(sp_playlistcontainer *pc, sp_playlistcontainer_callbacks *callbacks, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlistcontainer_add_callbacks </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *&nbsp;</td>
          <td class="paramname"> <em>pc</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="structsp__playlistcontainer__callbacks.html">sp_playlistcontainer_callbacks</a> *&nbsp;</td>
          <td class="paramname"> <em>callbacks</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">void *&nbsp;</td>
          <td class="paramname"> <em>userdata</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Register interest in changes to a playlist container</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pc</em>&nbsp;</td><td>Playlist container </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>callbacks</em>&nbsp;</td><td>Callbacks, see <a class="el" href="structsp__playlistcontainer__callbacks.html">sp_playlistcontainer_callbacks</a> </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Opaque value passed to callbacks.</td></tr>
  </table>
  </dd>
</dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Every <a class="el" href="group__playlist.html#ga1976cb49c391cdd2dbe7c40d1bc71570">sp_playlistcontainer_add_callbacks()</a> needs to be paired with a corresponding <a class="el" href="group__playlist.html#gafb5242b8f0f9964cec29d32f4d6c1164">sp_playlistcontainer_remove_callbacks()</a> that is invoked before releasing the last reference you own for the container. In other words, you must make sure to have removed all the callbacks before the container gets destroyed.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__session.html#ga319767f0b795f1c46a08390b587c5671">sp_session_playlistcontainer()</a> </dd>
<dd>
<a class="el" href="group__playlist.html#gafb5242b8f0f9964cec29d32f4d6c1164">sp_playlistcontainer_remove_callbacks</a> </dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="jukebox_8c-example.html#a16">jukebox.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga0862502eea52fc5f2465ebad6fd98796"></a><!-- doxytag: member="api.h::sp_playlistcontainer_add_folder" ref="ga0862502eea52fc5f2465ebad6fd98796" args="(sp_playlistcontainer *pc, int index, const char *name)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlistcontainer_add_folder </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *&nbsp;</td>
          <td class="paramname"> <em>pc</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>name</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Add a playlist folder</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pc</em>&nbsp;</td><td>Playlist container </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Position of SP_PLAYLIST_TYPE_START_FOLDER entry </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>name</em>&nbsp;</td><td>Name of group</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>error One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_INDEX_OUT_OF_RANGE</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>This operation will actually create two playlists. One of type SP_PLAYLIST_TYPE_START_FOLDER and immediately following a SP_PLAYLIST_TYPE_END_FOLDER one.</dd></dl>
<p>To remove a playlist folder both of these must be deleted or the list will be left in an inconsistant state.</p>
<p>There is no way to rename a playlist folder. Instead you need to remove the folder and recreate it again. </p>

</div>
</div>
<a class="anchor" id="ga840b82b1074a7ca1c9eacd351bed24c2"></a><!-- doxytag: member="api.h::sp_playlistcontainer_add_new_playlist" ref="ga840b82b1074a7ca1c9eacd351bed24c2" args="(sp_playlistcontainer *pc, const char *name)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a>* sp_playlistcontainer_add_new_playlist </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *&nbsp;</td>
          <td class="paramname"> <em>pc</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>name</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Add an empty playlist at the end of the playlist container. The name must not consist of only spaces and it must be shorter than 256 characters.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pc</em>&nbsp;</td><td>Playlist container </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>name</em>&nbsp;</td><td>Name of new playlist</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Pointer to the new playlist. Can be NULL if the operation fails. </dd></dl>

</div>
</div>
<a class="anchor" id="ga87699479087915b741ceef4eebe69ad8"></a><!-- doxytag: member="api.h::sp_playlistcontainer_add_playlist" ref="ga87699479087915b741ceef4eebe69ad8" args="(sp_playlistcontainer *pc, sp_link *link)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a>* sp_playlistcontainer_add_playlist </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *&nbsp;</td>
          <td class="paramname"> <em>pc</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a> *&nbsp;</td>
          <td class="paramname"> <em>link</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Add an existing playlist at the end of the given playlist container</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pc</em>&nbsp;</td><td>Playlist container </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>link</em>&nbsp;</td><td>Link object pointing to a playlist</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Pointer to the new playlist. Will be NULL if the playlist already exists. </dd></dl>

</div>
</div>
<a class="anchor" id="ga2138c537a6ebcd35a01eea54d0dd1e8f"></a><!-- doxytag: member="api.h::sp_playlistcontainer_add_ref" ref="ga2138c537a6ebcd35a01eea54d0dd1e8f" args="(sp_playlistcontainer *pc)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlistcontainer_add_ref </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *&nbsp;</td>
          <td class="paramname"> <em>pc</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Increase reference count on playlistconatiner object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pc</em>&nbsp;</td><td>Playlist container. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="gadaad604c35e543363e1dd5b23c462db0"></a><!-- doxytag: member="api.h::sp_playlistcontainer_clear_unseen_tracks" ref="gadaad604c35e543363e1dd5b23c462db0" args="(sp_playlistcontainer *pc, sp_playlist *playlist)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_playlistcontainer_clear_unseen_tracks </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *&nbsp;</td>
          <td class="paramname"> <em>pc</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Clears a playlist from unseen tracks, so that next call to <a class="el" href="group__playlist.html#gad9e11b45843ee4a147b43038a2e55f13">sp_playlistcontainer_get_unseen_tracks()</a> will return 0 until a new track is added to the <code>playslist</code>.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pc</em>&nbsp;</td><td>Playlist container. </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Returns 0 on success and -1 on failure. </dd></dl>

</div>
</div>
<a class="anchor" id="gad9e11b45843ee4a147b43038a2e55f13"></a><!-- doxytag: member="api.h::sp_playlistcontainer_get_unseen_tracks" ref="gad9e11b45843ee4a147b43038a2e55f13" args="(sp_playlistcontainer *pc, sp_playlist *playlist, sp_track **tracks, int num_tracks)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_playlistcontainer_get_unseen_tracks </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *&nbsp;</td>
          <td class="paramname"> <em>pc</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td>
          <td class="paramname"> <em>playlist</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> **&nbsp;</td>
          <td class="paramname"> <em>tracks</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>num_tracks</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Get the number of new tracks in a playlist since the corresponding function <a class="el" href="group__playlist.html#gadaad604c35e543363e1dd5b23c462db0">sp_playlistcontainer_clear_unseen_tracks()</a> was called. The function always returns the number of new tracks, and fills the <code>tracks</code> array with the new tracks, but not more than specified in <code>num_tracks</code>. The function will return a negative value on failure.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pc</em>&nbsp;</td><td>Playlist container. </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object. </td></tr>
    <tr><td valign="top"><tt>[out]</tt>&nbsp;</td><td valign="top"><em>tracks</em>&nbsp;</td><td>Array of pointer to new tracks (maybe NULL) </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>num_tracks</em>&nbsp;</td><td>Size of tracks array </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Returns the number of unseen tracks </dd></dl>

</div>
</div>
<a class="anchor" id="gae23cb67b4b26bca663034997c4418fa8"></a><!-- doxytag: member="api.h::sp_playlistcontainer_is_loaded" ref="gae23cb67b4b26bca663034997c4418fa8" args="(sp_playlistcontainer *pc)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_playlistcontainer_is_loaded </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *&nbsp;</td>
          <td class="paramname"> <em>pc</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return true if the playlistcontainer is fully loaded</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pc</em>&nbsp;</td><td>Playlist container</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>True if container is loaded</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>The container_loaded callback will be invoked when this flips to true </dd></dl>

</div>
</div>
<a class="anchor" id="gad9be708159957d4c1e5ef905550808c5"></a><!-- doxytag: member="api.h::sp_playlistcontainer_move_playlist" ref="gad9be708159957d4c1e5ef905550808c5" args="(sp_playlistcontainer *pc, int index, int new_position, bool dry_run)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlistcontainer_move_playlist </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *&nbsp;</td>
          <td class="paramname"> <em>pc</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>new_position</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">bool&nbsp;</td>
          <td class="paramname"> <em>dry_run</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Move a playlist in the playlist container</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pc</em>&nbsp;</td><td>Playlist container </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Index of playlist to be moved </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>new_position</em>&nbsp;</td><td>New position for the playlist </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>dry_run</em>&nbsp;</td><td>Do not execute the move, only check if it possible</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>error One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_INDEX_OUT_OF_RANGE SP_ERROR_INVALID_INDATA - If trying to move a folder into itself </dd></dl>

</div>
</div>
<a class="anchor" id="ga7a1cbf558b2b364b8249d4ce432df700"></a><!-- doxytag: member="api.h::sp_playlistcontainer_num_playlists" ref="ga7a1cbf558b2b364b8249d4ce432df700" args="(sp_playlistcontainer *pc)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_playlistcontainer_num_playlists </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *&nbsp;</td>
          <td class="paramname"> <em>pc</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the number of playlists in the given playlist container</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pc</em>&nbsp;</td><td>Playlist container</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of playlists, -1 if undefined</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__session.html#ga319767f0b795f1c46a08390b587c5671">sp_session_playlistcontainer()</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="jukebox_8c-example.html#a12">jukebox.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gad4fc67d1386dd637f778f4e735a36894"></a><!-- doxytag: member="api.h::sp_playlistcontainer_owner" ref="gad4fc67d1386dd637f778f4e735a36894" args="(sp_playlistcontainer *pc)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a>* sp_playlistcontainer_owner </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *&nbsp;</td>
          <td class="paramname"> <em>pc</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return a pointer to the user object of the owner.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pc</em>&nbsp;</td><td>Playlist container. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The user object or NULL if unknown or none. </dd></dl>

</div>
</div>
<a class="anchor" id="ga5ddd8c8064c281a14c6fd7877f522dc6"></a><!-- doxytag: member="api.h::sp_playlistcontainer_playlist" ref="ga5ddd8c8064c281a14c6fd7877f522dc6" args="(sp_playlistcontainer *pc, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a>* sp_playlistcontainer_playlist </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *&nbsp;</td>
          <td class="paramname"> <em>pc</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return a pointer to the playlist at a specific index</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pc</em>&nbsp;</td><td>Playlist container </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Index in playlist container. Should be in the interval [0, <a class="el" href="group__playlist.html#ga7a1cbf558b2b364b8249d4ce432df700">sp_playlistcontainer_num_playlists()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The playlist object</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__session.html#ga319767f0b795f1c46a08390b587c5671">sp_session_playlistcontainer()</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="jukebox_8c-example.html#a17">jukebox.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga6939f9db71199612fc5a19d395e3a7f8"></a><!-- doxytag: member="api.h::sp_playlistcontainer_playlist_folder_id" ref="ga6939f9db71199612fc5a19d395e3a7f8" args="(sp_playlistcontainer *pc, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">sp_uint64 sp_playlistcontainer_playlist_folder_id </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *&nbsp;</td>
          <td class="paramname"> <em>pc</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the folder id at <em>index</em> </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pc</em>&nbsp;</td><td>Playlist container </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Index in playlist container. Should be in the interval [0, <a class="el" href="group__playlist.html#ga7a1cbf558b2b364b8249d4ce432df700">sp_playlistcontainer_num_playlists()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The group ID of the folder. Returns 0 on index out of range, pc being NULL or indexed item not being a folder</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__session.html#ga319767f0b795f1c46a08390b587c5671">sp_session_playlistcontainer()</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga852e5f5bcd4520be2e3d6d5d94def44a"></a><!-- doxytag: member="api.h::sp_playlistcontainer_playlist_folder_name" ref="ga852e5f5bcd4520be2e3d6d5d94def44a" args="(sp_playlistcontainer *pc, int index, char *buffer, int buffer_size)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlistcontainer_playlist_folder_name </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *&nbsp;</td>
          <td class="paramname"> <em>pc</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">char *&nbsp;</td>
          <td class="paramname"> <em>buffer</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>buffer_size</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the folder name at <em>index</em> </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pc</em>&nbsp;</td><td>Playlist container </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Index in playlist container. Should be in the interval [0, <a class="el" href="group__playlist.html#ga7a1cbf558b2b364b8249d4ce432df700">sp_playlistcontainer_num_playlists()</a> - 1]. Index should point at a start-folder entry, otherwise the empty string is written to buffer. </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>buffer</em>&nbsp;</td><td>Pointer to char[] where to store folder name </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>buffer_size</em>&nbsp;</td><td>Size of array</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_INDEX_OUT_OF_RANGE</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__session.html#ga319767f0b795f1c46a08390b587c5671">sp_session_playlistcontainer()</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga79286860a3eeada495e97c5ad1fd7ebf"></a><!-- doxytag: member="api.h::sp_playlistcontainer_playlist_type" ref="ga79286860a3eeada495e97c5ad1fd7ebf" args="(sp_playlistcontainer *pc, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__session.html#gafdd7117213605e6f2671c4f289b44609">sp_playlist_type</a> sp_playlistcontainer_playlist_type </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *&nbsp;</td>
          <td class="paramname"> <em>pc</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the type of the playlist at a <em>index</em> </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pc</em>&nbsp;</td><td>Playlist container </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Index in playlist container. Should be in the interval [0, <a class="el" href="group__playlist.html#ga7a1cbf558b2b364b8249d4ce432df700">sp_playlistcontainer_num_playlists()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Type of the playlist, </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__session.html#ga86723f553db2db6a8f507cd748948ad4">sp_playlist_type</a></dd>
<dd>
<a class="el" href="group__session.html#ga319767f0b795f1c46a08390b587c5671">sp_session_playlistcontainer()</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga0311c7c3c4f26028e5edd4aacb36dbf8"></a><!-- doxytag: member="api.h::sp_playlistcontainer_release" ref="ga0311c7c3c4f26028e5edd4aacb36dbf8" args="(sp_playlistcontainer *pc)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlistcontainer_release </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *&nbsp;</td>
          <td class="paramname"> <em>pc</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Release reference count on playlistconatiner object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pc</em>&nbsp;</td><td>Playlist container. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="gafb5242b8f0f9964cec29d32f4d6c1164"></a><!-- doxytag: member="api.h::sp_playlistcontainer_remove_callbacks" ref="gafb5242b8f0f9964cec29d32f4d6c1164" args="(sp_playlistcontainer *pc, sp_playlistcontainer_callbacks *callbacks, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlistcontainer_remove_callbacks </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *&nbsp;</td>
          <td class="paramname"> <em>pc</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="structsp__playlistcontainer__callbacks.html">sp_playlistcontainer_callbacks</a> *&nbsp;</td>
          <td class="paramname"> <em>callbacks</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">void *&nbsp;</td>
          <td class="paramname"> <em>userdata</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Unregister interest in changes to a playlist container</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pc</em>&nbsp;</td><td>Playlist container </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>callbacks</em>&nbsp;</td><td>Callbacks, see <a class="el" href="structsp__playlistcontainer__callbacks.html">sp_playlistcontainer_callbacks</a> </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Opaque value passed to callbacks.</td></tr>
  </table>
  </dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__session.html#ga319767f0b795f1c46a08390b587c5671">sp_session_playlistcontainer()</a> </dd>
<dd>
<a class="el" href="group__playlist.html#ga1976cb49c391cdd2dbe7c40d1bc71570">sp_playlistcontainer_add_callbacks</a> </dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="ga1ae1d51c4305940ae5c5c98c12be0afc"></a><!-- doxytag: member="api.h::sp_playlistcontainer_remove_playlist" ref="ga1ae1d51c4305940ae5c5c98c12be0afc" args="(sp_playlistcontainer *pc, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_playlistcontainer_remove_playlist </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *&nbsp;</td>
          <td class="paramname"> <em>pc</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Remove playlist at index from the given playlist container</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pc</em>&nbsp;</td><td>Playlist container </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Index of playlist to be removed</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>error One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_INDEX_OUT_OF_RANGE </dd></dl>

</div>
</div>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/group__search.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Search subsystem</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#typedef-members">Typedefs</a> &#124;
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<h1>Search subsystem</h1>  </div>
</div>
<div class="contents">
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#gabcd51c99a318b9f36dfe2948d8209bb1">search_complete_cb</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *result, void *userdata)</td></tr>
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga2f64dfbcc1313e7d5179998cb28208d4">sp_search_create</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, const char *query, int track_offset, int track_count, int album_offset, int album_count, int artist_offset, int artist_count, int playlist_offset, int playlist_count, <a class="el" href="group__session.html#ga99e8e9176ce40fff08a9be8b944edb09">sp_search_type</a> search_type, <a class="el" href="group__search.html#gabcd51c99a318b9f36dfe2948d8209bb1">search_complete_cb</a> *callback, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga70e8c404d8c7ce0bbef70c2b274417cd">sp_search_is_loaded</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga7cf655e37a823f952d30270d4fb60f10">sp_search_error</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga1dd18cf7b3b3b7f4bf6e92a2140378d0">sp_search_num_tracks</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#gae9da7ca59ce0bbd73f7bcef4e15c4da8">sp_search_track</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga0c456a6396c4c05fbc8677ea641ef1f7">sp_search_num_albums</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga4ba7723e70db0c6a4569c4bcd44f0e98">sp_search_album</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#gaa9f007f439d8241bf632f9abb8d926c9">sp_search_num_playlists</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga4175fba17f355b1c0bd361357181ea35">sp_search_playlist</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga933cd5d5a0ccca9906082ca4549a4ed7">sp_search_playlist_name</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga0071a3d30f0f0c4e477bf923e9014ff5">sp_search_playlist_uri</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#gac4463fab4ea25e0a5d5079c959a1781c">sp_search_playlist_image_uri</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#gabd375a613c2dadecad8c13f8aca6f2d3">sp_search_num_artists</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga79b3d532d5a20a3b2bf2a087eead7888">sp_search_artist</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga127e9c2bf98e3602ecfc2926b9d242bf">sp_search_query</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga8561c1da8b93ecdc8f2d325a9d19199b">sp_search_did_you_mean</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#gab4e50582c517b4639fd1afd6fb011587">sp_search_total_tracks</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#gaafd3b228adbc028937383d0d45730581">sp_search_total_albums</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga305a4118625e0f70cfb14161a0112fd5">sp_search_total_artists</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga2e286415a6ba8dbf85ea677906f2798c">sp_search_total_playlists</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga92e45a5edb1e33e64fdb857bd8eb9ad5">sp_search_add_ref</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__search.html#ga4e01d43067d9f8c533c985f90143821b">sp_search_release</a> (<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *search)</td></tr>
</table>
<hr/><h2>Typedef Documentation</h2>
<a class="anchor" id="gabcd51c99a318b9f36dfe2948d8209bb1"></a><!-- doxytag: member="api.h::search_complete_cb" ref="gabcd51c99a318b9f36dfe2948d8209bb1" args="(sp_search *result, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef void <a class="el" href="group__search.html#gabcd51c99a318b9f36dfe2948d8209bb1">search_complete_cb</a>(<a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *result, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>The type of a callback used in <a class="el" href="group__search.html#ga2f64dfbcc1313e7d5179998cb28208d4">sp_search_create()</a></p>
<p>When this callback is called, the <a class="el" href="group__track.html#ga8b69cf193679c7e00031ae43e61c6a54">sp_track_is_loaded()</a>, <a class="el" href="group__album.html#ga46fbfa98be12c2f4067d5e679552cfb9">sp_album_is_loaded()</a>, and <a class="el" href="group__artist.html#gafc98f5093184a7ac7ce608302b0971ea">sp_artist_is_loaded()</a> functions will return non-zero for the objects contained in the search result.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>result</em>&nbsp;</td><td>The same pointer returned by <a class="el" href="group__search.html#ga2f64dfbcc1313e7d5179998cb28208d4">sp_search_create()</a> </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>The opaque pointer given to <a class="el" href="group__search.html#ga2f64dfbcc1313e7d5179998cb28208d4">sp_search_create()</a> </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="ga92e45a5edb1e33e64fdb857bd8eb9ad5"></a><!-- doxytag: member="api.h::sp_search_add_ref" ref="ga92e45a5edb1e33e64fdb857bd8eb9ad5" args="(sp_search *search)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_search_add_ref </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td>
          <td class="paramname"> <em>search</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Increase the reference count of a search result</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search</em>&nbsp;</td><td>The search result object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="ga4ba7723e70db0c6a4569c4bcd44f0e98"></a><!-- doxytag: member="api.h::sp_search_album" ref="ga4ba7723e70db0c6a4569c4bcd44f0e98" args="(sp_search *search, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a>* sp_search_album </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td>
          <td class="paramname"> <em>search</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the album at the given index in the given search object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search</em>&nbsp;</td><td>Search object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Index of the wanted album. Should be in the interval [0, <a class="el" href="group__search.html#ga0c456a6396c4c05fbc8677ea641ef1f7">sp_search_num_albums()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The album at the given index in the given search object </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="search_8c-example.html#a9">search.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga79b3d532d5a20a3b2bf2a087eead7888"></a><!-- doxytag: member="api.h::sp_search_artist" ref="ga79b3d532d5a20a3b2bf2a087eead7888" args="(sp_search *search, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a>* sp_search_artist </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td>
          <td class="paramname"> <em>search</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the artist at the given index in the given search object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search</em>&nbsp;</td><td>Search object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Index of the wanted artist. Should be in the interval [0, <a class="el" href="group__search.html#gabd375a613c2dadecad8c13f8aca6f2d3">sp_search_num_artists()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The artist at the given index in the given search object </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="search_8c-example.html#a11">search.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga2f64dfbcc1313e7d5179998cb28208d4"></a><!-- doxytag: member="api.h::sp_search_create" ref="ga2f64dfbcc1313e7d5179998cb28208d4" args="(sp_session *session, const char *query, int track_offset, int track_count, int album_offset, int album_count, int artist_offset, int artist_count, int playlist_offset, int playlist_count, sp_search_type search_type, search_complete_cb *callback, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a>* sp_search_create </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>query</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>track_offset</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>track_count</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>album_offset</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>album_count</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>artist_offset</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>artist_count</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>playlist_offset</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>playlist_count</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__session.html#ga99e8e9176ce40fff08a9be8b944edb09">sp_search_type</a>&nbsp;</td>
          <td class="paramname"> <em>search_type</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__search.html#gabcd51c99a318b9f36dfe2948d8209bb1">search_complete_cb</a> *&nbsp;</td>
          <td class="paramname"> <em>callback</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">void *&nbsp;</td>
          <td class="paramname"> <em>userdata</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Create a search object from the given query</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>query</em>&nbsp;</td><td>Query search string, e.g. 'The Rolling Stones' or 'album:"The Black Album"' </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track_offset</em>&nbsp;</td><td>The offset among the tracks of the result </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track_count</em>&nbsp;</td><td>The number of tracks to ask for </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>album_offset</em>&nbsp;</td><td>The offset among the albums of the result </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>album_count</em>&nbsp;</td><td>The number of albums to ask for </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>artist_offset</em>&nbsp;</td><td>The offset among the artists of the result </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>artist_count</em>&nbsp;</td><td>The number of artists to ask for </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist_offset</em>&nbsp;</td><td>The offset among the playlists of the result </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist_count</em>&nbsp;</td><td>The number of playlists to ask for </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search_type</em>&nbsp;</td><td>Type of search, can be used for suggest searches </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>callback</em>&nbsp;</td><td>Callback that will be called once the search operation is complete. Pass NULL if you are not interested in this event. </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Opaque pointer passed to <code>callback</code> </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Pointer to a search object. To free the object, use <a class="el" href="group__search.html#ga4e01d43067d9f8c533c985f90143821b">sp_search_release()</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="search_8c-example.html#a18">search.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga8561c1da8b93ecdc8f2d325a9d19199b"></a><!-- doxytag: member="api.h::sp_search_did_you_mean" ref="ga8561c1da8b93ecdc8f2d325a9d19199b" args="(sp_search *search)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* sp_search_did_you_mean </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td>
          <td class="paramname"> <em>search</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the "Did you mean" query for the given search object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search</em>&nbsp;</td><td>Search object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The "Did you mean" query for the given search object, or the empty string if no such info is available </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="search_8c-example.html#a4">search.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga7cf655e37a823f952d30270d4fb60f10"></a><!-- doxytag: member="api.h::sp_search_error" ref="ga7cf655e37a823f952d30270d4fb60f10" args="(sp_search *search)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_search_error </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td>
          <td class="paramname"> <em>search</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Check if search returned an error code.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search</em>&nbsp;</td><td>Search object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_IS_LOADING SP_ERROR_OTHER_PERMANENT SP_ERROR_OTHER_TRANSIENT </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="search_8c-example.html#a14">search.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga70e8c404d8c7ce0bbef70c2b274417cd"></a><!-- doxytag: member="api.h::sp_search_is_loaded" ref="ga70e8c404d8c7ce0bbef70c2b274417cd" args="(sp_search *search)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_search_is_loaded </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td>
          <td class="paramname"> <em>search</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Get load status for the specified search. Before it is loaded, it will behave as an empty search result.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search</em>&nbsp;</td><td>Search object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>True if search is loaded, otherwise false </dd></dl>

</div>
</div>
<a class="anchor" id="ga0c456a6396c4c05fbc8677ea641ef1f7"></a><!-- doxytag: member="api.h::sp_search_num_albums" ref="ga0c456a6396c4c05fbc8677ea641ef1f7" args="(sp_search *search)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_search_num_albums </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td>
          <td class="paramname"> <em>search</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Get the number of albums for the specified search</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search</em>&nbsp;</td><td>Search object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The number of albums for the specified search </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="search_8c-example.html#a8">search.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gabd375a613c2dadecad8c13f8aca6f2d3"></a><!-- doxytag: member="api.h::sp_search_num_artists" ref="gabd375a613c2dadecad8c13f8aca6f2d3" args="(sp_search *search)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_search_num_artists </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td>
          <td class="paramname"> <em>search</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Get the number of artists for the specified search</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search</em>&nbsp;</td><td>Search object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The number of artists for the specified search </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="search_8c-example.html#a10">search.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gaa9f007f439d8241bf632f9abb8d926c9"></a><!-- doxytag: member="api.h::sp_search_num_playlists" ref="gaa9f007f439d8241bf632f9abb8d926c9" args="(sp_search *search)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_search_num_playlists </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td>
          <td class="paramname"> <em>search</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Get the number of playlists for the specified search</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search</em>&nbsp;</td><td>Search object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The number of playlists for the specified search </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="search_8c-example.html#a12">search.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga1dd18cf7b3b3b7f4bf6e92a2140378d0"></a><!-- doxytag: member="api.h::sp_search_num_tracks" ref="ga1dd18cf7b3b3b7f4bf6e92a2140378d0" args="(sp_search *search)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_search_num_tracks </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td>
          <td class="paramname"> <em>search</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Get the number of tracks for the specified search</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search</em>&nbsp;</td><td>Search object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The number of tracks for the specified search </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="search_8c-example.html#a6">search.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga4175fba17f355b1c0bd361357181ea35"></a><!-- doxytag: member="api.h::sp_search_playlist" ref="ga4175fba17f355b1c0bd361357181ea35" args="(sp_search *search, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a>* sp_search_playlist </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td>
          <td class="paramname"> <em>search</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Load the playlist at the given index in the given search object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search</em>&nbsp;</td><td>Search object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Index of the wanted playlist. Should be in the interval [0, <a class="el" href="group__search.html#gaa9f007f439d8241bf632f9abb8d926c9">sp_search_num_playlists()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A playlist object. This reference is owned by the caller and should be released with <a class="el" href="group__playlist.html#gacb9250eb530869b039541a8b62dfab6c">sp_playlist_release()</a> </dd></dl>

</div>
</div>
<a class="anchor" id="gac4463fab4ea25e0a5d5079c959a1781c"></a><!-- doxytag: member="api.h::sp_search_playlist_image_uri" ref="gac4463fab4ea25e0a5d5079c959a1781c" args="(sp_search *search, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* sp_search_playlist_image_uri </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td>
          <td class="paramname"> <em>search</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the image_uri of a playlist at the given index in the given search object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search</em>&nbsp;</td><td>Search object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Index of the wanted playlist. Should be in the interval [0, <a class="el" href="group__search.html#gaa9f007f439d8241bf632f9abb8d926c9">sp_search_num_playlists()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The playlist image_uri at the given index in the given search object </dd></dl>

</div>
</div>
<a class="anchor" id="ga933cd5d5a0ccca9906082ca4549a4ed7"></a><!-- doxytag: member="api.h::sp_search_playlist_name" ref="ga933cd5d5a0ccca9906082ca4549a4ed7" args="(sp_search *search, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* sp_search_playlist_name </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td>
          <td class="paramname"> <em>search</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the playlist at the given index in the given search object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search</em>&nbsp;</td><td>Search object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Index of the wanted playlist. Should be in the interval [0, <a class="el" href="group__search.html#gaa9f007f439d8241bf632f9abb8d926c9">sp_search_num_playlists()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The playlist name at the given index in the given search object </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="search_8c-example.html#a13">search.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga0071a3d30f0f0c4e477bf923e9014ff5"></a><!-- doxytag: member="api.h::sp_search_playlist_uri" ref="ga0071a3d30f0f0c4e477bf923e9014ff5" args="(sp_search *search, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* sp_search_playlist_uri </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td>
          <td class="paramname"> <em>search</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the uri of a playlist at the given index in the given search object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search</em>&nbsp;</td><td>Search object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Index of the wanted playlist. Should be in the interval [0, <a class="el" href="group__search.html#gaa9f007f439d8241bf632f9abb8d926c9">sp_search_num_playlists()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The playlist uri at the given index in the given search object </dd></dl>

</div>
</div>
<a class="anchor" id="ga127e9c2bf98e3602ecfc2926b9d242bf"></a><!-- doxytag: member="api.h::sp_search_query" ref="ga127e9c2bf98e3602ecfc2926b9d242bf" args="(sp_search *search)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* sp_search_query </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td>
          <td class="paramname"> <em>search</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the search query for the given search object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search</em>&nbsp;</td><td>Search object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The search query for the given search object </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="search_8c-example.html#a3">search.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga4e01d43067d9f8c533c985f90143821b"></a><!-- doxytag: member="api.h::sp_search_release" ref="ga4e01d43067d9f8c533c985f90143821b" args="(sp_search *search)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_search_release </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td>
          <td class="paramname"> <em>search</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Decrease the reference count of a search result</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search</em>&nbsp;</td><td>The search result object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="search_8c-example.html#a17">search.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gaafd3b228adbc028937383d0d45730581"></a><!-- doxytag: member="api.h::sp_search_total_albums" ref="gaafd3b228adbc028937383d0d45730581" args="(sp_search *search)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_search_total_albums </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td>
          <td class="paramname"> <em>search</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the total number of albums for the search query - regardless of the interval requested at creation. If this value is larger than the interval specified at creation of the search object, more search results are available. To fetch these, create a new search object with a new interval.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search</em>&nbsp;</td><td>Search object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The total number of albums matching the original query </dd></dl>

</div>
</div>
<a class="anchor" id="ga305a4118625e0f70cfb14161a0112fd5"></a><!-- doxytag: member="api.h::sp_search_total_artists" ref="ga305a4118625e0f70cfb14161a0112fd5" args="(sp_search *search)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_search_total_artists </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td>
          <td class="paramname"> <em>search</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the total number of artists for the search query - regardless of the interval requested at creation. If this value is larger than the interval specified at creation of the search object, more search results are available. To fetch these, create a new search object with a new interval.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search</em>&nbsp;</td><td>Search object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The total number of artists matching the original query </dd></dl>

</div>
</div>
<a class="anchor" id="ga2e286415a6ba8dbf85ea677906f2798c"></a><!-- doxytag: member="api.h::sp_search_total_playlists" ref="ga2e286415a6ba8dbf85ea677906f2798c" args="(sp_search *search)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_search_total_playlists </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td>
          <td class="paramname"> <em>search</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the total number of playlists for the search query - regardless of the interval requested at creation. If this value is larger than the interval specified at creation of the search object, more search results are available. To fetch these, create a new search object with a new interval.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search</em>&nbsp;</td><td>Search object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The total number of playlists matching the original query </dd></dl>

</div>
</div>
<a class="anchor" id="gab4e50582c517b4639fd1afd6fb011587"></a><!-- doxytag: member="api.h::sp_search_total_tracks" ref="gab4e50582c517b4639fd1afd6fb011587" args="(sp_search *search)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_search_total_tracks </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td>
          <td class="paramname"> <em>search</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the total number of tracks for the search query - regardless of the interval requested at creation. If this value is larger than the interval specified at creation of the search object, more search results are available. To fetch these, create a new search object with a new interval.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search</em>&nbsp;</td><td>Search object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The total number of tracks matching the original query </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="search_8c-example.html#a5">search.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gae9da7ca59ce0bbd73f7bcef4e15c4da8"></a><!-- doxytag: member="api.h::sp_search_track" ref="gae9da7ca59ce0bbd73f7bcef4e15c4da8" args="(sp_search *search, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a>* sp_search_track </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a> *&nbsp;</td>
          <td class="paramname"> <em>search</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the track at the given index in the given search object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>search</em>&nbsp;</td><td>Search object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Index of the wanted track. Should be in the interval [0, <a class="el" href="group__search.html#ga1dd18cf7b3b3b7f4bf6e92a2140378d0">sp_search_num_tracks()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The track at the given index in the given search object </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="search_8c-example.html#a7">search.c</a>.</dd>
</dl>
</div>
</div>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/group__session.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Session handling</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#nested-classes">Data Structures</a> &#124;
<a href="#define-members">Defines</a> &#124;
<a href="#typedef-members">Typedefs</a> &#124;
<a href="#enum-members">Enumerations</a> &#124;
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<h1>Session handling</h1>  </div>
</div>
<div class="contents">
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="nested-classes"></a>
Data Structures</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__audioformat.html">sp_audioformat</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__audio__buffer__stats.html">sp_audio_buffer_stats</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__subscribers.html">sp_subscribers</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__offline__sync__status.html">sp_offline_sync_status</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html">sp_session_callbacks</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__config.html">sp_session_config</a></td></tr>
<tr><td colspan="2"><h2><a name="define-members"></a>
Defines</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga63b2309874193750ec3395f6cae32899">SPOTIFY_API_VERSION</a>&nbsp;&nbsp;&nbsp;12</td></tr>
<tr><td colspan="2"><h2><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__session.html#gabf77bb5a124d5a6ee9a12c86abbc0d34">sp_connectionstate</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gac0fa3d4cc60bd2e3d666026f88980e8c">sp_connectionstate</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__session.html#ga087d21080010768316cfb55d938eb94d">sp_sampletype</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga5ef462e78d5a5af60dd0e7085b1ba512">sp_sampletype</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="structsp__audioformat.html">sp_audioformat</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga5338d4a10576ba8d6ab11b70892d503c">sp_audioformat</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__session.html#ga77ddd919314a7bb16140569af7a38fe2">sp_bitrate</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga83d3de45241a44e787410993c5fac0ea">sp_bitrate</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__session.html#gafdd7117213605e6f2671c4f289b44609">sp_playlist_type</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga86723f553db2db6a8f507cd748948ad4">sp_playlist_type</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__session.html#ga99e8e9176ce40fff08a9be8b944edb09">sp_search_type</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga647e4de81e5ac0a2e5d1193b1005ed3e">sp_search_type</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <br class="typebreak"/>
<a class="el" href="group__session.html#ga811fa52ed0fdb5cda732682e27e40417">sp_playlist_offline_status</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gac507efa32e8c122fbe9ea41d96180d06">sp_playlist_offline_status</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__session.html#gad7d9465769597b2a379ac704099adfdf">sp_availability</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga60c7ff53ddbc04c036a23181b7275d69">sp_track_availability</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <br class="typebreak"/>
<a class="el" href="group__session.html#gaeaa41aad3c0047409996a6ec3b03203f">sp_track_offline_status</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gae689044941537050de641a1dcd4c75d5">sp_track_offline_status</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__session.html#ga61bc424465d776af3ceeb69eee2bb492">sp_image_size</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gaca320fd41bd0556b7fa1f2fa6e14faee">sp_image_size</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef struct <br class="typebreak"/>
<a class="el" href="structsp__audio__buffer__stats.html">sp_audio_buffer_stats</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga25462859a596a247ba5cc1853fc32cca">sp_audio_buffer_stats</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="structsp__subscribers.html">sp_subscribers</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gafb515e30d134c61b8eaaff3177af0b5b">sp_subscribers</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__session.html#ga3e8773baeb94189b9a1ff27d6a5e3553">sp_connection_type</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga05a7dbb946a9c47bf011f3f3d77964c3">sp_connection_type</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__session.html#gad275d696685b2ad9ff1a2c3e16af6502">sp_connection_rules</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga24ee483cdceef9af3b415c020b197a75">sp_connection_rules</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__session.html#gac86504cc9e8cadbc30c8aa8dbf355034">sp_artistbrowse_type</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gab947eba77c176504c69cbb2f1de9830d">sp_artistbrowse_type</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef struct <br class="typebreak"/>
<a class="el" href="structsp__offline__sync__status.html">sp_offline_sync_status</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gaa7f24f13d6d105869c405045a4cc2a20">sp_offline_sync_status</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="structsp__session__callbacks.html">sp_session_callbacks</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gaf1d92302cd5d0d4a032e1408188c8fd5">sp_session_callbacks</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="structsp__session__config.html">sp_session_config</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga372b25a93da38d4d707b0c2eaa7b3ebb">sp_session_config</a></td></tr>
<tr><td colspan="2"><h2><a name="enum-members"></a>
Enumerations</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gabf77bb5a124d5a6ee9a12c86abbc0d34">sp_connectionstate</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggabf77bb5a124d5a6ee9a12c86abbc0d34ae31e9958a98211ecff5ecbcf7041dfa5">SP_CONNECTION_STATE_LOGGED_OUT</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggabf77bb5a124d5a6ee9a12c86abbc0d34a88ae17b4168184e62e4c190c289c47c5">SP_CONNECTION_STATE_LOGGED_IN</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggabf77bb5a124d5a6ee9a12c86abbc0d34ad1a6eb721675af4613f823c091538a8c">SP_CONNECTION_STATE_DISCONNECTED</a> =  2, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggabf77bb5a124d5a6ee9a12c86abbc0d34a4ddf57518007eef86b06f496d7059484">SP_CONNECTION_STATE_UNDEFINED</a> =  3, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggabf77bb5a124d5a6ee9a12c86abbc0d34a63099ef9185ba287fcd2e77be3c47d8f">SP_CONNECTION_STATE_OFFLINE</a> =  4
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga087d21080010768316cfb55d938eb94d">sp_sampletype</a> { <a class="el" href="group__session.html#gga087d21080010768316cfb55d938eb94daa829b269d191cca95ecb02c2bc59da42">SP_SAMPLETYPE_INT16_NATIVE_ENDIAN</a> =  0
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga77ddd919314a7bb16140569af7a38fe2">sp_bitrate</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga77ddd919314a7bb16140569af7a38fe2a5b5c794224972f833a4b7eec9d7909c9">SP_BITRATE_160k</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga77ddd919314a7bb16140569af7a38fe2a9383c0dc9faefd2cbb38c3b9342c47e0">SP_BITRATE_320k</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga77ddd919314a7bb16140569af7a38fe2ad815a35af7e6bb5e2ef29418af62759b">SP_BITRATE_96k</a> =  2
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gafdd7117213605e6f2671c4f289b44609">sp_playlist_type</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggafdd7117213605e6f2671c4f289b44609a6bd6bf9b62018fa9bbf969835c2f3077">SP_PLAYLIST_TYPE_PLAYLIST</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggafdd7117213605e6f2671c4f289b44609a4d3266991787f9438deb9de83d9200da">SP_PLAYLIST_TYPE_START_FOLDER</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggafdd7117213605e6f2671c4f289b44609a3ec52ad1d99d8e32e1b9de31e3f5187a">SP_PLAYLIST_TYPE_END_FOLDER</a> =  2, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggafdd7117213605e6f2671c4f289b44609ad4f860ef76154e3e2c0d9da2f57a2784">SP_PLAYLIST_TYPE_PLACEHOLDER</a> =  3
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga99e8e9176ce40fff08a9be8b944edb09">sp_search_type</a> </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga811fa52ed0fdb5cda732682e27e40417">sp_playlist_offline_status</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga811fa52ed0fdb5cda732682e27e40417abef62e4e3a4af8827fed7fe3aa733ca0">SP_PLAYLIST_OFFLINE_STATUS_NO</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga811fa52ed0fdb5cda732682e27e40417affed38ac820e084b96fb48e3d1939584">SP_PLAYLIST_OFFLINE_STATUS_YES</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga811fa52ed0fdb5cda732682e27e40417abc999c70761d392b26753708e9a2cfa1">SP_PLAYLIST_OFFLINE_STATUS_DOWNLOADING</a> =  2, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga811fa52ed0fdb5cda732682e27e40417a7d929bbf4f1df3633b283e39b9c95919">SP_PLAYLIST_OFFLINE_STATUS_WAITING</a> =  3
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gad7d9465769597b2a379ac704099adfdf">sp_availability</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggad7d9465769597b2a379ac704099adfdfa44bc1e6f138910b3f8dbd309325e0077">SP_TRACK_AVAILABILITY_UNAVAILABLE</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggad7d9465769597b2a379ac704099adfdfa3b837ba6d740b5650b0113734a3b2ff7">SP_TRACK_AVAILABILITY_AVAILABLE</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggad7d9465769597b2a379ac704099adfdfae7b2cfafa10288ecc50df97621bbe940">SP_TRACK_AVAILABILITY_NOT_STREAMABLE</a> =  2, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggad7d9465769597b2a379ac704099adfdfaeb5d63e89c543f513cd3054969e50914">SP_TRACK_AVAILABILITY_BANNED_BY_ARTIST</a> =  3
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gaeaa41aad3c0047409996a6ec3b03203f">sp_track_offline_status</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203faad1a1cba82ce9f9be678f4d1042eddec">SP_TRACK_OFFLINE_NO</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa1fdd2a518dcdc072cfca27a0ca4f2581">SP_TRACK_OFFLINE_WAITING</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa7dcf6dfc56a8421200451d07a476f370">SP_TRACK_OFFLINE_DOWNLOADING</a> =  2, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fac54d46cbc73de7686a1ad8daf269532a">SP_TRACK_OFFLINE_DONE</a> =  3, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa86618798c266540bdc889dd037a52631">SP_TRACK_OFFLINE_ERROR</a> =  4, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa00fe430030fb6a8a49a46c11cca7326c">SP_TRACK_OFFLINE_DONE_EXPIRED</a> =  5, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa405a9b7a3fa489ad2dadbb108794e247">SP_TRACK_OFFLINE_LIMIT_EXCEEDED</a> =  6, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggaeaa41aad3c0047409996a6ec3b03203fa5f3e19627de4509ae4a3864fd29edee6">SP_TRACK_OFFLINE_DONE_RESYNC</a> =  7
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga61bc424465d776af3ceeb69eee2bb492">sp_image_size</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga61bc424465d776af3ceeb69eee2bb492ad20c808fd1f8180d1f49f643975d1dd7">SP_IMAGE_SIZE_NORMAL</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga61bc424465d776af3ceeb69eee2bb492ab9340b1bcf2129c3ad1328ea617d547f">SP_IMAGE_SIZE_SMALL</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga61bc424465d776af3ceeb69eee2bb492a0a0b624afbb2a66ee3d7954202b89721">SP_IMAGE_SIZE_LARGE</a> =  2
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga3e8773baeb94189b9a1ff27d6a5e3553">sp_connection_type</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553af949fae9bc12f47b99ef290fa9b5d8a7">SP_CONNECTION_TYPE_UNKNOWN</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553aa7aae7ae3f7c471ece1c6aa2705d046c">SP_CONNECTION_TYPE_NONE</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553a3ca3e6a85ac9d497914c35620ad5179d">SP_CONNECTION_TYPE_MOBILE</a> =  2, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553a05b41bbfd369f9030a7daafc9395116e">SP_CONNECTION_TYPE_MOBILE_ROAMING</a> =  3, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553a31d2cad7379f1bc2eeedd24c40541cb9">SP_CONNECTION_TYPE_WIFI</a> =  4, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#gga3e8773baeb94189b9a1ff27d6a5e3553a4f9f0c09e59af4114bb369ebcc474710">SP_CONNECTION_TYPE_WIRED</a> =  5
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gad275d696685b2ad9ff1a2c3e16af6502">sp_connection_rules</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggad275d696685b2ad9ff1a2c3e16af6502aa39a1c21c17c55cd1547bc900ae2d386">SP_CONNECTION_RULE_NETWORK</a> =  0x1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggad275d696685b2ad9ff1a2c3e16af6502af2772ba84ee7e410ad99708a11955670">SP_CONNECTION_RULE_NETWORK_IF_ROAMING</a> =  0x2, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggad275d696685b2ad9ff1a2c3e16af6502a91a946573c44de44d74e9d20dbce4c74">SP_CONNECTION_RULE_ALLOW_SYNC_OVER_MOBILE</a> =  0x4, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggad275d696685b2ad9ff1a2c3e16af6502a548f3734832ec65a992e598d8b91633d">SP_CONNECTION_RULE_ALLOW_SYNC_OVER_WIFI</a> =  0x8
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gac86504cc9e8cadbc30c8aa8dbf355034">sp_artistbrowse_type</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggac86504cc9e8cadbc30c8aa8dbf355034a2914168528aded818177c013a0dd7e87">SP_ARTISTBROWSE_FULL</a>, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggac86504cc9e8cadbc30c8aa8dbf355034afbad1e58606b3230dce5bc3320c95d12">SP_ARTISTBROWSE_NO_TRACKS</a>, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__session.html#ggac86504cc9e8cadbc30c8aa8dbf355034ac0032981f8dbf44c022e6a7ab1672167">SP_ARTISTBROWSE_NO_ALBUMS</a>
<br/>
 }</td></tr>
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gaf2891f2daced4ff6da84219d6376b3aa">sp_session_create</a> (const <a class="el" href="structsp__session__config.html">sp_session_config</a> *config, <a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> **sess)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gab81c540b76f7425a9cc0dbf270c09674">sp_session_release</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *sess)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga4533a992a120cacb109c892a852afe2a">sp_session_login</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, const char *username, const char *password, bool remember_me, const char *blob)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gae1bc9bebd230226c3d48925cd1be6edf">sp_session_relogin</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gab349c7bfe59e10e167bd75c20df9fc97">sp_session_remembered_user</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, char *buffer, size_t buffer_size)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gac7a365c2166738909cdb901edebc3f70">sp_session_user_name</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga61e6b796d9e07682c018e888b901a191">sp_session_forget_me</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga267bbcae24b6bb1fd56de56678a5f455">sp_session_user</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gab7f08ca0939985b30ae2d1ed9db1d726">sp_session_logout</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga34005bb06ee3de8ee4221597a0335cca">sp_session_flush_caches</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__session.html#gabf77bb5a124d5a6ee9a12c86abbc0d34">sp_connectionstate</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga34a7c9527705ab7d23b742006d81ea35">sp_session_connectionstate</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gabfb3f59b20ae0b225e154eb9095152b2">sp_session_userdata</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga6f27c55d1ce9f3f794fcce7bee7adfea">sp_session_set_cache_size</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, size_t size)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gaff27cb730db6debf55e750e39e7fadd7">sp_session_process_events</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, int *next_timeout)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gac73bf2c569a43d824439b557d5e4b293">sp_session_player_load</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga3430cd4f11541868d3f83eaa31aecf44">sp_session_player_seek</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, int offset)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gab66c5915967e4f90db945b118e620624">sp_session_player_play</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, bool play)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gafa7ee2803f119451bb8be3bf28746975">sp_session_player_unload</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gaf42e30a1f430ac7c436c7d9f0485368d">sp_session_player_prefetch</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga319767f0b795f1c46a08390b587c5671">sp_session_playlistcontainer</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gac72ccb51031c846101134b73195bb9ec">sp_session_inbox_create</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga02391c9e28cff0a602f7139542e0238f">sp_session_starred_create</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga9be806a719a6399bfe1fd0d4c125e0eb">sp_session_starred_for_user_create</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, const char *canonical_username)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga4ad3a1de596a41f275120dad3bb4685d">sp_session_publishedcontainer_for_user_create</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, const char *canonical_username)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gacd590e095b011af42fb10046117846fe">sp_session_preferred_bitrate</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__session.html#ga77ddd919314a7bb16140569af7a38fe2">sp_bitrate</a> bitrate)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga4bba5f828d6c87692f2c355cc8f07c61">sp_session_preferred_offline_bitrate</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__session.html#ga77ddd919314a7bb16140569af7a38fe2">sp_bitrate</a> bitrate, bool allow_resync)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga7913df06394360f255c77fb87af0f1fe">sp_session_get_volume_normalization</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga4e14f58356d00e3693be84623bf6bd11">sp_session_set_volume_normalization</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, bool on)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga42a8f0999316ac7f141926092879ad2f">sp_session_set_private_session</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, bool enabled)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga72702ee06bc96c074804388d24344149">sp_session_is_private_session</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga2475a1fbc2eeacccb96b7f36efd36725">sp_session_set_scrobbling</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, sp_social_provider provider, sp_scrobbling_state state)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga6a56bc82ff0b369bb6e0f035534ce33d">sp_session_is_scrobbling</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, sp_social_provider provider, sp_scrobbling_state *state)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga0fad03ceabcf8d68af78f0f35fcbcc8d">sp_session_is_scrobbling_possible</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, sp_social_provider provider, bool *out)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga9e5ee46ef5e75aa462607caac984f2de">sp_session_set_social_credentials</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, sp_social_provider provider, const char *username, const char *password)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gaf81c61799e0ccdbba048fb79ec050930">sp_session_set_connection_type</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__session.html#ga3e8773baeb94189b9a1ff27d6a5e3553">sp_connection_type</a> type)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga0ac85299c37710321b6d64713e1d6ba8">sp_session_set_connection_rules</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__session.html#gad275d696685b2ad9ff1a2c3e16af6502">sp_connection_rules</a> rules)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gaf535124b4208c279cb98a061834e6411">sp_offline_tracks_to_sync</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gad6cee58fa44453b7a4fd2ae2266df055">sp_offline_num_playlists</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga02525cd659a34728047cd3801049e822">sp_offline_sync_get_status</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="structsp__offline__sync__status.html">sp_offline_sync_status</a> *status)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#gac36816dc42825db9a5a2fbd2694f20af">sp_offline_time_left</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__session.html#ga54c7693afa9be664f3ea870feb0df8d9">sp_session_user_country</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>The concept of a session is fundamental for all communication with the Spotify ecosystem - it is the object responsible for communicating with the Spotify service. You will need to instantiate a session that then can be used to request artist information, perform searches etc. </p>
<hr/><h2>Define Documentation</h2>
<a class="anchor" id="ga63b2309874193750ec3395f6cae32899"></a><!-- doxytag: member="api.h::SPOTIFY_API_VERSION" ref="ga63b2309874193750ec3395f6cae32899" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define SPOTIFY_API_VERSION&nbsp;&nbsp;&nbsp;12</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Current version of the application interface, that is, the API described by this file.</p>
<p>This value should be set in the <a class="el" href="structsp__session__config.html">sp_session_config</a> struct passed to <a class="el" href="group__session.html#gaf2891f2daced4ff6da84219d6376b3aa">sp_session_create()</a>.</p>
<p>If an (upgraded) library is no longer compatible with this version the error <a class="el" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba17c588fa9648e3649185e595bdb88d6f" title="The library version targeted does not match the one you claim you support.">SP_ERROR_BAD_API_VERSION</a> will be returned from <a class="el" href="group__session.html#gaf2891f2daced4ff6da84219d6376b3aa">sp_session_create()</a>. Future versions of the library will provide you with some kind of mechanism to request an updated version of the library. </p>

</div>
</div>
<hr/><h2>Typedef Documentation</h2>
<a class="anchor" id="gab947eba77c176504c69cbb2f1de9830d"></a><!-- doxytag: member="api.h::sp_artistbrowse_type" ref="gab947eba77c176504c69cbb2f1de9830d" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef enum <a class="el" href="group__session.html#gac86504cc9e8cadbc30c8aa8dbf355034">sp_artistbrowse_type</a>  <a class="el" href="group__session.html#gac86504cc9e8cadbc30c8aa8dbf355034">sp_artistbrowse_type</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Controls the type of data that will be included in artist browse queries </p>

</div>
</div>
<a class="anchor" id="ga25462859a596a247ba5cc1853fc32cca"></a><!-- doxytag: member="api.h::sp_audio_buffer_stats" ref="ga25462859a596a247ba5cc1853fc32cca" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef struct <a class="el" href="structsp__audio__buffer__stats.html">sp_audio_buffer_stats</a>  <a class="el" href="structsp__audio__buffer__stats.html">sp_audio_buffer_stats</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Buffer stats used by get_audio_buffer_stats callback </p>

</div>
</div>
<a class="anchor" id="ga5338d4a10576ba8d6ab11b70892d503c"></a><!-- doxytag: member="api.h::sp_audioformat" ref="ga5338d4a10576ba8d6ab11b70892d503c" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef struct <a class="el" href="structsp__audioformat.html">sp_audioformat</a>  <a class="el" href="structsp__audioformat.html">sp_audioformat</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Audio format descriptor </p>

</div>
</div>
<a class="anchor" id="ga83d3de45241a44e787410993c5fac0ea"></a><!-- doxytag: member="api.h::sp_bitrate" ref="ga83d3de45241a44e787410993c5fac0ea" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef enum <a class="el" href="group__session.html#ga77ddd919314a7bb16140569af7a38fe2">sp_bitrate</a>  <a class="el" href="group__session.html#ga77ddd919314a7bb16140569af7a38fe2">sp_bitrate</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Bitrate definitions for music streaming </p>

</div>
</div>
<a class="anchor" id="ga24ee483cdceef9af3b415c020b197a75"></a><!-- doxytag: member="api.h::sp_connection_rules" ref="ga24ee483cdceef9af3b415c020b197a75" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef enum <a class="el" href="group__session.html#gad275d696685b2ad9ff1a2c3e16af6502">sp_connection_rules</a>  <a class="el" href="group__session.html#gad275d696685b2ad9ff1a2c3e16af6502">sp_connection_rules</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Connection rules, bitwise OR of flags</p>
<p>The default is SP_CONNECTION_RULE_NETWORK | SP_CONNECTION_RULE_ALLOW_SYNC </p>

</div>
</div>
<a class="anchor" id="ga05a7dbb946a9c47bf011f3f3d77964c3"></a><!-- doxytag: member="api.h::sp_connection_type" ref="ga05a7dbb946a9c47bf011f3f3d77964c3" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef enum <a class="el" href="group__session.html#ga3e8773baeb94189b9a1ff27d6a5e3553">sp_connection_type</a>  <a class="el" href="group__session.html#ga3e8773baeb94189b9a1ff27d6a5e3553">sp_connection_type</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Current connection type set using <a class="el" href="group__session.html#gaf81c61799e0ccdbba048fb79ec050930">sp_session_set_connection_type()</a> </p>

</div>
</div>
<a class="anchor" id="gac0fa3d4cc60bd2e3d666026f88980e8c"></a><!-- doxytag: member="api.h::sp_connectionstate" ref="gac0fa3d4cc60bd2e3d666026f88980e8c" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef enum <a class="el" href="group__session.html#gabf77bb5a124d5a6ee9a12c86abbc0d34">sp_connectionstate</a>  <a class="el" href="group__session.html#gabf77bb5a124d5a6ee9a12c86abbc0d34">sp_connectionstate</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Describes the current state of the connection </p>

</div>
</div>
<a class="anchor" id="gaca320fd41bd0556b7fa1f2fa6e14faee"></a><!-- doxytag: member="api.h::sp_image_size" ref="gaca320fd41bd0556b7fa1f2fa6e14faee" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef enum <a class="el" href="group__session.html#ga61bc424465d776af3ceeb69eee2bb492">sp_image_size</a>  <a class="el" href="group__session.html#ga61bc424465d776af3ceeb69eee2bb492">sp_image_size</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Image size </p>

</div>
</div>
<a class="anchor" id="gaa7f24f13d6d105869c405045a4cc2a20"></a><!-- doxytag: member="api.h::sp_offline_sync_status" ref="gaa7f24f13d6d105869c405045a4cc2a20" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef struct <a class="el" href="structsp__offline__sync__status.html">sp_offline_sync_status</a>  <a class="el" href="structsp__offline__sync__status.html">sp_offline_sync_status</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Offline sync status </p>

</div>
</div>
<a class="anchor" id="gac507efa32e8c122fbe9ea41d96180d06"></a><!-- doxytag: member="api.h::sp_playlist_offline_status" ref="gac507efa32e8c122fbe9ea41d96180d06" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef enum <a class="el" href="group__session.html#ga811fa52ed0fdb5cda732682e27e40417">sp_playlist_offline_status</a>  <a class="el" href="group__session.html#ga811fa52ed0fdb5cda732682e27e40417">sp_playlist_offline_status</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Playlist offline status </p>

</div>
</div>
<a class="anchor" id="ga86723f553db2db6a8f507cd748948ad4"></a><!-- doxytag: member="api.h::sp_playlist_type" ref="ga86723f553db2db6a8f507cd748948ad4" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef enum <a class="el" href="group__session.html#gafdd7117213605e6f2671c4f289b44609">sp_playlist_type</a>  <a class="el" href="group__session.html#gafdd7117213605e6f2671c4f289b44609">sp_playlist_type</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Playlist types </p>

</div>
</div>
<a class="anchor" id="ga5ef462e78d5a5af60dd0e7085b1ba512"></a><!-- doxytag: member="api.h::sp_sampletype" ref="ga5ef462e78d5a5af60dd0e7085b1ba512" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef enum <a class="el" href="group__session.html#ga087d21080010768316cfb55d938eb94d">sp_sampletype</a>  <a class="el" href="group__session.html#ga087d21080010768316cfb55d938eb94d">sp_sampletype</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Sample type descriptor </p>

</div>
</div>
<a class="anchor" id="ga647e4de81e5ac0a2e5d1193b1005ed3e"></a><!-- doxytag: member="api.h::sp_search_type" ref="ga647e4de81e5ac0a2e5d1193b1005ed3e" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef enum <a class="el" href="group__session.html#ga99e8e9176ce40fff08a9be8b944edb09">sp_search_type</a>  <a class="el" href="group__session.html#ga99e8e9176ce40fff08a9be8b944edb09">sp_search_type</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Search types </p>

</div>
</div>
<a class="anchor" id="gaf1d92302cd5d0d4a032e1408188c8fd5"></a><!-- doxytag: member="api.h::sp_session_callbacks" ref="gaf1d92302cd5d0d4a032e1408188c8fd5" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef struct <a class="el" href="structsp__session__callbacks.html">sp_session_callbacks</a>  <a class="el" href="structsp__session__callbacks.html">sp_session_callbacks</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Session callbacks</p>
<p>Registered when you create a session. If some callbacks should not be of interest, set them to NULL. </p>

</div>
</div>
<a class="anchor" id="ga372b25a93da38d4d707b0c2eaa7b3ebb"></a><!-- doxytag: member="api.h::sp_session_config" ref="ga372b25a93da38d4d707b0c2eaa7b3ebb" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef struct <a class="el" href="structsp__session__config.html">sp_session_config</a>  <a class="el" href="structsp__session__config.html">sp_session_config</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Session config </p>

</div>
</div>
<a class="anchor" id="gafb515e30d134c61b8eaaff3177af0b5b"></a><!-- doxytag: member="api.h::sp_subscribers" ref="gafb515e30d134c61b8eaaff3177af0b5b" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef struct <a class="el" href="structsp__subscribers.html">sp_subscribers</a>  <a class="el" href="structsp__subscribers.html">sp_subscribers</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>List of subscribers returned by <a class="el" href="group__playlist.html#gad49f491babc475f8d4aeea1b4452ff8b">sp_playlist_subscribers()</a> </p>

</div>
</div>
<a class="anchor" id="ga60c7ff53ddbc04c036a23181b7275d69"></a><!-- doxytag: member="api.h::sp_track_availability" ref="ga60c7ff53ddbc04c036a23181b7275d69" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef enum <a class="el" href="group__session.html#gad7d9465769597b2a379ac704099adfdf">sp_availability</a>  <a class="el" href="group__session.html#ga60c7ff53ddbc04c036a23181b7275d69">sp_track_availability</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Track availability </p>

</div>
</div>
<a class="anchor" id="gae689044941537050de641a1dcd4c75d5"></a><!-- doxytag: member="api.h::sp_track_offline_status" ref="gae689044941537050de641a1dcd4c75d5" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef enum <a class="el" href="group__session.html#gaeaa41aad3c0047409996a6ec3b03203f">sp_track_offline_status</a>  <a class="el" href="group__session.html#gaeaa41aad3c0047409996a6ec3b03203f">sp_track_offline_status</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Track offline status </p>

</div>
</div>
<hr/><h2>Enumeration Type Documentation</h2>
<a class="anchor" id="gac86504cc9e8cadbc30c8aa8dbf355034"></a><!-- doxytag: member="api.h::sp_artistbrowse_type" ref="gac86504cc9e8cadbc30c8aa8dbf355034" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="group__session.html#gac86504cc9e8cadbc30c8aa8dbf355034">sp_artistbrowse_type</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Controls the type of data that will be included in artist browse queries </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="ggac86504cc9e8cadbc30c8aa8dbf355034a2914168528aded818177c013a0dd7e87"></a><!-- doxytag: member="SP_ARTISTBROWSE_FULL" ref="ggac86504cc9e8cadbc30c8aa8dbf355034a2914168528aded818177c013a0dd7e87" args="" -->SP_ARTISTBROWSE_FULL</em>&nbsp;</td><td>
<p>All information except tophit tracks This mode is deprecated and will removed in a future release </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggac86504cc9e8cadbc30c8aa8dbf355034afbad1e58606b3230dce5bc3320c95d12"></a><!-- doxytag: member="SP_ARTISTBROWSE_NO_TRACKS" ref="ggac86504cc9e8cadbc30c8aa8dbf355034afbad1e58606b3230dce5bc3320c95d12" args="" -->SP_ARTISTBROWSE_NO_TRACKS</em>&nbsp;</td><td>
<p>Only albums and data about them, no tracks. In other words, <a class="el" href="group__artistbrowse.html#ga8c862caa2234125ffcc4e93287b1e029">sp_artistbrowse_num_tracks()</a> will return 0 </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggac86504cc9e8cadbc30c8aa8dbf355034ac0032981f8dbf44c022e6a7ab1672167"></a><!-- doxytag: member="SP_ARTISTBROWSE_NO_ALBUMS" ref="ggac86504cc9e8cadbc30c8aa8dbf355034ac0032981f8dbf44c022e6a7ab1672167" args="" -->SP_ARTISTBROWSE_NO_ALBUMS</em>&nbsp;</td><td>
<p>Only return data about the artist (artist name, similar artist biography, etc No tracks or album will be abailable. <a class="el" href="group__artistbrowse.html#ga8c862caa2234125ffcc4e93287b1e029">sp_artistbrowse_num_tracks()</a> and <a class="el" href="group__artistbrowse.html#gaf0055361abd53425d89a4636a32b5c83">sp_artistbrowse_num_albums()</a> will both return 0 </p>
</td></tr>
</table>
</dd>
</dl>

</div>
</div>
<a class="anchor" id="gad7d9465769597b2a379ac704099adfdf"></a><!-- doxytag: member="api.h::sp_availability" ref="gad7d9465769597b2a379ac704099adfdf" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="group__session.html#gad7d9465769597b2a379ac704099adfdf">sp_availability</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Track availability </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="ggad7d9465769597b2a379ac704099adfdfa44bc1e6f138910b3f8dbd309325e0077"></a><!-- doxytag: member="SP_TRACK_AVAILABILITY_UNAVAILABLE" ref="ggad7d9465769597b2a379ac704099adfdfa44bc1e6f138910b3f8dbd309325e0077" args="" -->SP_TRACK_AVAILABILITY_UNAVAILABLE</em>&nbsp;</td><td>
<p>Track is not available. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggad7d9465769597b2a379ac704099adfdfa3b837ba6d740b5650b0113734a3b2ff7"></a><!-- doxytag: member="SP_TRACK_AVAILABILITY_AVAILABLE" ref="ggad7d9465769597b2a379ac704099adfdfa3b837ba6d740b5650b0113734a3b2ff7" args="" -->SP_TRACK_AVAILABILITY_AVAILABLE</em>&nbsp;</td><td>
<p>Track is available and can be played. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggad7d9465769597b2a379ac704099adfdfae7b2cfafa10288ecc50df97621bbe940"></a><!-- doxytag: member="SP_TRACK_AVAILABILITY_NOT_STREAMABLE" ref="ggad7d9465769597b2a379ac704099adfdfae7b2cfafa10288ecc50df97621bbe940" args="" -->SP_TRACK_AVAILABILITY_NOT_STREAMABLE</em>&nbsp;</td><td>
<p>Track can not be streamed using this account. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggad7d9465769597b2a379ac704099adfdfaeb5d63e89c543f513cd3054969e50914"></a><!-- doxytag: member="SP_TRACK_AVAILABILITY_BANNED_BY_ARTIST" ref="ggad7d9465769597b2a379ac704099adfdfaeb5d63e89c543f513cd3054969e50914" args="" -->SP_TRACK_AVAILABILITY_BANNED_BY_ARTIST</em>&nbsp;</td><td>
<p>Track not available on artist's reqeust. </p>
</td></tr>
</table>
</dd>
</dl>

</div>
</div>
<a class="anchor" id="ga77ddd919314a7bb16140569af7a38fe2"></a><!-- doxytag: member="api.h::sp_bitrate" ref="ga77ddd919314a7bb16140569af7a38fe2" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="group__session.html#ga77ddd919314a7bb16140569af7a38fe2">sp_bitrate</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Bitrate definitions for music streaming </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="gga77ddd919314a7bb16140569af7a38fe2a5b5c794224972f833a4b7eec9d7909c9"></a><!-- doxytag: member="SP_BITRATE_160k" ref="gga77ddd919314a7bb16140569af7a38fe2a5b5c794224972f833a4b7eec9d7909c9" args="" -->SP_BITRATE_160k</em>&nbsp;</td><td>
<p>Bitrate 160kbps. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga77ddd919314a7bb16140569af7a38fe2a9383c0dc9faefd2cbb38c3b9342c47e0"></a><!-- doxytag: member="SP_BITRATE_320k" ref="gga77ddd919314a7bb16140569af7a38fe2a9383c0dc9faefd2cbb38c3b9342c47e0" args="" -->SP_BITRATE_320k</em>&nbsp;</td><td>
<p>Bitrate 320kbps. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga77ddd919314a7bb16140569af7a38fe2ad815a35af7e6bb5e2ef29418af62759b"></a><!-- doxytag: member="SP_BITRATE_96k" ref="gga77ddd919314a7bb16140569af7a38fe2ad815a35af7e6bb5e2ef29418af62759b" args="" -->SP_BITRATE_96k</em>&nbsp;</td><td>
<p>Bitrate 96kbps. </p>
</td></tr>
</table>
</dd>
</dl>

</div>
</div>
<a class="anchor" id="gad275d696685b2ad9ff1a2c3e16af6502"></a><!-- doxytag: member="api.h::sp_connection_rules" ref="gad275d696685b2ad9ff1a2c3e16af6502" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="group__session.html#gad275d696685b2ad9ff1a2c3e16af6502">sp_connection_rules</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Connection rules, bitwise OR of flags</p>
<p>The default is SP_CONNECTION_RULE_NETWORK | SP_CONNECTION_RULE_ALLOW_SYNC </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="ggad275d696685b2ad9ff1a2c3e16af6502aa39a1c21c17c55cd1547bc900ae2d386"></a><!-- doxytag: member="SP_CONNECTION_RULE_NETWORK" ref="ggad275d696685b2ad9ff1a2c3e16af6502aa39a1c21c17c55cd1547bc900ae2d386" args="" -->SP_CONNECTION_RULE_NETWORK</em>&nbsp;</td><td>
<p>Allow network traffic. When not set libspotify will force itself into offline mode. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggad275d696685b2ad9ff1a2c3e16af6502af2772ba84ee7e410ad99708a11955670"></a><!-- doxytag: member="SP_CONNECTION_RULE_NETWORK_IF_ROAMING" ref="ggad275d696685b2ad9ff1a2c3e16af6502af2772ba84ee7e410ad99708a11955670" args="" -->SP_CONNECTION_RULE_NETWORK_IF_ROAMING</em>&nbsp;</td><td>
<p>Allow network traffic even if roaming. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggad275d696685b2ad9ff1a2c3e16af6502a91a946573c44de44d74e9d20dbce4c74"></a><!-- doxytag: member="SP_CONNECTION_RULE_ALLOW_SYNC_OVER_MOBILE" ref="ggad275d696685b2ad9ff1a2c3e16af6502a91a946573c44de44d74e9d20dbce4c74" args="" -->SP_CONNECTION_RULE_ALLOW_SYNC_OVER_MOBILE</em>&nbsp;</td><td>
<p>Set to allow syncing of offline content over mobile connections. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggad275d696685b2ad9ff1a2c3e16af6502a548f3734832ec65a992e598d8b91633d"></a><!-- doxytag: member="SP_CONNECTION_RULE_ALLOW_SYNC_OVER_WIFI" ref="ggad275d696685b2ad9ff1a2c3e16af6502a548f3734832ec65a992e598d8b91633d" args="" -->SP_CONNECTION_RULE_ALLOW_SYNC_OVER_WIFI</em>&nbsp;</td><td>
<p>Set to allow syncing of offline content over WiFi. </p>
</td></tr>
</table>
</dd>
</dl>

</div>
</div>
<a class="anchor" id="ga3e8773baeb94189b9a1ff27d6a5e3553"></a><!-- doxytag: member="api.h::sp_connection_type" ref="ga3e8773baeb94189b9a1ff27d6a5e3553" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="group__session.html#ga3e8773baeb94189b9a1ff27d6a5e3553">sp_connection_type</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Current connection type set using <a class="el" href="group__session.html#gaf81c61799e0ccdbba048fb79ec050930">sp_session_set_connection_type()</a> </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="gga3e8773baeb94189b9a1ff27d6a5e3553af949fae9bc12f47b99ef290fa9b5d8a7"></a><!-- doxytag: member="SP_CONNECTION_TYPE_UNKNOWN" ref="gga3e8773baeb94189b9a1ff27d6a5e3553af949fae9bc12f47b99ef290fa9b5d8a7" args="" -->SP_CONNECTION_TYPE_UNKNOWN</em>&nbsp;</td><td>
<p>Connection type unknown (Default). </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga3e8773baeb94189b9a1ff27d6a5e3553aa7aae7ae3f7c471ece1c6aa2705d046c"></a><!-- doxytag: member="SP_CONNECTION_TYPE_NONE" ref="gga3e8773baeb94189b9a1ff27d6a5e3553aa7aae7ae3f7c471ece1c6aa2705d046c" args="" -->SP_CONNECTION_TYPE_NONE</em>&nbsp;</td><td>
<p>No connection. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga3e8773baeb94189b9a1ff27d6a5e3553a3ca3e6a85ac9d497914c35620ad5179d"></a><!-- doxytag: member="SP_CONNECTION_TYPE_MOBILE" ref="gga3e8773baeb94189b9a1ff27d6a5e3553a3ca3e6a85ac9d497914c35620ad5179d" args="" -->SP_CONNECTION_TYPE_MOBILE</em>&nbsp;</td><td>
<p>Mobile data (EDGE, 3G, etc). </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga3e8773baeb94189b9a1ff27d6a5e3553a05b41bbfd369f9030a7daafc9395116e"></a><!-- doxytag: member="SP_CONNECTION_TYPE_MOBILE_ROAMING" ref="gga3e8773baeb94189b9a1ff27d6a5e3553a05b41bbfd369f9030a7daafc9395116e" args="" -->SP_CONNECTION_TYPE_MOBILE_ROAMING</em>&nbsp;</td><td>
<p>Roamed mobile data (EDGE, 3G, etc). </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga3e8773baeb94189b9a1ff27d6a5e3553a31d2cad7379f1bc2eeedd24c40541cb9"></a><!-- doxytag: member="SP_CONNECTION_TYPE_WIFI" ref="gga3e8773baeb94189b9a1ff27d6a5e3553a31d2cad7379f1bc2eeedd24c40541cb9" args="" -->SP_CONNECTION_TYPE_WIFI</em>&nbsp;</td><td>
<p>Wireless connection. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga3e8773baeb94189b9a1ff27d6a5e3553a4f9f0c09e59af4114bb369ebcc474710"></a><!-- doxytag: member="SP_CONNECTION_TYPE_WIRED" ref="gga3e8773baeb94189b9a1ff27d6a5e3553a4f9f0c09e59af4114bb369ebcc474710" args="" -->SP_CONNECTION_TYPE_WIRED</em>&nbsp;</td><td>
<p>Ethernet cable, etc. </p>
</td></tr>
</table>
</dd>
</dl>

</div>
</div>
<a class="anchor" id="gabf77bb5a124d5a6ee9a12c86abbc0d34"></a><!-- doxytag: member="api.h::sp_connectionstate" ref="gabf77bb5a124d5a6ee9a12c86abbc0d34" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="group__session.html#gabf77bb5a124d5a6ee9a12c86abbc0d34">sp_connectionstate</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Describes the current state of the connection </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="ggabf77bb5a124d5a6ee9a12c86abbc0d34ae31e9958a98211ecff5ecbcf7041dfa5"></a><!-- doxytag: member="SP_CONNECTION_STATE_LOGGED_OUT" ref="ggabf77bb5a124d5a6ee9a12c86abbc0d34ae31e9958a98211ecff5ecbcf7041dfa5" args="" -->SP_CONNECTION_STATE_LOGGED_OUT</em>&nbsp;</td><td>
<p>User not yet logged in. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabf77bb5a124d5a6ee9a12c86abbc0d34a88ae17b4168184e62e4c190c289c47c5"></a><!-- doxytag: member="SP_CONNECTION_STATE_LOGGED_IN" ref="ggabf77bb5a124d5a6ee9a12c86abbc0d34a88ae17b4168184e62e4c190c289c47c5" args="" -->SP_CONNECTION_STATE_LOGGED_IN</em>&nbsp;</td><td>
<p>Logged in against a Spotify access point. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabf77bb5a124d5a6ee9a12c86abbc0d34ad1a6eb721675af4613f823c091538a8c"></a><!-- doxytag: member="SP_CONNECTION_STATE_DISCONNECTED" ref="ggabf77bb5a124d5a6ee9a12c86abbc0d34ad1a6eb721675af4613f823c091538a8c" args="" -->SP_CONNECTION_STATE_DISCONNECTED</em>&nbsp;</td><td>
<p>Was logged in, but has now been disconnected. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabf77bb5a124d5a6ee9a12c86abbc0d34a4ddf57518007eef86b06f496d7059484"></a><!-- doxytag: member="SP_CONNECTION_STATE_UNDEFINED" ref="ggabf77bb5a124d5a6ee9a12c86abbc0d34a4ddf57518007eef86b06f496d7059484" args="" -->SP_CONNECTION_STATE_UNDEFINED</em>&nbsp;</td><td>
<p>The connection state is undefined. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggabf77bb5a124d5a6ee9a12c86abbc0d34a63099ef9185ba287fcd2e77be3c47d8f"></a><!-- doxytag: member="SP_CONNECTION_STATE_OFFLINE" ref="ggabf77bb5a124d5a6ee9a12c86abbc0d34a63099ef9185ba287fcd2e77be3c47d8f" args="" -->SP_CONNECTION_STATE_OFFLINE</em>&nbsp;</td><td>
<p>Logged in in offline mode. </p>
</td></tr>
</table>
</dd>
</dl>

</div>
</div>
<a class="anchor" id="ga61bc424465d776af3ceeb69eee2bb492"></a><!-- doxytag: member="api.h::sp_image_size" ref="ga61bc424465d776af3ceeb69eee2bb492" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="group__session.html#ga61bc424465d776af3ceeb69eee2bb492">sp_image_size</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Image size </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="gga61bc424465d776af3ceeb69eee2bb492ad20c808fd1f8180d1f49f643975d1dd7"></a><!-- doxytag: member="SP_IMAGE_SIZE_NORMAL" ref="gga61bc424465d776af3ceeb69eee2bb492ad20c808fd1f8180d1f49f643975d1dd7" args="" -->SP_IMAGE_SIZE_NORMAL</em>&nbsp;</td><td>
<p>Normal image size. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga61bc424465d776af3ceeb69eee2bb492ab9340b1bcf2129c3ad1328ea617d547f"></a><!-- doxytag: member="SP_IMAGE_SIZE_SMALL" ref="gga61bc424465d776af3ceeb69eee2bb492ab9340b1bcf2129c3ad1328ea617d547f" args="" -->SP_IMAGE_SIZE_SMALL</em>&nbsp;</td><td>
<p>Small image size. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga61bc424465d776af3ceeb69eee2bb492a0a0b624afbb2a66ee3d7954202b89721"></a><!-- doxytag: member="SP_IMAGE_SIZE_LARGE" ref="gga61bc424465d776af3ceeb69eee2bb492a0a0b624afbb2a66ee3d7954202b89721" args="" -->SP_IMAGE_SIZE_LARGE</em>&nbsp;</td><td>
<p>Large image size. </p>
</td></tr>
</table>
</dd>
</dl>

</div>
</div>
<a class="anchor" id="ga811fa52ed0fdb5cda732682e27e40417"></a><!-- doxytag: member="api.h::sp_playlist_offline_status" ref="ga811fa52ed0fdb5cda732682e27e40417" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="group__session.html#ga811fa52ed0fdb5cda732682e27e40417">sp_playlist_offline_status</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Playlist offline status </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="gga811fa52ed0fdb5cda732682e27e40417abef62e4e3a4af8827fed7fe3aa733ca0"></a><!-- doxytag: member="SP_PLAYLIST_OFFLINE_STATUS_NO" ref="gga811fa52ed0fdb5cda732682e27e40417abef62e4e3a4af8827fed7fe3aa733ca0" args="" -->SP_PLAYLIST_OFFLINE_STATUS_NO</em>&nbsp;</td><td>
<p>Playlist is not offline enabled. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga811fa52ed0fdb5cda732682e27e40417affed38ac820e084b96fb48e3d1939584"></a><!-- doxytag: member="SP_PLAYLIST_OFFLINE_STATUS_YES" ref="gga811fa52ed0fdb5cda732682e27e40417affed38ac820e084b96fb48e3d1939584" args="" -->SP_PLAYLIST_OFFLINE_STATUS_YES</em>&nbsp;</td><td>
<p>Playlist is synchronized to local storage. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga811fa52ed0fdb5cda732682e27e40417abc999c70761d392b26753708e9a2cfa1"></a><!-- doxytag: member="SP_PLAYLIST_OFFLINE_STATUS_DOWNLOADING" ref="gga811fa52ed0fdb5cda732682e27e40417abc999c70761d392b26753708e9a2cfa1" args="" -->SP_PLAYLIST_OFFLINE_STATUS_DOWNLOADING</em>&nbsp;</td><td>
<p>This playlist is currently downloading. Only one playlist can be in this state any given time. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga811fa52ed0fdb5cda732682e27e40417a7d929bbf4f1df3633b283e39b9c95919"></a><!-- doxytag: member="SP_PLAYLIST_OFFLINE_STATUS_WAITING" ref="gga811fa52ed0fdb5cda732682e27e40417a7d929bbf4f1df3633b283e39b9c95919" args="" -->SP_PLAYLIST_OFFLINE_STATUS_WAITING</em>&nbsp;</td><td>
<p>Playlist is queued for download. </p>
</td></tr>
</table>
</dd>
</dl>

</div>
</div>
<a class="anchor" id="gafdd7117213605e6f2671c4f289b44609"></a><!-- doxytag: member="api.h::sp_playlist_type" ref="gafdd7117213605e6f2671c4f289b44609" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="group__session.html#gafdd7117213605e6f2671c4f289b44609">sp_playlist_type</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Playlist types </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="ggafdd7117213605e6f2671c4f289b44609a6bd6bf9b62018fa9bbf969835c2f3077"></a><!-- doxytag: member="SP_PLAYLIST_TYPE_PLAYLIST" ref="ggafdd7117213605e6f2671c4f289b44609a6bd6bf9b62018fa9bbf969835c2f3077" args="" -->SP_PLAYLIST_TYPE_PLAYLIST</em>&nbsp;</td><td>
<p>A normal playlist. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafdd7117213605e6f2671c4f289b44609a4d3266991787f9438deb9de83d9200da"></a><!-- doxytag: member="SP_PLAYLIST_TYPE_START_FOLDER" ref="ggafdd7117213605e6f2671c4f289b44609a4d3266991787f9438deb9de83d9200da" args="" -->SP_PLAYLIST_TYPE_START_FOLDER</em>&nbsp;</td><td>
<p>Marks a folder starting point,. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafdd7117213605e6f2671c4f289b44609a3ec52ad1d99d8e32e1b9de31e3f5187a"></a><!-- doxytag: member="SP_PLAYLIST_TYPE_END_FOLDER" ref="ggafdd7117213605e6f2671c4f289b44609a3ec52ad1d99d8e32e1b9de31e3f5187a" args="" -->SP_PLAYLIST_TYPE_END_FOLDER</em>&nbsp;</td><td>
<p>and ending point. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggafdd7117213605e6f2671c4f289b44609ad4f860ef76154e3e2c0d9da2f57a2784"></a><!-- doxytag: member="SP_PLAYLIST_TYPE_PLACEHOLDER" ref="ggafdd7117213605e6f2671c4f289b44609ad4f860ef76154e3e2c0d9da2f57a2784" args="" -->SP_PLAYLIST_TYPE_PLACEHOLDER</em>&nbsp;</td><td>
<p>Unknown entry. </p>
</td></tr>
</table>
</dd>
</dl>

</div>
</div>
<a class="anchor" id="ga087d21080010768316cfb55d938eb94d"></a><!-- doxytag: member="api.h::sp_sampletype" ref="ga087d21080010768316cfb55d938eb94d" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="group__session.html#ga087d21080010768316cfb55d938eb94d">sp_sampletype</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Sample type descriptor </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="gga087d21080010768316cfb55d938eb94daa829b269d191cca95ecb02c2bc59da42"></a><!-- doxytag: member="SP_SAMPLETYPE_INT16_NATIVE_ENDIAN" ref="gga087d21080010768316cfb55d938eb94daa829b269d191cca95ecb02c2bc59da42" args="" -->SP_SAMPLETYPE_INT16_NATIVE_ENDIAN</em>&nbsp;</td><td>
<p>16-bit signed integer samples </p>
</td></tr>
</table>
</dd>
</dl>

</div>
</div>
<a class="anchor" id="ga99e8e9176ce40fff08a9be8b944edb09"></a><!-- doxytag: member="api.h::sp_search_type" ref="ga99e8e9176ce40fff08a9be8b944edb09" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="group__session.html#ga99e8e9176ce40fff08a9be8b944edb09">sp_search_type</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Search types </p>

</div>
</div>
<a class="anchor" id="gaeaa41aad3c0047409996a6ec3b03203f"></a><!-- doxytag: member="api.h::sp_track_offline_status" ref="gaeaa41aad3c0047409996a6ec3b03203f" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="group__session.html#gaeaa41aad3c0047409996a6ec3b03203f">sp_track_offline_status</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Track offline status </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="ggaeaa41aad3c0047409996a6ec3b03203faad1a1cba82ce9f9be678f4d1042eddec"></a><!-- doxytag: member="SP_TRACK_OFFLINE_NO" ref="ggaeaa41aad3c0047409996a6ec3b03203faad1a1cba82ce9f9be678f4d1042eddec" args="" -->SP_TRACK_OFFLINE_NO</em>&nbsp;</td><td>
<p>Not marked for offline. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggaeaa41aad3c0047409996a6ec3b03203fa1fdd2a518dcdc072cfca27a0ca4f2581"></a><!-- doxytag: member="SP_TRACK_OFFLINE_WAITING" ref="ggaeaa41aad3c0047409996a6ec3b03203fa1fdd2a518dcdc072cfca27a0ca4f2581" args="" -->SP_TRACK_OFFLINE_WAITING</em>&nbsp;</td><td>
<p>Waiting for download. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggaeaa41aad3c0047409996a6ec3b03203fa7dcf6dfc56a8421200451d07a476f370"></a><!-- doxytag: member="SP_TRACK_OFFLINE_DOWNLOADING" ref="ggaeaa41aad3c0047409996a6ec3b03203fa7dcf6dfc56a8421200451d07a476f370" args="" -->SP_TRACK_OFFLINE_DOWNLOADING</em>&nbsp;</td><td>
<p>Currently downloading. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggaeaa41aad3c0047409996a6ec3b03203fac54d46cbc73de7686a1ad8daf269532a"></a><!-- doxytag: member="SP_TRACK_OFFLINE_DONE" ref="ggaeaa41aad3c0047409996a6ec3b03203fac54d46cbc73de7686a1ad8daf269532a" args="" -->SP_TRACK_OFFLINE_DONE</em>&nbsp;</td><td>
<p>Downloaded OK and can be played. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggaeaa41aad3c0047409996a6ec3b03203fa86618798c266540bdc889dd037a52631"></a><!-- doxytag: member="SP_TRACK_OFFLINE_ERROR" ref="ggaeaa41aad3c0047409996a6ec3b03203fa86618798c266540bdc889dd037a52631" args="" -->SP_TRACK_OFFLINE_ERROR</em>&nbsp;</td><td>
<p>Error during download. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggaeaa41aad3c0047409996a6ec3b03203fa00fe430030fb6a8a49a46c11cca7326c"></a><!-- doxytag: member="SP_TRACK_OFFLINE_DONE_EXPIRED" ref="ggaeaa41aad3c0047409996a6ec3b03203fa00fe430030fb6a8a49a46c11cca7326c" args="" -->SP_TRACK_OFFLINE_DONE_EXPIRED</em>&nbsp;</td><td>
<p>Downloaded OK but not playable due to expiery. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggaeaa41aad3c0047409996a6ec3b03203fa405a9b7a3fa489ad2dadbb108794e247"></a><!-- doxytag: member="SP_TRACK_OFFLINE_LIMIT_EXCEEDED" ref="ggaeaa41aad3c0047409996a6ec3b03203fa405a9b7a3fa489ad2dadbb108794e247" args="" -->SP_TRACK_OFFLINE_LIMIT_EXCEEDED</em>&nbsp;</td><td>
<p>Waiting because device have reached max number of allowed tracks. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="ggaeaa41aad3c0047409996a6ec3b03203fa5f3e19627de4509ae4a3864fd29edee6"></a><!-- doxytag: member="SP_TRACK_OFFLINE_DONE_RESYNC" ref="ggaeaa41aad3c0047409996a6ec3b03203fa5f3e19627de4509ae4a3864fd29edee6" args="" -->SP_TRACK_OFFLINE_DONE_RESYNC</em>&nbsp;</td><td>
<p>Downloaded OK and available but scheduled for re-download. </p>
</td></tr>
</table>
</dd>
</dl>

</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="gad6cee58fa44453b7a4fd2ae2266df055"></a><!-- doxytag: member="api.h::sp_offline_num_playlists" ref="gad6cee58fa44453b7a4fd2ae2266df055" args="(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_offline_num_playlists </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return number of playlisys that is marked for offline synchronization</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of playlists </dd></dl>

</div>
</div>
<a class="anchor" id="ga02525cd659a34728047cd3801049e822"></a><!-- doxytag: member="api.h::sp_offline_sync_get_status" ref="ga02525cd659a34728047cd3801049e822" args="(sp_session *session, sp_offline_sync_status *status)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_offline_sync_get_status </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="structsp__offline__sync__status.html">sp_offline_sync_status</a> *&nbsp;</td>
          <td class="paramname"> <em>status</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return offline synchronization status. When the internal status is updated the offline_status_updated() callback will be invoked.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[out]</tt>&nbsp;</td><td valign="top"><em>status</em>&nbsp;</td><td>Status object that will be filled with info</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>false if no synching is in progress (in which case the contents of status is undefined) </dd></dl>

</div>
</div>
<a class="anchor" id="gac36816dc42825db9a5a2fbd2694f20af"></a><!-- doxytag: member="api.h::sp_offline_time_left" ref="gac36816dc42825db9a5a2fbd2694f20af" args="(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_offline_time_left </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return remaining time (in seconds) until the offline key store expires and the user is required to relogin</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Seconds until expiration </dd></dl>

</div>
</div>
<a class="anchor" id="gaf535124b4208c279cb98a061834e6411"></a><!-- doxytag: member="api.h::sp_offline_tracks_to_sync" ref="gaf535124b4208c279cb98a061834e6411" args="(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_offline_tracks_to_sync </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Get total number of tracks that needs download before everything from all playlists that is marked for offline is fully synchronized</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of tracks </dd></dl>

</div>
</div>
<a class="anchor" id="ga34a7c9527705ab7d23b742006d81ea35"></a><!-- doxytag: member="api.h::sp_session_connectionstate" ref="ga34a7c9527705ab7d23b742006d81ea35" args="(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__session.html#gabf77bb5a124d5a6ee9a12c86abbc0d34">sp_connectionstate</a> sp_session_connectionstate </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>The connection state of the specified session.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Your session object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The connection state - see the sp_connectionstate enum for possible values </dd></dl>

</div>
</div>
<a class="anchor" id="gaf2891f2daced4ff6da84219d6376b3aa"></a><!-- doxytag: member="api.h::sp_session_create" ref="gaf2891f2daced4ff6da84219d6376b3aa" args="(const sp_session_config *config, sp_session **sess)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_create </td>
          <td>(</td>
          <td class="paramtype">const <a class="el" href="structsp__session__config.html">sp_session_config</a> *&nbsp;</td>
          <td class="paramname"> <em>config</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> **&nbsp;</td>
          <td class="paramname"> <em>sess</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Initialize a session. The session returned will be initialized, but you will need to log in before you can perform any other operation Currently it is not supported to have multiple active sessions, and it's recommended to only call this once per process.</p>
<p>Here is a snippet from <code>spshell.c:</code>  <div class="fragment"><pre class="fragment">    config.api_version = SPOTIFY_API_VERSION;

    <span class="comment">// The path of the directory to store the cache. This must be specified.</span>
    <span class="comment">// Please read the documentation on preferred values.</span>
    config.cache_location = selftest ? <span class="stringliteral">&quot;&quot;</span> : <span class="stringliteral">&quot;tmp&quot;</span>;

    <span class="comment">// The path of the directory to store the settings. </span>
    <span class="comment">// This must be specified.</span>
    <span class="comment">// Please read the documentation on preferred values.</span>
    config.settings_location = selftest ? <span class="stringliteral">&quot;&quot;</span> : <span class="stringliteral">&quot;tmp&quot;</span>;

    <span class="comment">// The key of the application. They are generated by Spotify,</span>
    <span class="comment">// and are specific to each application using libspotify.</span>
    config.application_key = g_appkey;
    config.application_key_size = g_appkey_size;

    <span class="comment">// This identifies the application using some</span>
    <span class="comment">// free-text string [1, 255] characters.</span>
    config.user_agent = <span class="stringliteral">&quot;spshell&quot;</span>;

<span class="comment">//ifdef SP_WITH_CURL</span>
<span class="preprocessor">#ifdef SP_WITH_CURL</span>
<span class="preprocessor"></span>    config.ca_certs_filename = <span class="stringliteral">&quot;../cacerts.pem&quot;</span>;
<span class="preprocessor">#endif</span>
<span class="preprocessor"></span><span class="comment">//endif</span>

    <span class="comment">// Register the callbacks.</span>
    callbacks.logged_in = logged_in;
    callbacks.logged_out = logged_out;
    callbacks.metadata_updated = metadata_updated;
    callbacks.connection_error = connection_error;
    callbacks.notify_main_thread = notify_main_thread;
<span class="preprocessor">#if WITH_TEST_COMMAND</span>
<span class="preprocessor"></span>    callbacks.music_delivery = music_delivery;
    callbacks.play_token_lost = play_token_lost;
    callbacks.end_of_track = end_of_track;
<span class="preprocessor">#endif</span>
<span class="preprocessor"></span>    callbacks.log_message = log_message;
    callbacks.offline_status_updated = offline_status_updated;
    callbacks.credentials_blob_updated = credentials_blob_updated;
<span class="comment">//ifdef SP_LIBSPOTIFY_WITH_SCROBBLING</span>
<span class="preprocessor">#ifdef SP_LIBSPOTIFY_WITH_SCROBBLING</span>
<span class="preprocessor"></span>    callbacks.scrobble_error = scrobble_error;
    callbacks.private_session_mode_changed = private_session_mode_changed;
<span class="preprocessor">#endif</span>
<span class="preprocessor"></span><span class="comment">//endif</span>
    config.callbacks = &amp;callbacks;

    error = <a class="code" href="group__session.html#gaf2891f2daced4ff6da84219d6376b3aa">sp_session_create</a>(&amp;config, &amp;session);
    <span class="keywordflow">if</span> (<a class="code" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba16cb277dc84328e4b2c0cf6d5a0c0b8d" title="No errors encountered.">SP_ERROR_OK</a> != error) {
        fprintf(stderr, <span class="stringliteral">&quot;failed to create session: %s\n&quot;</span>,
                        <a class="code" href="group__error.html#ga983dee341d3c2008830513b7cffe7bf3">sp_error_message</a>(error));
        <span class="keywordflow">return</span> 2;
    }
</pre></div></p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>config</em>&nbsp;</td><td>The configuration to use for the session </td></tr>
    <tr><td valign="top"><tt>[out]</tt>&nbsp;</td><td valign="top"><em>sess</em>&nbsp;</td><td>If successful, a new session - otherwise NULL</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_BAD_API_VERSION SP_ERROR_BAD_USER_AGENT SP_ERROR_BAD_APPLICATION_KEY SP_ERROR_API_INITIALIZATION_FAILED SP_ERROR_INVALID_DEVICE_ID </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="jukebox_8c-example.html#a25">jukebox.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga34005bb06ee3de8ee4221597a0335cca"></a><!-- doxytag: member="api.h::sp_session_flush_caches" ref="ga34005bb06ee3de8ee4221597a0335cca" args="(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_flush_caches </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Flush the caches</p>
<p>This will make libspotify write all data that is meant to be stored on disk to the disk immediately. libspotify does this periodically by itself and also on logout. So under normal conditions this should never need to be used.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Your session object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="ga61e6b796d9e07682c018e888b901a191"></a><!-- doxytag: member="api.h::sp_session_forget_me" ref="ga61e6b796d9e07682c018e888b901a191" args="(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_forget_me </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Remove stored credentials in libspotify. If no credentials are currently stored, nothing will happen.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Your session object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="ga7913df06394360f255c77fb87af0f1fe"></a><!-- doxytag: member="api.h::sp_session_get_volume_normalization" ref="ga7913df06394360f255c77fb87af0f1fe" args="(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_session_get_volume_normalization </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return status of volume normalization</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>true iff volume normalization is enabled </dd></dl>

</div>
</div>
<a class="anchor" id="gac72ccb51031c846101134b73195bb9ec"></a><!-- doxytag: member="api.h::sp_session_inbox_create" ref="gac72ccb51031c846101134b73195bb9ec" args="(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a>* sp_session_inbox_create </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Returns an inbox playlist for the currently logged in user</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A playlist or NULL if no user is logged in </dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>You need to release the playlist when you are done with it. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__playlist.html#gacb9250eb530869b039541a8b62dfab6c">sp_playlist_release()</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga72702ee06bc96c074804388d24344149"></a><!-- doxytag: member="api.h::sp_session_is_private_session" ref="ga72702ee06bc96c074804388d24344149" args="(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_session_is_private_session </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return True if private session is enabled</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>True if private session is enabled </dd></dl>

</div>
</div>
<a class="anchor" id="ga6a56bc82ff0b369bb6e0f035534ce33d"></a><!-- doxytag: member="api.h::sp_session_is_scrobbling" ref="ga6a56bc82ff0b369bb6e0f035534ce33d" args="(sp_session *session, sp_social_provider provider, sp_scrobbling_state *state)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_is_scrobbling </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">sp_social_provider&nbsp;</td>
          <td class="paramname"> <em>provider</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">sp_scrobbling_state *&nbsp;</td>
          <td class="paramname"> <em>state</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the scrobbling state. This makes it possible to find out if scrobbling is locally overrided or if the global setting is used.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>provider</em>&nbsp;</td><td>The scrobbling provider referred to </td></tr>
    <tr><td valign="top"><tt>[out]</tt>&nbsp;</td><td valign="top"><em>state</em>&nbsp;</td><td>The output variable receiving the sp_scrobbling_state state</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>error code </dd></dl>

</div>
</div>
<a class="anchor" id="ga0fad03ceabcf8d68af78f0f35fcbcc8d"></a><!-- doxytag: member="api.h::sp_session_is_scrobbling_possible" ref="ga0fad03ceabcf8d68af78f0f35fcbcc8d" args="(sp_session *session, sp_social_provider provider, bool *out)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_is_scrobbling_possible </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">sp_social_provider&nbsp;</td>
          <td class="paramname"> <em>provider</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">bool *&nbsp;</td>
          <td class="paramname"> <em>out</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return True if scrobbling settings should be shown to the user. Currently this setting is relevant only to the facebook provider. The returned value may be false if the user is not connected to facebook, or if the user has opted out from facebook social graph.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>provider</em>&nbsp;</td><td>The scrobbling provider referred to </td></tr>
    <tr><td valign="top"><tt>[out]</tt>&nbsp;</td><td valign="top"><em>out</em>&nbsp;</td><td>True iff scrobbling is possible</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>error code </dd></dl>

</div>
</div>
<a class="anchor" id="ga4533a992a120cacb109c892a852afe2a"></a><!-- doxytag: member="api.h::sp_session_login" ref="ga4533a992a120cacb109c892a852afe2a" args="(sp_session *session, const char *username, const char *password, bool remember_me, const char *blob)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_login </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>username</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>password</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">bool&nbsp;</td>
          <td class="paramname"> <em>remember_me</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>blob</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Logs in the specified username/password combo. This initiates the login in the background. A callback is called when login is complete</p>
<p>An application MUST NEVER store the user's password in clear text. If automatic relogin is required, use <a class="el" href="group__session.html#gae1bc9bebd230226c3d48925cd1be6edf">sp_session_relogin()</a></p>
<p>Here is a snippet from <code>spshell.c:</code>  <div class="fragment"><pre class="fragment">        <a class="code" href="group__session.html#ga4533a992a120cacb109c892a852afe2a">sp_session_login</a>(session, username, password, 1, blob);
    }
</pre></div></p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Your session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>username</em>&nbsp;</td><td>The username to log in </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>password</em>&nbsp;</td><td>The password for the specified username </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>remember_me</em>&nbsp;</td><td>If set, the username / password will be remembered by libspotify </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>blob</em>&nbsp;</td><td>If you have received a blob in the credentials_blob_updated you can pas this here instead of password </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="jukebox_8c-example.html#a26">jukebox.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gab7f08ca0939985b30ae2d1ed9db1d726"></a><!-- doxytag: member="api.h::sp_session_logout" ref="gab7f08ca0939985b30ae2d1ed9db1d726" args="(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_logout </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Logs out the currently logged in user</p>
<p>Always call this before terminating the application and libspotify is currently logged in. Otherwise, the settings and cache may be lost.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Your session object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="gac73bf2c569a43d824439b557d5e4b293"></a><!-- doxytag: member="api.h::sp_session_player_load" ref="gac73bf2c569a43d824439b557d5e4b293" args="(sp_session *session, sp_track *track)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_player_load </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td>
          <td class="paramname"> <em>track</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Loads the specified track</p>
<p>After successfully loading the track, you have the option of running <a class="el" href="group__session.html#gab66c5915967e4f90db945b118e620624">sp_session_player_play()</a> directly, or using <a class="el" href="group__session.html#ga3430cd4f11541868d3f83eaa31aecf44">sp_session_player_seek()</a> first. When this call returns, the track will have been loaded, unless an error occurred.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Your session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track</em>&nbsp;</td><td>The track to be loaded</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_MISSING_CALLBACK SP_ERROR_TRACK_NOT_PLAYABLE </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="jukebox_8c-example.html#a6">jukebox.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gab66c5915967e4f90db945b118e620624"></a><!-- doxytag: member="api.h::sp_session_player_play" ref="gab66c5915967e4f90db945b118e620624" args="(sp_session *session, bool play)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_player_play </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">bool&nbsp;</td>
          <td class="paramname"> <em>play</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Play or pause the currently loaded track</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Your session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>play</em>&nbsp;</td><td>If set to true, playback will occur. If set to false, the playback will be paused. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="jukebox_8c-example.html#a7">jukebox.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gaf42e30a1f430ac7c436c7d9f0485368d"></a><!-- doxytag: member="api.h::sp_session_player_prefetch" ref="gaf42e30a1f430ac7c436c7d9f0485368d" args="(sp_session *session, sp_track *track)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_player_prefetch </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td>
          <td class="paramname"> <em>track</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Prefetch a track</p>
<p>Instruct libspotify to start loading of a track into its cache. This could be done by an application just before the current track ends.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Your session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track</em>&nbsp;</td><td>The track to be prefetched</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_NO_CACHE SP_ERROR_OK</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Prefetching is only possible if a cache is configured </dd></dl>

</div>
</div>
<a class="anchor" id="ga3430cd4f11541868d3f83eaa31aecf44"></a><!-- doxytag: member="api.h::sp_session_player_seek" ref="ga3430cd4f11541868d3f83eaa31aecf44" args="(sp_session *session, int offset)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_player_seek </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>offset</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Seek to position in the currently loaded track</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Your session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>offset</em>&nbsp;</td><td>Track position, in milliseconds. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="gafa7ee2803f119451bb8be3bf28746975"></a><!-- doxytag: member="api.h::sp_session_player_unload" ref="gafa7ee2803f119451bb8be3bf28746975" args="(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_player_unload </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Stops the currently playing track</p>
<p>This frees some resources held by libspotify to identify the currently playing track.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Your session object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="jukebox_8c-example.html#a2">jukebox.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga319767f0b795f1c46a08390b587c5671"></a><!-- doxytag: member="api.h::sp_session_playlistcontainer" ref="ga319767f0b795f1c46a08390b587c5671" args="(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a>* sp_session_playlistcontainer </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Returns the playlist container for the currently logged in user.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Your session object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Playlist container object, NULL if not logged in </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="jukebox_8c-example.html#a14">jukebox.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gacd590e095b011af42fb10046117846fe"></a><!-- doxytag: member="api.h::sp_session_preferred_bitrate" ref="gacd590e095b011af42fb10046117846fe" args="(sp_session *session, sp_bitrate bitrate)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_preferred_bitrate </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__session.html#ga77ddd919314a7bb16140569af7a38fe2">sp_bitrate</a>&nbsp;</td>
          <td class="paramname"> <em>bitrate</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Set preferred bitrate for music streaming</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>bitrate</em>&nbsp;</td><td>Preferred bitrate, see <a class="el" href="group__session.html#ga83d3de45241a44e787410993c5fac0ea">sp_bitrate</a> for possible values </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_INVALID_ARGUMENT </dd></dl>

</div>
</div>
<a class="anchor" id="ga4bba5f828d6c87692f2c355cc8f07c61"></a><!-- doxytag: member="api.h::sp_session_preferred_offline_bitrate" ref="ga4bba5f828d6c87692f2c355cc8f07c61" args="(sp_session *session, sp_bitrate bitrate, bool allow_resync)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_preferred_offline_bitrate </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__session.html#ga77ddd919314a7bb16140569af7a38fe2">sp_bitrate</a>&nbsp;</td>
          <td class="paramname"> <em>bitrate</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">bool&nbsp;</td>
          <td class="paramname"> <em>allow_resync</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Set preferred bitrate for offline sync</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>bitrate</em>&nbsp;</td><td>Preferred bitrate, see <a class="el" href="group__session.html#ga83d3de45241a44e787410993c5fac0ea">sp_bitrate</a> for possible values </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>allow_resync</em>&nbsp;</td><td>Set to true if libspotify should resynchronize already synchronized tracks. Usually you should set this to false. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_INVALID_ARGUMENT </dd></dl>

</div>
</div>
<a class="anchor" id="gaff27cb730db6debf55e750e39e7fadd7"></a><!-- doxytag: member="api.h::sp_session_process_events" ref="gaff27cb730db6debf55e750e39e7fadd7" args="(sp_session *session, int *next_timeout)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_process_events </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int *&nbsp;</td>
          <td class="paramname"> <em>next_timeout</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Make the specified session process any pending events</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Your session object </td></tr>
    <tr><td valign="top"><tt>[out]</tt>&nbsp;</td><td valign="top"><em>next_timeout</em>&nbsp;</td><td>Stores the time (in milliseconds) until you should call this function again </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="jukebox_8c-example.html#a27">jukebox.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga4ad3a1de596a41f275120dad3bb4685d"></a><!-- doxytag: member="api.h::sp_session_publishedcontainer_for_user_create" ref="ga4ad3a1de596a41f275120dad3bb4685d" args="(sp_session *session, const char *canonical_username)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a>* sp_session_publishedcontainer_for_user_create </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>canonical_username</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the published container for a given <em>canonical_username</em>, or the currently logged in user if <em>canonical_username</em> is NULL.</p>
<p>When done with the list you should call sp_playlistconatiner_release() to decrese the reference you own by having created it.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Your session object. </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>canonical_username</em>&nbsp;</td><td>The canonical username, or NULL.</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Playlist container object, NULL if not logged in. </dd></dl>

</div>
</div>
<a class="anchor" id="gab81c540b76f7425a9cc0dbf270c09674"></a><!-- doxytag: member="api.h::sp_session_release" ref="gab81c540b76f7425a9cc0dbf270c09674" args="(sp_session *sess)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_release </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>sess</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Release the session. This will clean up all data and connections associated with the session</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>sess</em>&nbsp;</td><td>Session object returned from <a class="el" href="group__session.html#gaf2891f2daced4ff6da84219d6376b3aa">sp_session_create()</a> </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="gae1bc9bebd230226c3d48925cd1be6edf"></a><!-- doxytag: member="api.h::sp_session_relogin" ref="gae1bc9bebd230226c3d48925cd1be6edf" args="(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_relogin </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Log in the remembered user if last user that logged in logged in with remember_me set. If no credentials are stored, this will return SP_ERROR_NO_CREDENTIALS.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Your session object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_NO_CREDENTIALS </dd></dl>

</div>
</div>
<a class="anchor" id="gab349c7bfe59e10e167bd75c20df9fc97"></a><!-- doxytag: member="api.h::sp_session_remembered_user" ref="gab349c7bfe59e10e167bd75c20df9fc97" args="(sp_session *session, char *buffer, size_t buffer_size)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_session_remembered_user </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">char *&nbsp;</td>
          <td class="paramname"> <em>buffer</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">size_t&nbsp;</td>
          <td class="paramname"> <em>buffer_size</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Get username of the user that will be logged in via <a class="el" href="group__session.html#gae1bc9bebd230226c3d48925cd1be6edf">sp_session_relogin()</a></p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Your session object </td></tr>
    <tr><td valign="top"><tt>[out]</tt>&nbsp;</td><td valign="top"><em>buffer</em>&nbsp;</td><td>The buffer to hold the username </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>buffer_size</em>&nbsp;</td><td>The max size of the buffer that will hold the username. The resulting string is guaranteed to always be null terminated if buffer_size &gt; 0</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The number of characters in the username. If value is greater or equal than <code>buffer_size</code>, output was truncated. If returned value is -1 no credentials are stored in libspotify. </dd></dl>

</div>
</div>
<a class="anchor" id="ga6f27c55d1ce9f3f794fcce7bee7adfea"></a><!-- doxytag: member="api.h::sp_session_set_cache_size" ref="ga6f27c55d1ce9f3f794fcce7bee7adfea" args="(sp_session *session, size_t size)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_set_cache_size </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">size_t&nbsp;</td>
          <td class="paramname"> <em>size</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Set maximum cache size.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Your session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>size</em>&nbsp;</td><td>Maximum cache size in megabytes. Setting it to 0 (the default) will let libspotify automatically resize the cache (10% of disk free space) </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="ga0ac85299c37710321b6d64713e1d6ba8"></a><!-- doxytag: member="api.h::sp_session_set_connection_rules" ref="ga0ac85299c37710321b6d64713e1d6ba8" args="(sp_session *session, sp_connection_rules rules)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_set_connection_rules </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__session.html#gad275d696685b2ad9ff1a2c3e16af6502">sp_connection_rules</a>&nbsp;</td>
          <td class="paramname"> <em>rules</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Set rules for how libspotify connects to Spotify servers and synchronizes offline content</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>rules</em>&nbsp;</td><td>Connection rules</td></tr>
  </table>
  </dd>
</dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Used in conjunction with <a class="el" href="group__session.html#gaf81c61799e0ccdbba048fb79ec050930">sp_session_set_connection_type()</a> to control how libspotify should behave in respect to network activity and offline synchronization. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__session.html#ga24ee483cdceef9af3b415c020b197a75">sp_connection_rules</a> </dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="gaf81c61799e0ccdbba048fb79ec050930"></a><!-- doxytag: member="api.h::sp_session_set_connection_type" ref="gaf81c61799e0ccdbba048fb79ec050930" args="(sp_session *session, sp_connection_type type)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_set_connection_type </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__session.html#ga3e8773baeb94189b9a1ff27d6a5e3553">sp_connection_type</a>&nbsp;</td>
          <td class="paramname"> <em>type</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Set to true if the connection is currently routed over a roamed connectivity</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>type</em>&nbsp;</td><td>Connection type</td></tr>
  </table>
  </dd>
</dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Used in conjunction with <a class="el" href="group__session.html#ga0ac85299c37710321b6d64713e1d6ba8">sp_session_set_connection_rules()</a> to control how libspotify should behave in respect to network activity and offline synchronization. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__session.html#ga05a7dbb946a9c47bf011f3f3d77964c3">sp_connection_type</a> </dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="ga42a8f0999316ac7f141926092879ad2f"></a><!-- doxytag: member="api.h::sp_session_set_private_session" ref="ga42a8f0999316ac7f141926092879ad2f" args="(sp_session *session, bool enabled)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_set_private_session </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">bool&nbsp;</td>
          <td class="paramname"> <em>enabled</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Set if private session is enabled. This disables sharing what the user is listening to to services such as Spotify Social, Facebook and LastFM. The private session will last for a time, and then libspotify will revert to the normal state. The private session is prolonged by user activity.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>enabled</em>&nbsp;</td><td>True iff private session should be enabled </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="ga2475a1fbc2eeacccb96b7f36efd36725"></a><!-- doxytag: member="api.h::sp_session_set_scrobbling" ref="ga2475a1fbc2eeacccb96b7f36efd36725" args="(sp_session *session, sp_social_provider provider, sp_scrobbling_state state)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_set_scrobbling </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">sp_social_provider&nbsp;</td>
          <td class="paramname"> <em>provider</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">sp_scrobbling_state&nbsp;</td>
          <td class="paramname"> <em>state</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Set if scrobbling is enabled. This api allows setting local overrides of the global scrobbling settings. Changing the global settings are currently not supported.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>provider</em>&nbsp;</td><td>The scrobbling provider referred to </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>state</em>&nbsp;</td><td>The state to set the provider to</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>error code</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd>sp_social_provider </dd>
<dd>
sp_scrobbling_state </dd></dl>

</div>
</div>
<a class="anchor" id="ga9e5ee46ef5e75aa462607caac984f2de"></a><!-- doxytag: member="api.h::sp_session_set_social_credentials" ref="ga9e5ee46ef5e75aa462607caac984f2de" args="(sp_session *session, sp_social_provider provider, const char *username, const char *password)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_set_social_credentials </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">sp_social_provider&nbsp;</td>
          <td class="paramname"> <em>provider</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>username</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>password</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Set the user's credentials with a social provider. Currently this is only relevant for LastFm Call sp_session_set_scrobbling to force an authentication attempt with the LastFm server. If authentication fails a scrobble_error callback will be sent.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>provider</em>&nbsp;</td><td>The scrobbling provider referred to </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>username</em>&nbsp;</td><td>The user name </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>password</em>&nbsp;</td><td>The password</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>error code</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__session.html#ga2475a1fbc2eeacccb96b7f36efd36725">sp_session_set_scrobbling</a> </dd>
<dd>
<a class="el" href="structsp__session__callbacks.html#a01a47778439fa233187fdefa75a0f7dc">sp_session_callbacks::scrobble_error</a> </dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="ga4e14f58356d00e3693be84623bf6bd11"></a><!-- doxytag: member="api.h::sp_session_set_volume_normalization" ref="ga4e14f58356d00e3693be84623bf6bd11" args="(sp_session *session, bool on)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_session_set_volume_normalization </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">bool&nbsp;</td>
          <td class="paramname"> <em>on</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Set volume normalization</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>on</em>&nbsp;</td><td>True iff volume normalization should be enabled </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="ga02391c9e28cff0a602f7139542e0238f"></a><!-- doxytag: member="api.h::sp_session_starred_create" ref="ga02391c9e28cff0a602f7139542e0238f" args="(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a>* sp_session_starred_create </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Returns the starred list for the current user</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A playlist or NULL if no user is logged in </dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>You need to release the playlist when you are done with it. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__playlist.html#gacb9250eb530869b039541a8b62dfab6c">sp_playlist_release()</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga9be806a719a6399bfe1fd0d4c125e0eb"></a><!-- doxytag: member="api.h::sp_session_starred_for_user_create" ref="ga9be806a719a6399bfe1fd0d4c125e0eb" args="(sp_session *session, const char *canonical_username)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a>* sp_session_starred_for_user_create </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>canonical_username</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Returns the starred list for a user</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>canonical_username</em>&nbsp;</td><td>Canonical username</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A playlist or NULL if no user is logged in </dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>You need to release the playlist when you are done with it. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__playlist.html#gacb9250eb530869b039541a8b62dfab6c">sp_playlist_release()</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga267bbcae24b6bb1fd56de56678a5f455"></a><!-- doxytag: member="api.h::sp_session_user" ref="ga267bbcae24b6bb1fd56de56678a5f455" args="(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a>* sp_session_user </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Fetches the currently logged in user</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Your session object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The logged in user (or NULL if not logged in) </dd></dl>

</div>
</div>
<a class="anchor" id="ga54c7693afa9be664f3ea870feb0df8d9"></a><!-- doxytag: member="api.h::sp_session_user_country" ref="ga54c7693afa9be664f3ea870feb0df8d9" args="(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_session_user_country </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Get currently logged in users country updated the offline_status_updated() callback will be invoked.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Country encoded in an integer 'SE' = 'S' &lt;&lt; 8 | 'E' </dd></dl>

</div>
</div>
<a class="anchor" id="gac7a365c2166738909cdb901edebc3f70"></a><!-- doxytag: member="api.h::sp_session_user_name" ref="gac7a365c2166738909cdb901edebc3f70" args="(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* sp_session_user_name </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Get a pointer to a string representing the user's login username.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Your session object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A string representing the login username. </dd></dl>

</div>
</div>
<a class="anchor" id="gabfb3f59b20ae0b225e154eb9095152b2"></a><!-- doxytag: member="api.h::sp_session_userdata" ref="gabfb3f59b20ae0b225e154eb9095152b2" args="(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void* sp_session_userdata </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>The userdata associated with the session</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Your session object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The userdata that was passed in on session creation </dd></dl>

</div>
</div>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/group__toplist.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Toplist handling</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#define-members">Defines</a> &#124;
<a href="#typedef-members">Typedefs</a> &#124;
<a href="#enum-members">Enumerations</a> &#124;
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<h1>Toplist handling</h1>  </div>
</div>
<div class="contents">
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="define-members"></a>
Defines</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#gaa078b44491f976af43e4941fd1dd032c">SP_TOPLIST_REGION</a>(a, b)&nbsp;&nbsp;&nbsp;((a) &lt;&lt; 8 | (b))</td></tr>
<tr><td colspan="2"><h2><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#gafe8e94ae23133105f35c03b9e3836a0a">toplistbrowse_complete_cb</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *result, void *userdata)</td></tr>
<tr><td colspan="2"><h2><a name="enum-members"></a>
Enumerations</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#ga220f32522efb2828e4f8ffb949af234a">sp_toplisttype</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__toplist.html#gga220f32522efb2828e4f8ffb949af234aa41523e58badf9e3901beea3f53e5d28e">SP_TOPLIST_TYPE_ARTISTS</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__toplist.html#gga220f32522efb2828e4f8ffb949af234aae8002818ef10eb2c75ec2058ce11cf6b">SP_TOPLIST_TYPE_ALBUMS</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__toplist.html#gga220f32522efb2828e4f8ffb949af234aa6a85f8384ec77cb9cb5746966b0f0e28">SP_TOPLIST_TYPE_TRACKS</a> =  2
<br/>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#ga6fa5cfed2cbb33f2f64542d0b63f6c8d">sp_toplistregion</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__toplist.html#gga6fa5cfed2cbb33f2f64542d0b63f6c8da9e9136541401041c7d5c37708b7a927f">SP_TOPLIST_REGION_EVERYWHERE</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__toplist.html#gga6fa5cfed2cbb33f2f64542d0b63f6c8da6912eff58c71f5c74b78f48af5305375">SP_TOPLIST_REGION_USER</a> =  1
<br/>
 }</td></tr>
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#gac2fe366e0050747438e09cdd22ed0e31">sp_toplistbrowse_create</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__toplist.html#ga220f32522efb2828e4f8ffb949af234a">sp_toplisttype</a> type, <a class="el" href="group__toplist.html#ga6fa5cfed2cbb33f2f64542d0b63f6c8d">sp_toplistregion</a> region, const char *username, <a class="el" href="group__toplist.html#gafe8e94ae23133105f35c03b9e3836a0a">toplistbrowse_complete_cb</a> *callback, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#gaff81156c09d311c4f6a82d28a32d7968">sp_toplistbrowse_is_loaded</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *tlb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#ga9b881929e74d97f64814ae54953ce4d7">sp_toplistbrowse_error</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *tlb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#ga421a19f128e5f3ae4b36e63a133a2a83">sp_toplistbrowse_add_ref</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *tlb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#gac6cf969c9cb6b431aeaa4723820ca8de">sp_toplistbrowse_release</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *tlb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#gae2f5c09fbbf947834b1b1e73461f1fb3">sp_toplistbrowse_num_artists</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *tlb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#ga504cc45074d40c817dffbcc2906ef57f">sp_toplistbrowse_artist</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *tlb, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#ga69f5e70269c1eb08e1ddb1c77bb8c3e3">sp_toplistbrowse_num_albums</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *tlb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#gaa080ace445d269f56942ac3d7f1f157e">sp_toplistbrowse_album</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *tlb, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#gaeb0ddfd565474dc7e444aabebbc119b7">sp_toplistbrowse_num_tracks</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *tlb)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#gaf3d00b8bf089134a4f320a8d3d6ab683">sp_toplistbrowse_track</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *tlb, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__toplist.html#gab9cf87d6b6a8cbd8d36cd6e94a3270ee">sp_toplistbrowse_backend_request_duration</a> (<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *tlb)</td></tr>
</table>
<hr/><h2>Define Documentation</h2>
<a class="anchor" id="gaa078b44491f976af43e4941fd1dd032c"></a><!-- doxytag: member="api.h::SP_TOPLIST_REGION" ref="gaa078b44491f976af43e4941fd1dd032c" args="(a, b)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define SP_TOPLIST_REGION</td>
          <td>(</td>
          <td class="paramtype">&nbsp;</td>
          <td class="paramname">a, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">&nbsp;</td>
          <td class="paramname">b</td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td>&nbsp;&nbsp;&nbsp;((a) &lt;&lt; 8 | (b))</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Convenience macro to create a toplist region. Toplist regions are ISO 3166-1 country codes (in uppercase) encoded in an integer. There are also some reserved codes used to denote non-country regions. See sp_toplistregion</p>
<p>Example: SP_TOPLIST_REGION('S', 'E') for Sweden </p>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="toplist_8c-example.html#a14">toplist.c</a>.</dd>
</dl>
</div>
</div>
<hr/><h2>Typedef Documentation</h2>
<a class="anchor" id="gafe8e94ae23133105f35c03b9e3836a0a"></a><!-- doxytag: member="api.h::toplistbrowse_complete_cb" ref="gafe8e94ae23133105f35c03b9e3836a0a" args="(sp_toplistbrowse *result, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef void <a class="el" href="group__toplist.html#gafe8e94ae23133105f35c03b9e3836a0a">toplistbrowse_complete_cb</a>(<a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *result, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>The type of a callback used in <a class="el" href="group__toplist.html#gac2fe366e0050747438e09cdd22ed0e31">sp_toplistbrowse_create()</a></p>
<p>When the callback is called, the metadata of all tracks belonging to it will have been loaded, so <a class="el" href="group__track.html#ga8b69cf193679c7e00031ae43e61c6a54">sp_track_is_loaded()</a> will return non-zero. The same goes for the similar toplist data.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>result</em>&nbsp;</td><td>The same pointer returned by <a class="el" href="group__toplist.html#gac2fe366e0050747438e09cdd22ed0e31">sp_toplistbrowse_create()</a> </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>The opaque pointer given to <a class="el" href="group__toplist.html#gac2fe366e0050747438e09cdd22ed0e31">sp_toplistbrowse_create()</a> </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<hr/><h2>Enumeration Type Documentation</h2>
<a class="anchor" id="ga6fa5cfed2cbb33f2f64542d0b63f6c8d"></a><!-- doxytag: member="api.h::sp_toplistregion" ref="ga6fa5cfed2cbb33f2f64542d0b63f6c8d" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="group__toplist.html#ga6fa5cfed2cbb33f2f64542d0b63f6c8d">sp_toplistregion</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Special toplist regions </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="gga6fa5cfed2cbb33f2f64542d0b63f6c8da9e9136541401041c7d5c37708b7a927f"></a><!-- doxytag: member="SP_TOPLIST_REGION_EVERYWHERE" ref="gga6fa5cfed2cbb33f2f64542d0b63f6c8da9e9136541401041c7d5c37708b7a927f" args="" -->SP_TOPLIST_REGION_EVERYWHERE</em>&nbsp;</td><td>
<p>Global toplist. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga6fa5cfed2cbb33f2f64542d0b63f6c8da6912eff58c71f5c74b78f48af5305375"></a><!-- doxytag: member="SP_TOPLIST_REGION_USER" ref="gga6fa5cfed2cbb33f2f64542d0b63f6c8da6912eff58c71f5c74b78f48af5305375" args="" -->SP_TOPLIST_REGION_USER</em>&nbsp;</td><td>
<p>Toplist for a given user. </p>
</td></tr>
</table>
</dd>
</dl>

</div>
</div>
<a class="anchor" id="ga220f32522efb2828e4f8ffb949af234a"></a><!-- doxytag: member="api.h::sp_toplisttype" ref="ga220f32522efb2828e4f8ffb949af234a" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="group__toplist.html#ga220f32522efb2828e4f8ffb949af234a">sp_toplisttype</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Toplist types </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="gga220f32522efb2828e4f8ffb949af234aa41523e58badf9e3901beea3f53e5d28e"></a><!-- doxytag: member="SP_TOPLIST_TYPE_ARTISTS" ref="gga220f32522efb2828e4f8ffb949af234aa41523e58badf9e3901beea3f53e5d28e" args="" -->SP_TOPLIST_TYPE_ARTISTS</em>&nbsp;</td><td>
<p>Top artists. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga220f32522efb2828e4f8ffb949af234aae8002818ef10eb2c75ec2058ce11cf6b"></a><!-- doxytag: member="SP_TOPLIST_TYPE_ALBUMS" ref="gga220f32522efb2828e4f8ffb949af234aae8002818ef10eb2c75ec2058ce11cf6b" args="" -->SP_TOPLIST_TYPE_ALBUMS</em>&nbsp;</td><td>
<p>Top albums. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga220f32522efb2828e4f8ffb949af234aa6a85f8384ec77cb9cb5746966b0f0e28"></a><!-- doxytag: member="SP_TOPLIST_TYPE_TRACKS" ref="gga220f32522efb2828e4f8ffb949af234aa6a85f8384ec77cb9cb5746966b0f0e28" args="" -->SP_TOPLIST_TYPE_TRACKS</em>&nbsp;</td><td>
<p>Top tracks. </p>
</td></tr>
</table>
</dd>
</dl>

</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="ga421a19f128e5f3ae4b36e63a133a2a83"></a><!-- doxytag: member="api.h::sp_toplistbrowse_add_ref" ref="ga421a19f128e5f3ae4b36e63a133a2a83" args="(sp_toplistbrowse *tlb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_toplistbrowse_add_ref </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>tlb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Increase the reference count of an toplist browse result</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>tlb</em>&nbsp;</td><td>The toplist browse result object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="gaa080ace445d269f56942ac3d7f1f157e"></a><!-- doxytag: member="api.h::sp_toplistbrowse_album" ref="gaa080ace445d269f56942ac3d7f1f157e" args="(sp_toplistbrowse *tlb, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a>* sp_toplistbrowse_album </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>tlb</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the album at the given index in the given toplist browse object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>tlb</em>&nbsp;</td><td>Toplist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Index of the wanted album. Should be in the interval [0, <a class="el" href="group__toplist.html#ga69f5e70269c1eb08e1ddb1c77bb8c3e3">sp_toplistbrowse_num_albums()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The album at the given index in the given toplist browse object </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="toplist_8c-example.html#a10">toplist.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga504cc45074d40c817dffbcc2906ef57f"></a><!-- doxytag: member="api.h::sp_toplistbrowse_artist" ref="ga504cc45074d40c817dffbcc2906ef57f" args="(sp_toplistbrowse *tlb, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a>* sp_toplistbrowse_artist </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>tlb</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the artist at the given index in the given toplist browse object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>tlb</em>&nbsp;</td><td>Toplist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Index of the wanted artist. Should be in the interval [0, <a class="el" href="group__toplist.html#gae2f5c09fbbf947834b1b1e73461f1fb3">sp_toplistbrowse_num_artists()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The artist at the given index in the given toplist browse object </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="toplist_8c-example.html#a8">toplist.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gab9cf87d6b6a8cbd8d36cd6e94a3270ee"></a><!-- doxytag: member="api.h::sp_toplistbrowse_backend_request_duration" ref="gab9cf87d6b6a8cbd8d36cd6e94a3270ee" args="(sp_toplistbrowse *tlb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_toplistbrowse_backend_request_duration </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>tlb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the time (in ms) that was spent waiting for the Spotify backend to serve the request</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>tlb</em>&nbsp;</td><td>Toplist object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>-1 if the request was served from the local cache If the result is not yet loaded the return value is undefined </dd></dl>

</div>
</div>
<a class="anchor" id="gac2fe366e0050747438e09cdd22ed0e31"></a><!-- doxytag: member="api.h::sp_toplistbrowse_create" ref="gac2fe366e0050747438e09cdd22ed0e31" args="(sp_session *session, sp_toplisttype type, sp_toplistregion region, const char *username, toplistbrowse_complete_cb *callback, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a>* sp_toplistbrowse_create </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__toplist.html#ga220f32522efb2828e4f8ffb949af234a">sp_toplisttype</a>&nbsp;</td>
          <td class="paramname"> <em>type</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__toplist.html#ga6fa5cfed2cbb33f2f64542d0b63f6c8d">sp_toplistregion</a>&nbsp;</td>
          <td class="paramname"> <em>region</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>username</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__toplist.html#gafe8e94ae23133105f35c03b9e3836a0a">toplistbrowse_complete_cb</a> *&nbsp;</td>
          <td class="paramname"> <em>callback</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">void *&nbsp;</td>
          <td class="paramname"> <em>userdata</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Initiate a request for browsing an toplist</p>
<p>The user is responsible for freeing the returned toplist browse using <a class="el" href="group__toplist.html#gac6cf969c9cb6b431aeaa4723820ca8de">sp_toplistbrowse_release()</a>. This can be done in the callback.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>type</em>&nbsp;</td><td>Type of toplist to be browsed. see the sp_toplisttype enum for possible values </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>region</em>&nbsp;</td><td>Region. see sp_toplistregion enum. Country specific regions are coded as two chars in an integer. Sweden would correspond to 'S' &lt;&lt; 8 | 'E' </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>username</em>&nbsp;</td><td>If region is SP_TOPLIST_REGION_USER this specifies which user to get toplists for. NULL means the logged in user. </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>callback</em>&nbsp;</td><td>Callback to be invoked when browsing has been completed. Pass NULL if you are not interested in this event. </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata passed to callback.</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Toplist browse object</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__toplist.html#gafe8e94ae23133105f35c03b9e3836a0a">toplistbrowse_complete_cb</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="toplist_8c-example.html#a15">toplist.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga9b881929e74d97f64814ae54953ce4d7"></a><!-- doxytag: member="api.h::sp_toplistbrowse_error" ref="ga9b881929e74d97f64814ae54953ce4d7" args="(sp_toplistbrowse *tlb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_toplistbrowse_error </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>tlb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Check if browsing returned an error code.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>tlb</em>&nbsp;</td><td>Toplist browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_IS_LOADING SP_ERROR_OTHER_PERMANENT SP_ERROR_OTHER_TRANSIENT </dd></dl>

</div>
</div>
<a class="anchor" id="gaff81156c09d311c4f6a82d28a32d7968"></a><!-- doxytag: member="api.h::sp_toplistbrowse_is_loaded" ref="gaff81156c09d311c4f6a82d28a32d7968" args="(sp_toplistbrowse *tlb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_toplistbrowse_is_loaded </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>tlb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Check if an toplist browse request is completed</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>tlb</em>&nbsp;</td><td>Toplist browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>True if browsing is completed, false if not </dd></dl>

</div>
</div>
<a class="anchor" id="ga69f5e70269c1eb08e1ddb1c77bb8c3e3"></a><!-- doxytag: member="api.h::sp_toplistbrowse_num_albums" ref="ga69f5e70269c1eb08e1ddb1c77bb8c3e3" args="(sp_toplistbrowse *tlb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_toplistbrowse_num_albums </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>tlb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Given an toplist browse object, return number of albums</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>tlb</em>&nbsp;</td><td>Toplist browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of albums on toplist </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="toplist_8c-example.html#a9">toplist.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gae2f5c09fbbf947834b1b1e73461f1fb3"></a><!-- doxytag: member="api.h::sp_toplistbrowse_num_artists" ref="gae2f5c09fbbf947834b1b1e73461f1fb3" args="(sp_toplistbrowse *tlb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_toplistbrowse_num_artists </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>tlb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Given an toplist browse object, return number of artists</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>tlb</em>&nbsp;</td><td>Toplist browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of artists on toplist </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="toplist_8c-example.html#a7">toplist.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gaeb0ddfd565474dc7e444aabebbc119b7"></a><!-- doxytag: member="api.h::sp_toplistbrowse_num_tracks" ref="gaeb0ddfd565474dc7e444aabebbc119b7" args="(sp_toplistbrowse *tlb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_toplistbrowse_num_tracks </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>tlb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Given an toplist browse object, return number of tracks</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>tlb</em>&nbsp;</td><td>Toplist browse object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of tracks on toplist </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="toplist_8c-example.html#a11">toplist.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gac6cf969c9cb6b431aeaa4723820ca8de"></a><!-- doxytag: member="api.h::sp_toplistbrowse_release" ref="gac6cf969c9cb6b431aeaa4723820ca8de" args="(sp_toplistbrowse *tlb)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_toplistbrowse_release </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>tlb</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Decrease the reference count of an toplist browse result</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>tlb</em>&nbsp;</td><td>The toplist browse result object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="toplist_8c-example.html#a13">toplist.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gaf3d00b8bf089134a4f320a8d3d6ab683"></a><!-- doxytag: member="api.h::sp_toplistbrowse_track" ref="gaf3d00b8bf089134a4f320a8d3d6ab683" args="(sp_toplistbrowse *tlb, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a>* sp_toplistbrowse_track </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a> *&nbsp;</td>
          <td class="paramname"> <em>tlb</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the track at the given index in the given toplist browse object</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>tlb</em>&nbsp;</td><td>Toplist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>Index of the wanted track. Should be in the interval [0, <a class="el" href="group__toplist.html#gaeb0ddfd565474dc7e444aabebbc119b7">sp_toplistbrowse_num_tracks()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The track at the given index in the given toplist browse object </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="toplist_8c-example.html#a12">toplist.c</a>.</dd>
</dl>
</div>
</div>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/group__track.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Track subsystem</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<h1>Track subsystem</h1>  </div>
</div>
<div class="contents">
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga8b69cf193679c7e00031ae43e61c6a54">sp_track_is_loaded</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga947c0f7755b0c4955ca0b0993db0f2b5">sp_track_error</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__session.html#gaeaa41aad3c0047409996a6ec3b03203f">sp_track_offline_status</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga281e0ad4373579c5d24202ea1f93fe7b">sp_track_offline_get_status</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__session.html#ga60c7ff53ddbc04c036a23181b7275d69">sp_track_availability</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga9c78846badae6567fe9f9a3792fd06c8">sp_track_get_availability</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#gabcb75da69e0338006bdbd2f2f467f082">sp_track_is_local</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga4eeb86de13187697cd9dfe0b0934988d">sp_track_is_autolinked</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga112dca47d0bac39818b55119ef134ffd">sp_track_get_playable</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga2367d906c578e674d0d470d8c1ee3b33">sp_track_is_placeholder</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#gab17d380ac941e102af0f308ad885b3c3">sp_track_is_starred</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga34b5a712fb2c683402ff78df73e7545c">sp_track_set_starred</a> (<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *const *tracks, int num_tracks, bool star)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga0aa945fc43e35d36cc334a52735d83b2">sp_track_num_artists</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga67cd0c035627a1e4a54642213fdf1d75">sp_track_artist</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track, int index)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga39a0f52244472cb2d450ea9ba6807304">sp_track_album</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga8eb423d3cc2cbfb743c7f23ffb8d0fad">sp_track_name</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#gac817937bd8d8355b6a1949b76d0b5560">sp_track_duration</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga4570f08f968edbff519b44d2241d2255">sp_track_popularity</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga9d464ee4a5c8836b59888952b960223a">sp_track_disc</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga25c1df9d32fd58f243397740b29c3f61">sp_track_index</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga0fb814ef23636fdecda64e3a63b15a23">sp_localtrack_create</a> (const char *artist, const char *title, const char *album, int length)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#ga7d86041a2bf75590f55978521c08e38c">sp_track_add_ref</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__track.html#gaa11098d82e6c2ae42fc2ea1486e741de">sp_track_release</a> (<a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *track)</td></tr>
</table>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="ga0fb814ef23636fdecda64e3a63b15a23"></a><!-- doxytag: member="api.h::sp_localtrack_create" ref="ga0fb814ef23636fdecda64e3a63b15a23" args="(const char *artist, const char *title, const char *album, int length)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a>* sp_localtrack_create </td>
          <td>(</td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>artist</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>title</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>album</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>length</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Returns the newly created local track</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>artist</em>&nbsp;</td><td>Name of the artist </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>title</em>&nbsp;</td><td>Song title </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>album</em>&nbsp;</td><td>Name of the album, or an empty string if not available </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>length</em>&nbsp;</td><td>Length in MS, or -1 if not available.</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A track. </dd></dl>

</div>
</div>
<a class="anchor" id="ga7d86041a2bf75590f55978521c08e38c"></a><!-- doxytag: member="api.h::sp_track_add_ref" ref="ga7d86041a2bf75590f55978521c08e38c" args="(sp_track *track)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_track_add_ref </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td>
          <td class="paramname"> <em>track</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Increase the reference count of a track</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track</em>&nbsp;</td><td>The track object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a57">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga39a0f52244472cb2d450ea9ba6807304"></a><!-- doxytag: member="api.h::sp_track_album" ref="ga39a0f52244472cb2d450ea9ba6807304" args="(sp_track *track)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a>* sp_track_album </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td>
          <td class="paramname"> <em>track</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>The album of the specified track</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track</em>&nbsp;</td><td>A track object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The album of the given track. You need to increase the refcount if you want to keep the pointer around. If no metadata is available for the track yet, this function returns 0. </dd></dl>

</div>
</div>
<a class="anchor" id="ga67cd0c035627a1e4a54642213fdf1d75"></a><!-- doxytag: member="api.h::sp_track_artist" ref="ga67cd0c035627a1e4a54642213fdf1d75" args="(sp_track *track, int index)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a>* sp_track_artist </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td>
          <td class="paramname"> <em>track</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>index</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>The artist matching the specified index performing on the current track.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track</em>&nbsp;</td><td>The track whose participating artist you are interested in </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>index</em>&nbsp;</td><td>The index for the participating artist. Should be in the interval [0, <a class="el" href="group__track.html#ga0aa945fc43e35d36cc334a52735d83b2">sp_track_num_artists()</a> - 1]</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The participating artist, or NULL if invalid index </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a8">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga9d464ee4a5c8836b59888952b960223a"></a><!-- doxytag: member="api.h::sp_track_disc" ref="ga9d464ee4a5c8836b59888952b960223a" args="(sp_track *track)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_track_disc </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td>
          <td class="paramname"> <em>track</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Returns the disc number for a track</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track</em>&nbsp;</td><td>A track object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Disc index. Possible values are [1, total number of discs on album] This function returns valid data only for tracks appearing in a browse artist or browse album result (otherwise returns 0). </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a6">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gac817937bd8d8355b6a1949b76d0b5560"></a><!-- doxytag: member="api.h::sp_track_duration" ref="gac817937bd8d8355b6a1949b76d0b5560" args="(sp_track *track)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_track_duration </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td>
          <td class="paramname"> <em>track</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>The duration, in milliseconds, of the specified track</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track</em>&nbsp;</td><td>A track object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The duration of the specified track, in milliseconds If no metadata is available for the track yet, this function returns 0. </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a1">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga947c0f7755b0c4955ca0b0993db0f2b5"></a><!-- doxytag: member="api.h::sp_track_error" ref="ga947c0f7755b0c4955ca0b0993db0f2b5" args="(sp_track *track)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_track_error </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td>
          <td class="paramname"> <em>track</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return an error code associated with a track. For example if it could not load</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track</em>&nbsp;</td><td>The track</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_IS_LOADING SP_ERROR_OTHER_PERMANENT </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a34">browse.c</a>, and <a class="el" href="jukebox_8c-example.html#a3">jukebox.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga9c78846badae6567fe9f9a3792fd06c8"></a><!-- doxytag: member="api.h::sp_track_get_availability" ref="ga9c78846badae6567fe9f9a3792fd06c8" args="(sp_session *session, sp_track *track)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__session.html#ga60c7ff53ddbc04c036a23181b7275d69">sp_track_availability</a> sp_track_get_availability </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td>
          <td class="paramname"> <em>track</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return availability for a track</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track</em>&nbsp;</td><td>The track</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Availability status, see <a class="el" href="group__session.html#ga60c7ff53ddbc04c036a23181b7275d69">sp_track_availability</a></dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>The track must be loaded or this function will always SP_TRACK_AVAILABILITY_UNAVAILABLE </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__track.html#ga8b69cf193679c7e00031ae43e61c6a54">sp_track_is_loaded()</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga112dca47d0bac39818b55119ef134ffd"></a><!-- doxytag: member="api.h::sp_track_get_playable" ref="ga112dca47d0bac39818b55119ef134ffd" args="(sp_session *session, sp_track *track)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a>* sp_track_get_playable </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td>
          <td class="paramname"> <em>track</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return the actual track that will be played if the given track is played</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track</em>&nbsp;</td><td>The track</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A track </dd></dl>

</div>
</div>
<a class="anchor" id="ga25c1df9d32fd58f243397740b29c3f61"></a><!-- doxytag: member="api.h::sp_track_index" ref="ga25c1df9d32fd58f243397740b29c3f61" args="(sp_track *track)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_track_index </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td>
          <td class="paramname"> <em>track</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Returns the position of a track on its disc</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track</em>&nbsp;</td><td>A track object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Track position, starts at 1 (relative the corresponding disc) This function returns valid data only for tracks appearing in a browse artist or browse album result (otherwise returns 0). </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a7">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga4eeb86de13187697cd9dfe0b0934988d"></a><!-- doxytag: member="api.h::sp_track_is_autolinked" ref="ga4eeb86de13187697cd9dfe0b0934988d" args="(sp_session *session, sp_track *track)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_track_is_autolinked </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td>
          <td class="paramname"> <em>track</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return true if the track is autolinked to another track.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track</em>&nbsp;</td><td>The track</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>True if track is autolinked.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>The track must be loaded or this function will always return false. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__track.html#ga8b69cf193679c7e00031ae43e61c6a54">sp_track_is_loaded()</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga8b69cf193679c7e00031ae43e61c6a54"></a><!-- doxytag: member="api.h::sp_track_is_loaded" ref="ga8b69cf193679c7e00031ae43e61c6a54" args="(sp_track *track)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_track_is_loaded </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td>
          <td class="paramname"> <em>track</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return whether or not the track metadata is loaded.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track</em>&nbsp;</td><td>The track</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>True if track is loaded</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>This is equivalent to checking if <a class="el" href="group__track.html#ga947c0f7755b0c4955ca0b0993db0f2b5">sp_track_error()</a> not returns SP_ERROR_IS_LOADING. </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a40">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gabcb75da69e0338006bdbd2f2f467f082"></a><!-- doxytag: member="api.h::sp_track_is_local" ref="gabcb75da69e0338006bdbd2f2f467f082" args="(sp_session *session, sp_track *track)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_track_is_local </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td>
          <td class="paramname"> <em>track</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return true if the track is a local file.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track</em>&nbsp;</td><td>The track</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>True if track is a local file.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>The track must be loaded or this function will always return false. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__track.html#ga8b69cf193679c7e00031ae43e61c6a54">sp_track_is_loaded()</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga2367d906c578e674d0d470d8c1ee3b33"></a><!-- doxytag: member="api.h::sp_track_is_placeholder" ref="ga2367d906c578e674d0d470d8c1ee3b33" args="(sp_track *track)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_track_is_placeholder </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td>
          <td class="paramname"> <em>track</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return true if the track is a placeholder. Placeholder tracks are used to store other objects than tracks in the playlist. Currently this is used in the inbox to store artists, albums and playlists.</p>
<p>Use <a class="el" href="group__link.html#ga82c29419ce70e2b504670e3d45167d5d">sp_link_create_from_track()</a> to get a link object that points to the real object this "track" points to.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track</em>&nbsp;</td><td>The track</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>True if track is a placeholder</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>Contrary to most functions the track does not have to be loaded for this function to return correct value </dd></dl>

</div>
</div>
<a class="anchor" id="gab17d380ac941e102af0f308ad885b3c3"></a><!-- doxytag: member="api.h::sp_track_is_starred" ref="gab17d380ac941e102af0f308ad885b3c3" args="(sp_session *session, sp_track *track)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_track_is_starred </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td>
          <td class="paramname"> <em>track</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return true if the track is starred by the currently logged in user.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track</em>&nbsp;</td><td>The track</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>True if track is starred.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>The track must be loaded or this function will always return false. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__track.html#ga8b69cf193679c7e00031ae43e61c6a54">sp_track_is_loaded()</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a2">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga8eb423d3cc2cbfb743c7f23ffb8d0fad"></a><!-- doxytag: member="api.h::sp_track_name" ref="ga8eb423d3cc2cbfb743c7f23ffb8d0fad" args="(sp_track *track)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* sp_track_name </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td>
          <td class="paramname"> <em>track</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>The string representation of the specified track's name</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track</em>&nbsp;</td><td>A track object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The string representation of the specified track's name. Returned string is valid as long as the album object stays allocated and no longer than the next call to <a class="el" href="group__session.html#gaff27cb730db6debf55e750e39e7fadd7">sp_session_process_events()</a> If no metadata is available for the track yet, this function returns empty string. </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a3">browse.c</a>, and <a class="el" href="jukebox_8c-example.html#a5">jukebox.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga0aa945fc43e35d36cc334a52735d83b2"></a><!-- doxytag: member="api.h::sp_track_num_artists" ref="ga0aa945fc43e35d36cc334a52735d83b2" args="(sp_track *track)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_track_num_artists </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td>
          <td class="paramname"> <em>track</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>The number of artists performing on the specified track</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track</em>&nbsp;</td><td>The track whose number of participating artists you are interested in</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The number of artists performing on the specified track. If no metadata is available for the track yet, this function returns 0. </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a4">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga281e0ad4373579c5d24202ea1f93fe7b"></a><!-- doxytag: member="api.h::sp_track_offline_get_status" ref="ga281e0ad4373579c5d24202ea1f93fe7b" args="(sp_track *track)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__session.html#gaeaa41aad3c0047409996a6ec3b03203f">sp_track_offline_status</a> sp_track_offline_get_status </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td>
          <td class="paramname"> <em>track</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Return offline status for a track. <a class="el" href="structsp__session__callbacks.html#a09912988f00ea5e90835681b382a18fc">sp_session_callbacks::metadata_updated()</a> will be invoked when offline status of a track changes</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track</em>&nbsp;</td><td>The track</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Stats as described by <a class="el" href="group__session.html#gae689044941537050de641a1dcd4c75d5">sp_track_offline_status</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ga4570f08f968edbff519b44d2241d2255"></a><!-- doxytag: member="api.h::sp_track_popularity" ref="ga4570f08f968edbff519b44d2241d2255" args="(sp_track *track)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int sp_track_popularity </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td>
          <td class="paramname"> <em>track</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Returns popularity for track</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track</em>&nbsp;</td><td>A track object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Popularity in range 0 to 100, 0 if undefined. If no metadata is available for the track yet, this function returns 0. </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a5">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="gaa11098d82e6c2ae42fc2ea1486e741de"></a><!-- doxytag: member="api.h::sp_track_release" ref="gaa11098d82e6c2ae42fc2ea1486e741de" args="(sp_track *track)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_track_release </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *&nbsp;</td>
          <td class="paramname"> <em>track</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Decrease the reference count of a track</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>track</em>&nbsp;</td><td>The track object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="browse_8c-example.html#a36">browse.c</a>.</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga34b5a712fb2c683402ff78df73e7545c"></a><!-- doxytag: member="api.h::sp_track_set_starred" ref="ga34b5a712fb2c683402ff78df73e7545c" args="(sp_session *session, sp_track *const *tracks, int num_tracks, bool star)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_track_set_starred </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *&nbsp;</td>
          <td class="paramname"> <em>session</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *const *&nbsp;</td>
          <td class="paramname"> <em>tracks</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&nbsp;</td>
          <td class="paramname"> <em>num_tracks</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">bool&nbsp;</td>
          <td class="paramname"> <em>star</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Star/Unstar the specified track</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>tracks</em>&nbsp;</td><td>Array of pointer to tracks. </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>num_tracks</em>&nbsp;</td><td>Length of <code>tracks</code> array </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>star</em>&nbsp;</td><td>Starred status of the track</td></tr>
  </table>
  </dd>
</dl>
<dl class="note"><dt><b>Note:</b></dt><dd>This will fail silently if playlists are disabled. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd>sp_set_playlists_enabled() </dd></dl>

</div>
</div>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/group__types.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Spotify types &amp; structs</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#typedef-members">Typedefs</a>  </div>
  <div class="headertitle">
<h1>Spotify types &amp; structs</h1>  </div>
</div>
<div class="contents">
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga70dd19c6f824cf6a159575aa4c128b53"></a><!-- doxytag: member="types::sp_session" ref="ga70dd19c6f824cf6a159575aa4c128b53" args="" -->
typedef struct <a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Representation of a session. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga47bbd2262f0c8b5d7147af7d62198e48"></a><!-- doxytag: member="types::sp_track" ref="ga47bbd2262f0c8b5d7147af7d62198e48" args="" -->
typedef struct <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A track handle. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga6fd3e5de729c429fef3ff18ece6dcfad"></a><!-- doxytag: member="types::sp_album" ref="ga6fd3e5de729c429fef3ff18ece6dcfad" args="" -->
typedef struct <a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad">sp_album</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">An album handle. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga31764fbd69618c10be173c6c03d4c1bc"></a><!-- doxytag: member="types::sp_artist" ref="ga31764fbd69618c10be173c6c03d4c1bc" args="" -->
typedef struct <a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc">sp_artist</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">An artist handle. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="gafd3d5aae485f1012ec91b7948e6f9f2b"></a><!-- doxytag: member="types::sp_artistbrowse" ref="gafd3d5aae485f1012ec91b7948e6f9f2b" args="" -->
typedef struct <a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#gafd3d5aae485f1012ec91b7948e6f9f2b">sp_artistbrowse</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A handle to an artist browse result. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga9c4550473a7a07790778ba870c31b4d9"></a><!-- doxytag: member="types::sp_albumbrowse" ref="ga9c4550473a7a07790778ba870c31b4d9" args="" -->
typedef struct <a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#ga9c4550473a7a07790778ba870c31b4d9">sp_albumbrowse</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A handle to an album browse result. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga723de429cd073bcf5d13fb4e0f466ffd"></a><!-- doxytag: member="types::sp_toplistbrowse" ref="ga723de429cd073bcf5d13fb4e0f466ffd" args="" -->
typedef struct <a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd">sp_toplistbrowse</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A handle to a toplist browse result. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="gac95893a6b23d4b19f6f149eed6ead1fd"></a><!-- doxytag: member="types::sp_search" ref="gac95893a6b23d4b19f6f149eed6ead1fd" args="" -->
typedef struct <a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd">sp_search</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A handle to a search result. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="gaf90a23d6b662c96d52ac19f7f4bc1e39"></a><!-- doxytag: member="types::sp_link" ref="gaf90a23d6b662c96d52ac19f7f4bc1e39" args="" -->
typedef struct <a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39">sp_link</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A handle to the libspotify internal representation of a URI. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga61155ca7b1ba941e15490e417441917b"></a><!-- doxytag: member="types::sp_image" ref="ga61155ca7b1ba941e15490e417441917b" args="" -->
typedef struct <a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#ga61155ca7b1ba941e15490e417441917b">sp_image</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A handle to an image. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="gaed2dbaa1eebd6752f76613daad9158bc"></a><!-- doxytag: member="types::sp_user" ref="gaed2dbaa1eebd6752f76613daad9158bc" args="" -->
typedef struct <a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A handle to a user. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga1bcf54cbc117a20ab2c15e59eb3a8174"></a><!-- doxytag: member="types::sp_playlist" ref="ga1bcf54cbc117a20ab2c15e59eb3a8174" args="" -->
typedef struct <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A playlist handle. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga45a2febbe167483e48dab8d606d462d7"></a><!-- doxytag: member="types::sp_playlistcontainer" ref="ga45a2febbe167483e48dab8d606d462d7" args="" -->
typedef struct <a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A playlist container (playlist containing other playlists) handle. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="gaec0f2e5098cebc05ce56adfc9b346510"></a><!-- doxytag: member="types::sp_inbox" ref="gaec0f2e5098cebc05ce56adfc9b346510" args="" -->
typedef struct <a class="el" href="group__types.html#gaec0f2e5098cebc05ce56adfc9b346510">sp_inbox</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__types.html#gaec0f2e5098cebc05ce56adfc9b346510">sp_inbox</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Add to inbox request handle. <br/></td></tr>
</table>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/group__user.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: User handling</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#typedef-members">Typedefs</a> &#124;
<a href="#enum-members">Enumerations</a> &#124;
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<h1>User handling</h1>  </div>
</div>
<div class="contents">
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="group__user.html#ga6af84143c0622b6fc5539bb1ae111e5b">sp_relation_type</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__user.html#ga3a5dbf9aee629d8a9b43dfb24881a9b4">sp_relation_type</a></td></tr>
<tr><td colspan="2"><h2><a name="enum-members"></a>
Enumerations</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__user.html#ga6af84143c0622b6fc5539bb1ae111e5b">sp_relation_type</a> { <br/>
&nbsp;&nbsp;<a class="el" href="group__user.html#gga6af84143c0622b6fc5539bb1ae111e5ba18f24164eef0e687b351c2aa6753e35e">SP_RELATION_TYPE_UNKNOWN</a> =  0, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__user.html#gga6af84143c0622b6fc5539bb1ae111e5bad9805f100828a9d3b64c3cc66f2ac5c1">SP_RELATION_TYPE_NONE</a> =  1, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__user.html#gga6af84143c0622b6fc5539bb1ae111e5ba06b2f38745c467e7e362c7744cb74205">SP_RELATION_TYPE_UNIDIRECTIONAL</a> =  2, 
<br/>
&nbsp;&nbsp;<a class="el" href="group__user.html#gga6af84143c0622b6fc5539bb1ae111e5ba4bfef63cabd016cf1e6b11347a05d389">SP_RELATION_TYPE_BIDIRECTIONAL</a> =  3
<br/>
 }</td></tr>
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__user.html#gad9ac5456cd129c31d2c577ba14e88f8c">sp_user_canonical_name</a> (<a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *user)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__user.html#ga0052befb81a93bb7106ca863de892610">sp_user_display_name</a> (<a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *user)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__user.html#ga0996fb9814564e4ad39b8a500cb3de21">sp_user_is_loaded</a> (<a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *user)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__user.html#ga232816a3c8f42ef2663b8d99261f2dae">sp_user_add_ref</a> (<a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *user)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__user.html#gab1ffba4355073e1f72594c9e1b22ebb4">sp_user_release</a> (<a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *user)</td></tr>
</table>
<hr/><h2>Typedef Documentation</h2>
<a class="anchor" id="ga3a5dbf9aee629d8a9b43dfb24881a9b4"></a><!-- doxytag: member="api.h::sp_relation_type" ref="ga3a5dbf9aee629d8a9b43dfb24881a9b4" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef enum <a class="el" href="group__user.html#ga6af84143c0622b6fc5539bb1ae111e5b">sp_relation_type</a>  <a class="el" href="group__user.html#ga6af84143c0622b6fc5539bb1ae111e5b">sp_relation_type</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>User relation type </p>

</div>
</div>
<hr/><h2>Enumeration Type Documentation</h2>
<a class="anchor" id="ga6af84143c0622b6fc5539bb1ae111e5b"></a><!-- doxytag: member="api.h::sp_relation_type" ref="ga6af84143c0622b6fc5539bb1ae111e5b" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="group__user.html#ga6af84143c0622b6fc5539bb1ae111e5b">sp_relation_type</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>User relation type </p>
<dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" id="gga6af84143c0622b6fc5539bb1ae111e5ba18f24164eef0e687b351c2aa6753e35e"></a><!-- doxytag: member="SP_RELATION_TYPE_UNKNOWN" ref="gga6af84143c0622b6fc5539bb1ae111e5ba18f24164eef0e687b351c2aa6753e35e" args="" -->SP_RELATION_TYPE_UNKNOWN</em>&nbsp;</td><td>
<p>Not yet known. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga6af84143c0622b6fc5539bb1ae111e5bad9805f100828a9d3b64c3cc66f2ac5c1"></a><!-- doxytag: member="SP_RELATION_TYPE_NONE" ref="gga6af84143c0622b6fc5539bb1ae111e5bad9805f100828a9d3b64c3cc66f2ac5c1" args="" -->SP_RELATION_TYPE_NONE</em>&nbsp;</td><td>
<p>No relation. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga6af84143c0622b6fc5539bb1ae111e5ba06b2f38745c467e7e362c7744cb74205"></a><!-- doxytag: member="SP_RELATION_TYPE_UNIDIRECTIONAL" ref="gga6af84143c0622b6fc5539bb1ae111e5ba06b2f38745c467e7e362c7744cb74205" args="" -->SP_RELATION_TYPE_UNIDIRECTIONAL</em>&nbsp;</td><td>
<p>The currently logged in user is following this uer. </p>
</td></tr>
<tr><td valign="top"><em><a class="anchor" id="gga6af84143c0622b6fc5539bb1ae111e5ba4bfef63cabd016cf1e6b11347a05d389"></a><!-- doxytag: member="SP_RELATION_TYPE_BIDIRECTIONAL" ref="gga6af84143c0622b6fc5539bb1ae111e5ba4bfef63cabd016cf1e6b11347a05d389" args="" -->SP_RELATION_TYPE_BIDIRECTIONAL</em>&nbsp;</td><td>
<p>Bidirectional friendship established. </p>
</td></tr>
</table>
</dd>
</dl>

</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="ga232816a3c8f42ef2663b8d99261f2dae"></a><!-- doxytag: member="api.h::sp_user_add_ref" ref="ga232816a3c8f42ef2663b8d99261f2dae" args="(sp_user *user)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_user_add_ref </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *&nbsp;</td>
          <td class="paramname"> <em>user</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Increase the reference count of an user</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>user</em>&nbsp;</td><td>The user object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
<a class="anchor" id="gad9ac5456cd129c31d2c577ba14e88f8c"></a><!-- doxytag: member="api.h::sp_user_canonical_name" ref="gad9ac5456cd129c31d2c577ba14e88f8c" args="(sp_user *user)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* sp_user_canonical_name </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *&nbsp;</td>
          <td class="paramname"> <em>user</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Get a pointer to a string representing the user's canonical username.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>user</em>&nbsp;</td><td>The Spotify user whose canonical username you would like a string representation of</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A string representing the canonical username. </dd></dl>

</div>
</div>
<a class="anchor" id="ga0052befb81a93bb7106ca863de892610"></a><!-- doxytag: member="api.h::sp_user_display_name" ref="ga0052befb81a93bb7106ca863de892610" args="(sp_user *user)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* sp_user_display_name </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *&nbsp;</td>
          <td class="paramname"> <em>user</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Get a pointer to a string representing the user's displayable username. If there is no difference between the canonical username and the display name, or if the library does not know about the display name yet, the canonical username will be returned.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>user</em>&nbsp;</td><td>The Spotify user whose displayable username you would like a string representation of</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A string </dd></dl>

</div>
</div>
<a class="anchor" id="ga0996fb9814564e4ad39b8a500cb3de21"></a><!-- doxytag: member="api.h::sp_user_is_loaded" ref="ga0996fb9814564e4ad39b8a500cb3de21" args="(sp_user *user)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool sp_user_is_loaded </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *&nbsp;</td>
          <td class="paramname"> <em>user</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Get load status for a user object. Before it is loaded, only the user's canonical username is known.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>user</em>&nbsp;</td><td>Spotify user object</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>True if user object is loaded, otherwise false </dd></dl>

</div>
</div>
<a class="anchor" id="gab1ffba4355073e1f72594c9e1b22ebb4"></a><!-- doxytag: member="api.h::sp_user_release" ref="gab1ffba4355073e1f72594c9e1b22ebb4" args="(sp_user *user)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> sp_user_release </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *&nbsp;</td>
          <td class="paramname"> <em>user</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Decrease the reference count of an user</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>user</em>&nbsp;</td><td>The user object </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK </dd></dl>

</div>
</div>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/index.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: libspotify 12.1.51 API Documentation</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li class="current"><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="headertitle">
<h1>libspotify 12.1.51 API Documentation </h1>  </div>
</div>
<div class="contents">
<p>This documentation explains how you can make use of the <em>libspotify</em> C API within an application of your own.</p>
<p>The documentation was generated with <a href="http://www.doxygen.org/">Doxygen</a>. You will find a list of submodules in the <a href="modules.html">Modules</a> section. The list of modules are ordered in a reasonable reading order. It begins with some <a href="group__types.html">simple types</a> used throughout the rest of the modules, continues with basic <a href="group__error.html">error handling</a> and the functions required to <a href="group__session.html">manage sessions</a>.</p>
<p>The rest of the modules are specfic parts of <em>libspotify</em> for accessing information about <a href="group__artistbrowse.html">artists</a>, <a href="group__albumbrowse.html">albums</a>, <a href="group__track.html">tracks</a>, and <a href="group__playlist.html">playlists</a>. Separate modules are available to handle <a href="group__search.html">searches</a> and <a href="group__image.html">images</a>.</p>
<p>This initial chapter of <em>libspotify</em> will focus on the general design of the library, and things to take into consideration once you start working with it.</p>
<p>For most of the functionality, there are <a href="examples.html">examples</a> available in <code></code>.</p>
<h2><a class="anchor" id="restr_sec"></a>
Issues and Restrictions</h2>
<p>A few restrictions apply to the <em>libspotify</em> library. These may be changed (or fixed) in future versions of the library.</p>
<ul>
<li>Only one process can access the cache and settings directory. It is <em>your</em> responsibility to make sure instances of your application, or any other application and your application does not attempt to use the same cache. You can do this using a clever naming schema, or using a lock-file.</li>
<li>Even though sp_session_init() creates a new object, there are still some global variables behind the scenes that will stop you from creating multiple sessions within a single process.</li>
</ul>
<h2><a class="anchor" id="general_sec"></a>
General Design</h2>
<p>In this section, you will find the overall philosophy of the library with regard to memory management and error handling.</p>
<h3><a class="anchor" id="err_sec"></a>
Error Handling</h3>
<p>All functions that have some form of useful error state returns an <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a>. The actual result value is returned in an <code>out</code> pointer in these cases. Some functions return pointers where you must check for <code>NULL</code> before using the returned value. Those places should be documented next to each function.</p>
<p>In addition to functions returning an <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a>, some request objects (browse and search objects) have an error accessor. When the object has been loaded, the error code will be set to reflect the success or failure of the request.</p>
<p>A trivial <a class="el" href="group__error.html#ga983dee341d3c2008830513b7cffe7bf3">error code to string mapper function</a> exists that works just like <code>strerror(3)</code>.</p>
<h3><a class="anchor" id="refcnt_sec"></a>
Reference Counting</h3>
<p>Reference counting is used for all domain objects in <em>libspotify</em>. Functions including the string <b>create</b> will return an object with a pre-incremented reference count. Thus, each <code>create</code> must have a corresponding <code>release</code> when the value is no longer needed.</p>
<p>Other accessor functions (including <a class="el" href="group__link.html#gab32979d26dcf68936202fa7aed7b6e49">sp_link_as_artist</a> et al.), on the other hand, returns a reference borrowed from the object it was retrieved from. Retrieving an <a class="el" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad" title="An album handle.">sp_album</a> from an <a class="el" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39" title="A handle to the libspotify internal representation of a URI.">sp_link</a> would make the album object survive until the link object is freed, unless its reference count is explicitly incremented.</p>
<h3><a class="anchor" id="threads_sec"></a>
Threads</h3>
<p>The library itself uses multiple threads internally. To allow for synchronization between these threads, you must implement the sp_session_callbacks::notify_main_thread callback. Whenever called (from some internal thread), the application must wake up the main loop so the <a class="el" href="group__session.html#gaff27cb730db6debf55e750e39e7fadd7">sp_session_process_events()</a> function can be run.</p>
<p>The API itself is <em>not</em> thread-safe. Thus, you must take care not to call the API functions from more than one of your own threads.</p>
<h3><a class="anchor" id="objects_sec"></a>
Objects</h3>
<p>All objects (tracks, albums, artists, etc) are loaded asynchronously. Therefore the API user must query the object via the _is_loaded() functions to check that the object data has been populated. There is currently no way of finding out when data has been updated for a specific object. Rather, the user need to iterate all objects of interest upon invokation of the metadata_updated() callback.</p>
<p>Also, objects are not populated when created as a result of a sp_link_as_...() method.</p>
<h3><a class="anchor" id="cache_sec"></a>
Disk Cache Management</h3>
<p>Currently the disk cache can only be opened by one process at a time. It is preferrable not to put the cache in a network file system. To avoid clashes, we recommend you to put set the cache location to <code>/var/tmp/<em>username</em>/<em>appname</em>/</code> and to add some kind of lock. The <em>appname</em> would be a mangled user-agent string.</p>
<p>While you could simply remove the cache when the application exits to avoid the locking issue, your application will be slower as music, playlists and other metadata will have to be loaded from the server on each login. You are strongly encouraged to use a persistent cache.</p>
<p>Settings should be stored in the users home directory, but they should also be kept separate per application. We would recommend <code>~/.config/<em>appname</em>/libspotify/</code> for these files on UNIX-like systems or <code>%appdata%\<em>appname</em>\libspotify\</code> on Windows.</p>
<h2><a class="anchor" id="session_sec"></a>
Session Management</h2>
<p>Before running any application you will need an <em>application key</em>. An application key allows Spotify to identify your application and should be unique per application. You will find more information about the application keys on our <a href="http://developer.spotify.com/">developer website</a>. We have choosen not to distribute the example programs with an application key, as that might cause the key to be misused. We encourage you to get a valid application key, and put it in a file called <code>appkey.c</code> and compile the examples using the included makefile.</p>
<p>In order to ensure all data is correctly synced to disk, we encourage you to actually use <a class="el" href="group__session.html#gab7f08ca0939985b30ae2d1ed9db1d726">sp_session_logout()</a> before terminating your application. Efter logout, you will receive a <a class="el" href="structsp__session__callbacks.html#a073231e9ceb3d40f4a772ab64ba4ece7">callback</a> call in which you could display a login box, or terminate.</p>
<h2><a class="anchor" id="image_sec"></a>
Images</h2>
<p>Images are identified with a <code>const byte*</code> value, returned by various functions in the API (such as <a class="el" href="group__album.html#ga6616ef3df724af185c5eb58e8a0fb808">sp_album_cover()</a>). The pointers are valid until the object is freed, thus you should keep a reference to the objects until you are no longer using the image ID.</p>
<p>It is also possible to get references to images as URIs (see the sp_link type). This might be favourable if you need to store a reference to an image for later use but want to release the originating object.</p>
<p>Images will always be given to the application compressed using a image compression format. Currently only JPEG encoded images are delivered. See <a class="el" href="group__image.html#ga04448e81ca4916ba7ed223d0d817e803">sp_image_format()</a>. The API user should use <a class="el" href="group__image.html#ga03700a7dfa90bfc8200b89f15acd91aa">sp_image_data()</a> to get the encoded data and the application need to do the decoding of the image by itself.</p>
<h2><a class="anchor" id="audio_sec"></a>
Audio</h2>
<p>The audio is delivered through a <a class="el" href="structsp__session__callbacks.html#a33a31478b8de1882ad7847ad033fbaeb">push-callback</a> called by <em>libspotify</em> when data is available. Your callback may eat all data, or just enough to fill some constant-sized buffer. The callback will be called from a libspotify internal thread, so if you share state between the audio callback and the main thread, be sure to add adequate thread synchronization.</p>
<p>Samples are delivered as integers, see <a class="el" href="structsp__audioformat.html">sp_audioformat</a>. One <em>frame</em> consists of the same number of samples as there are channels. I.e. interleaving is on the sample level.</p>
<h2><a class="anchor" id="examples_sec"></a>
Examples</h2>
<p>Included in the distribution are a couple of example files designed to get you started easily.</p>
<h2><a class="anchor" id="license_sec"></a>
Licenses</h2>
<p>The example code distributed with <em>libspotify</em> uses the <a href="http://www.opensource.org/licenses/mit-license.php">MIT license</a>. All documentation, <em>libspotify</em> itself, and the associated C header file are distributed under the libspotify <a href="http://developer.spotify.com/en/libspotify/terms-of-use/">Terms of Use</a>. </p>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/jukebox_8c-example.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: jukebox.c</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="headertitle">
<h1>jukebox.c</h1>  </div>
</div>
<div class="contents">
<p>The jukebox.c example shows how you can use playback and playlist functions.</p>
<div class="fragment"><pre class="fragment">
<span class="preprocessor">#include &lt;errno.h&gt;</span>
<span class="preprocessor">#include &lt;libgen.h&gt;</span>
<span class="preprocessor">#include &lt;pthread.h&gt;</span>
<span class="preprocessor">#include &lt;stdint.h&gt;</span>
<span class="preprocessor">#include &lt;stdio.h&gt;</span>
<span class="preprocessor">#include &lt;stdlib.h&gt;</span>
<span class="preprocessor">#include &lt;string.h&gt;</span>
<span class="preprocessor">#include &lt;unistd.h&gt;</span>
<span class="preprocessor">#include &lt;sys/time.h&gt;</span>

<span class="preprocessor">#include &lt;libspotify/api.h&gt;</span>

<span class="preprocessor">#include &quot;audio.h&quot;</span>


<span class="comment">/* --- Data --- */</span>
<span class="keyword">extern</span> <span class="keyword">const</span> uint8_t g_appkey[];
<span class="keyword">extern</span> <span class="keyword">const</span> <span class="keywordtype">size_t</span> g_appkey_size;

<span class="keyword">static</span> audio_fifo_t g_audiofifo;
<span class="keyword">static</span> pthread_mutex_t g_notify_mutex;
<span class="keyword">static</span> pthread_cond_t g_notify_cond;
<span class="keyword">static</span> <span class="keywordtype">int</span> g_notify_do;
<span class="keyword">static</span> <span class="keywordtype">int</span> g_playback_done;
<span class="keyword">static</span> <a class="code" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53" title="Representation of a session.">sp_session</a> *g_sess;
<span class="keyword">static</span> <a class="code" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174" title="A playlist handle.">sp_playlist</a> *g_jukeboxlist;
<span class="keyword">const</span> <span class="keywordtype">char</span> *g_listname;
<span class="keyword">static</span> <span class="keywordtype">int</span> g_remove_tracks = 0;
<span class="keyword">static</span> <a class="code" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48" title="A track handle.">sp_track</a> *g_currenttrack;
<span class="keyword">static</span> <span class="keywordtype">int</span> g_track_index;


<span class="keyword">static</span> <span class="keywordtype">void</span> try_jukebox_start(<span class="keywordtype">void</span>)
{
    <a class="code" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48" title="A track handle.">sp_track</a> *t;

    <span class="keywordflow">if</span> (!g_jukeboxlist)
        <span class="keywordflow">return</span>;

    <span class="keywordflow">if</span> (!<a name="a0"></a><a class="code" href="group__playlist.html#ga684a3acc60f99b3b26488ed813ee5d23">sp_playlist_num_tracks</a>(g_jukeboxlist)) {
        fprintf(stderr, <span class="stringliteral">&quot;jukebox: No tracks in playlist. Waiting\n&quot;</span>);
        <span class="keywordflow">return</span>;
    }

    <span class="keywordflow">if</span> (<a class="code" href="group__playlist.html#ga684a3acc60f99b3b26488ed813ee5d23">sp_playlist_num_tracks</a>(g_jukeboxlist) &lt; g_track_index) {
        fprintf(stderr, <span class="stringliteral">&quot;jukebox: No more tracks in playlist. Waiting\n&quot;</span>);
        <span class="keywordflow">return</span>;
    }

    t = <a name="a1"></a><a class="code" href="group__playlist.html#ga7a03854fe6072476306780d23c6cac16">sp_playlist_track</a>(g_jukeboxlist, g_track_index);

    <span class="keywordflow">if</span> (g_currenttrack &amp;&amp; t != g_currenttrack) {
        <span class="comment">/* Someone changed the current track */</span>
        audio_fifo_flush(&amp;g_audiofifo);
        <a name="a2"></a><a class="code" href="group__session.html#gafa7ee2803f119451bb8be3bf28746975">sp_session_player_unload</a>(g_sess);
        g_currenttrack = NULL;
    }

    <span class="keywordflow">if</span> (!t)
        <span class="keywordflow">return</span>;

    <span class="keywordflow">if</span> (<a name="a3"></a><a class="code" href="group__track.html#ga947c0f7755b0c4955ca0b0993db0f2b5">sp_track_error</a>(t) != <a name="a4"></a><a class="code" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba16cb277dc84328e4b2c0cf6d5a0c0b8d" title="No errors encountered.">SP_ERROR_OK</a>)
        <span class="keywordflow">return</span>;

    <span class="keywordflow">if</span> (g_currenttrack == t)
        <span class="keywordflow">return</span>;

    g_currenttrack = t;

    printf(<span class="stringliteral">&quot;jukebox: Now playing \&quot;%s\&quot;...\n&quot;</span>, <a name="a5"></a><a class="code" href="group__track.html#ga8eb423d3cc2cbfb743c7f23ffb8d0fad">sp_track_name</a>(t));
    fflush(stdout);

    <a name="a6"></a><a class="code" href="group__session.html#gac73bf2c569a43d824439b557d5e4b293">sp_session_player_load</a>(g_sess, t);
    <a name="a7"></a><a class="code" href="group__session.html#gab66c5915967e4f90db945b118e620624">sp_session_player_play</a>(g_sess, 1);
}

<span class="comment">/* --------------------------  PLAYLIST CALLBACKS  ------------------------- */</span>
<span class="keyword">static</span> <span class="keywordtype">void</span> tracks_added(<a class="code" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174" title="A playlist handle.">sp_playlist</a> *pl, <a class="code" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48" title="A track handle.">sp_track</a> * <span class="keyword">const</span> *tracks,
                         <span class="keywordtype">int</span> num_tracks, <span class="keywordtype">int</span> position, <span class="keywordtype">void</span> *userdata)
{
    <span class="keywordflow">if</span> (pl != g_jukeboxlist)
        <span class="keywordflow">return</span>;

    printf(<span class="stringliteral">&quot;jukebox: %d tracks were added\n&quot;</span>, num_tracks);
    fflush(stdout);
    try_jukebox_start();
}

<span class="keyword">static</span> <span class="keywordtype">void</span> tracks_removed(<a class="code" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174" title="A playlist handle.">sp_playlist</a> *pl, <span class="keyword">const</span> <span class="keywordtype">int</span> *tracks,
                           <span class="keywordtype">int</span> num_tracks, <span class="keywordtype">void</span> *userdata)
{
    <span class="keywordtype">int</span> i, k = 0;

    <span class="keywordflow">if</span> (pl != g_jukeboxlist)
        <span class="keywordflow">return</span>;

    <span class="keywordflow">for</span> (i = 0; i &lt; num_tracks; ++i)
        <span class="keywordflow">if</span> (tracks[i] &lt; g_track_index)
            ++k;

    g_track_index -= k;

    printf(<span class="stringliteral">&quot;jukebox: %d tracks were removed\n&quot;</span>, num_tracks);
    fflush(stdout);
    try_jukebox_start();
}

<span class="keyword">static</span> <span class="keywordtype">void</span> tracks_moved(<a class="code" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174" title="A playlist handle.">sp_playlist</a> *pl, <span class="keyword">const</span> <span class="keywordtype">int</span> *tracks,
                         <span class="keywordtype">int</span> num_tracks, <span class="keywordtype">int</span> new_position, <span class="keywordtype">void</span> *userdata)
{
    <span class="keywordflow">if</span> (pl != g_jukeboxlist)
        <span class="keywordflow">return</span>;

    printf(<span class="stringliteral">&quot;jukebox: %d tracks were moved around\n&quot;</span>, num_tracks);
    fflush(stdout);
    try_jukebox_start();
}

<span class="keyword">static</span> <span class="keywordtype">void</span> playlist_renamed(<a class="code" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174" title="A playlist handle.">sp_playlist</a> *pl, <span class="keywordtype">void</span> *userdata)
{
    <span class="keyword">const</span> <span class="keywordtype">char</span> *name = <a name="a8"></a><a class="code" href="group__playlist.html#ga61b7e33cc1aedb4e31a2af75ae0ac8cc">sp_playlist_name</a>(pl);

    <span class="keywordflow">if</span> (!strcasecmp(name, g_listname)) {
        g_jukeboxlist = pl;
        g_track_index = 0;
        try_jukebox_start();
    } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (g_jukeboxlist == pl) {
        printf(<span class="stringliteral">&quot;jukebox: current playlist renamed to \&quot;%s\&quot;.\n&quot;</span>, name);
        g_jukeboxlist = NULL;
        g_currenttrack = NULL;
        <a class="code" href="group__session.html#gafa7ee2803f119451bb8be3bf28746975">sp_session_player_unload</a>(g_sess);
    }
}

<span class="keyword">static</span> <a name="_a9"></a><a class="code" href="structsp__playlist__callbacks.html">sp_playlist_callbacks</a> pl_callbacks = {
    .tracks_added = &amp;tracks_added,
    .tracks_removed = &amp;tracks_removed,
    .tracks_moved = &amp;tracks_moved,
    .playlist_renamed = &amp;playlist_renamed,
};


<span class="comment">/* --------------------  PLAYLIST CONTAINER CALLBACKS  --------------------- */</span>
<span class="keyword">static</span> <span class="keywordtype">void</span> playlist_added(<a class="code" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7" title="A playlist container (playlist containing other playlists) handle.">sp_playlistcontainer</a> *pc, <a class="code" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174" title="A playlist handle.">sp_playlist</a> *pl,
                           <span class="keywordtype">int</span> position, <span class="keywordtype">void</span> *userdata)
{
    <a name="a10"></a><a class="code" href="group__playlist.html#gab15fca12d387c69b4998a4d2b48e5b32">sp_playlist_add_callbacks</a>(pl, &amp;pl_callbacks, NULL);

    <span class="keywordflow">if</span> (!strcasecmp(<a class="code" href="group__playlist.html#ga61b7e33cc1aedb4e31a2af75ae0ac8cc">sp_playlist_name</a>(pl), g_listname)) {
        g_jukeboxlist = pl;
        try_jukebox_start();
    }
}

<span class="keyword">static</span> <span class="keywordtype">void</span> playlist_removed(<a class="code" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7" title="A playlist container (playlist containing other playlists) handle.">sp_playlistcontainer</a> *pc, <a class="code" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174" title="A playlist handle.">sp_playlist</a> *pl,
                             <span class="keywordtype">int</span> position, <span class="keywordtype">void</span> *userdata)
{
    <a name="a11"></a><a class="code" href="group__playlist.html#ga7fcbf909a0fa8bf25f0b1d1e7dd0e160">sp_playlist_remove_callbacks</a>(pl, &amp;pl_callbacks, NULL);
}


<span class="keyword">static</span> <span class="keywordtype">void</span> container_loaded(<a class="code" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7" title="A playlist container (playlist containing other playlists) handle.">sp_playlistcontainer</a> *pc, <span class="keywordtype">void</span> *userdata)
{
    fprintf(stderr, <span class="stringliteral">&quot;jukebox: Rootlist synchronized (%d playlists)\n&quot;</span>,
        <a name="a12"></a><a class="code" href="group__playlist.html#ga7a1cbf558b2b364b8249d4ce432df700">sp_playlistcontainer_num_playlists</a>(pc));
}


<span class="keyword">static</span> <a name="_a13"></a><a class="code" href="structsp__playlistcontainer__callbacks.html">sp_playlistcontainer_callbacks</a> pc_callbacks = {
    .playlist_added = &amp;playlist_added,
    .playlist_removed = &amp;playlist_removed,
    .container_loaded = &amp;container_loaded,
};


<span class="comment">/* ---------------------------  SESSION CALLBACKS  ------------------------- */</span>
<span class="keyword">static</span> <span class="keywordtype">void</span> logged_in(<a class="code" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53" title="Representation of a session.">sp_session</a> *sess, <a class="code" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> error)
{
    <a class="code" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7" title="A playlist container (playlist containing other playlists) handle.">sp_playlistcontainer</a> *pc = <a name="a14"></a><a class="code" href="group__session.html#ga319767f0b795f1c46a08390b587c5671">sp_session_playlistcontainer</a>(sess);
    <span class="keywordtype">int</span> i;

    <span class="keywordflow">if</span> (<a class="code" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba16cb277dc84328e4b2c0cf6d5a0c0b8d" title="No errors encountered.">SP_ERROR_OK</a> != error) {
        fprintf(stderr, <span class="stringliteral">&quot;jukebox: Login failed: %s\n&quot;</span>,
            <a name="a15"></a><a class="code" href="group__error.html#ga983dee341d3c2008830513b7cffe7bf3">sp_error_message</a>(error));
        exit(2);
    }

    <a name="a16"></a><a class="code" href="group__playlist.html#ga1976cb49c391cdd2dbe7c40d1bc71570">sp_playlistcontainer_add_callbacks</a>(
        pc,
        &amp;pc_callbacks,
        NULL);

    printf(<span class="stringliteral">&quot;jukebox: Looking at %d playlists\n&quot;</span>, <a class="code" href="group__playlist.html#ga7a1cbf558b2b364b8249d4ce432df700">sp_playlistcontainer_num_playlists</a>(pc));

    <span class="keywordflow">for</span> (i = 0; i &lt; <a class="code" href="group__playlist.html#ga7a1cbf558b2b364b8249d4ce432df700">sp_playlistcontainer_num_playlists</a>(pc); ++i) {
        <a class="code" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174" title="A playlist handle.">sp_playlist</a> *pl = <a name="a17"></a><a class="code" href="group__playlist.html#ga5ddd8c8064c281a14c6fd7877f522dc6">sp_playlistcontainer_playlist</a>(pc, i);

        <a class="code" href="group__playlist.html#gab15fca12d387c69b4998a4d2b48e5b32">sp_playlist_add_callbacks</a>(pl, &amp;pl_callbacks, NULL);

        <span class="keywordflow">if</span> (!strcasecmp(<a class="code" href="group__playlist.html#ga61b7e33cc1aedb4e31a2af75ae0ac8cc">sp_playlist_name</a>(pl), g_listname)) {
            g_jukeboxlist = pl;
            try_jukebox_start();
        }
    }

    <span class="keywordflow">if</span> (!g_jukeboxlist) {
        printf(<span class="stringliteral">&quot;jukebox: No such playlist. Waiting for one to pop up...\n&quot;</span>);
        fflush(stdout);
    }
}

<span class="keyword">static</span> <span class="keywordtype">void</span> notify_main_thread(<a class="code" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53" title="Representation of a session.">sp_session</a> *sess)
{
    pthread_mutex_lock(&amp;g_notify_mutex);
    g_notify_do = 1;
    pthread_cond_signal(&amp;g_notify_cond);
    pthread_mutex_unlock(&amp;g_notify_mutex);
}

<span class="keyword">static</span> <span class="keywordtype">int</span> music_delivery(<a class="code" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53" title="Representation of a session.">sp_session</a> *sess, <span class="keyword">const</span> <a name="_a18"></a><a class="code" href="structsp__audioformat.html">sp_audioformat</a> *format,
                          <span class="keyword">const</span> <span class="keywordtype">void</span> *frames, <span class="keywordtype">int</span> num_frames)
{
    audio_fifo_t *af = &amp;g_audiofifo;
    audio_fifo_data_t *afd;
    <span class="keywordtype">size_t</span> s;

    <span class="keywordflow">if</span> (num_frames == 0)
        <span class="keywordflow">return</span> 0; <span class="comment">// Audio discontinuity, do nothing</span>

    pthread_mutex_lock(&amp;af-&gt;mutex);

    <span class="comment">/* Buffer one second of audio */</span>
    <span class="keywordflow">if</span> (af-&gt;qlen &gt; format-&gt;<a name="a19"></a><a class="code" href="structsp__audioformat.html#a2eb66d38a418d5c0afe284d4d45a619d" title="Audio sample rate, in samples per second.">sample_rate</a>) {
        pthread_mutex_unlock(&amp;af-&gt;mutex);

        <span class="keywordflow">return</span> 0;
    }

    s = num_frames * <span class="keyword">sizeof</span>(int16_t) * format-&gt;<a name="a20"></a><a class="code" href="structsp__audioformat.html#ab6b47d8d0ebfaab73229d707dc8bf0b8" title="Number of channels. Currently 1 or 2.">channels</a>;

    afd = malloc(<span class="keyword">sizeof</span>(*afd) + s);
    memcpy(afd-&gt;samples, frames, s);

    afd-&gt;nsamples = num_frames;

    afd-&gt;rate = format-&gt;<a class="code" href="structsp__audioformat.html#a2eb66d38a418d5c0afe284d4d45a619d" title="Audio sample rate, in samples per second.">sample_rate</a>;
    afd-&gt;channels = format-&gt;<a class="code" href="structsp__audioformat.html#ab6b47d8d0ebfaab73229d707dc8bf0b8" title="Number of channels. Currently 1 or 2.">channels</a>;

    TAILQ_INSERT_TAIL(&amp;af-&gt;q, afd, link);
    af-&gt;qlen += num_frames;

    pthread_cond_signal(&amp;af-&gt;cond);
    pthread_mutex_unlock(&amp;af-&gt;mutex);

    <span class="keywordflow">return</span> num_frames;
}


<span class="keyword">static</span> <span class="keywordtype">void</span> end_of_track(<a class="code" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53" title="Representation of a session.">sp_session</a> *sess)
{
    pthread_mutex_lock(&amp;g_notify_mutex);
    g_playback_done = 1;
    g_notify_do = 1;
    pthread_cond_signal(&amp;g_notify_cond);
    pthread_mutex_unlock(&amp;g_notify_mutex);
}


<span class="keyword">static</span> <span class="keywordtype">void</span> metadata_updated(<a class="code" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53" title="Representation of a session.">sp_session</a> *sess)
{
    try_jukebox_start();
}

<span class="keyword">static</span> <span class="keywordtype">void</span> play_token_lost(<a class="code" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53" title="Representation of a session.">sp_session</a> *sess)
{
    audio_fifo_flush(&amp;g_audiofifo);

    <span class="keywordflow">if</span> (g_currenttrack != NULL) {
        <a class="code" href="group__session.html#gafa7ee2803f119451bb8be3bf28746975">sp_session_player_unload</a>(g_sess);
        g_currenttrack = NULL;
    }
}

<span class="keyword">static</span> <a name="_a21"></a><a class="code" href="structsp__session__callbacks.html">sp_session_callbacks</a> session_callbacks = {
    .logged_in = &amp;logged_in,
    .notify_main_thread = &amp;notify_main_thread,
    .music_delivery = &amp;music_delivery,
    .metadata_updated = &amp;metadata_updated,
    .play_token_lost = &amp;play_token_lost,
    .log_message = NULL,
    .end_of_track = &amp;end_of_track,
};

<span class="keyword">static</span> <a name="_a22"></a><a class="code" href="structsp__session__config.html">sp_session_config</a> spconfig = {
    .api_version = SPOTIFY_API_VERSION,
    .cache_location = <span class="stringliteral">&quot;tmp&quot;</span>,
    .settings_location = <span class="stringliteral">&quot;tmp&quot;</span>,
    .application_key = g_appkey,
    .application_key_size = 0, <span class="comment">// Set in main()</span>
    .user_agent = <span class="stringliteral">&quot;spotify-jukebox-example&quot;</span>,
    .callbacks = &amp;session_callbacks,
    NULL,
};
<span class="comment">/* -------------------------  END SESSION CALLBACKS  ----------------------- */</span>


<span class="keyword">static</span> <span class="keywordtype">void</span> track_ended(<span class="keywordtype">void</span>)
{
    <span class="keywordtype">int</span> tracks = 0;

    <span class="keywordflow">if</span> (g_currenttrack) {
        g_currenttrack = NULL;
        <a class="code" href="group__session.html#gafa7ee2803f119451bb8be3bf28746975">sp_session_player_unload</a>(g_sess);
        <span class="keywordflow">if</span> (g_remove_tracks) {
            <a name="a23"></a><a class="code" href="group__playlist.html#gabd62cd7ff9484b4c31ff7f159ec41b6a">sp_playlist_remove_tracks</a>(g_jukeboxlist, &amp;tracks, 1);
        } <span class="keywordflow">else</span> {
            ++g_track_index;
            try_jukebox_start();
        }
    }
}

<span class="keyword">static</span> <span class="keywordtype">void</span> usage(<span class="keyword">const</span> <span class="keywordtype">char</span> *progname)
{
    fprintf(stderr, <span class="stringliteral">&quot;usage: %s -u &lt;username&gt; -p &lt;password&gt; -l &lt;listname&gt; [-d]\n&quot;</span>, progname);
    fprintf(stderr, <span class="stringliteral">&quot;warning: -d will delete the tracks played from the list!\n&quot;</span>);
}

<span class="keywordtype">int</span> main(<span class="keywordtype">int</span> argc, <span class="keywordtype">char</span> **argv)
{
    <a class="code" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53" title="Representation of a session.">sp_session</a> *sp;
    <a class="code" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> err;
    <span class="keywordtype">int</span> next_timeout = 0;
    <span class="keyword">const</span> <span class="keywordtype">char</span> *username = NULL;
    <span class="keyword">const</span> <span class="keywordtype">char</span> *password = NULL;
    <span class="keywordtype">int</span> opt;

    <span class="keywordflow">while</span> ((opt = getopt(argc, argv, <span class="stringliteral">&quot;u:p:l:d&quot;</span>)) != EOF) {
        <span class="keywordflow">switch</span> (opt) {
        <span class="keywordflow">case</span> <span class="charliteral">&#39;u&#39;</span>:
            username = optarg;
            <span class="keywordflow">break</span>;

        <span class="keywordflow">case</span> <span class="charliteral">&#39;p&#39;</span>:
            password = optarg;
            <span class="keywordflow">break</span>;

        <span class="keywordflow">case</span> <span class="charliteral">&#39;l&#39;</span>:
            g_listname = optarg;
            <span class="keywordflow">break</span>;

        <span class="keywordflow">case</span> <span class="charliteral">&#39;d&#39;</span>:
            g_remove_tracks = 1;
            <span class="keywordflow">break</span>;

        <span class="keywordflow">default</span>:
            exit(1);
        }
    }

    <span class="keywordflow">if</span> (!username || !password || !g_listname) {
        usage(basename(argv[0]));
        exit(1);
    }

    audio_init(&amp;g_audiofifo);

    <span class="comment">/* Create session */</span>
    spconfig.<a name="a24"></a><a class="code" href="structsp__session__config.html#ab10b332fe29b941162fd1d9ea1003b82" title="The size of the application key in bytes.">application_key_size</a> = g_appkey_size;

    err = <a name="a25"></a><a class="code" href="group__session.html#gaf2891f2daced4ff6da84219d6376b3aa">sp_session_create</a>(&amp;spconfig, &amp;sp);

    <span class="keywordflow">if</span> (<a class="code" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba16cb277dc84328e4b2c0cf6d5a0c0b8d" title="No errors encountered.">SP_ERROR_OK</a> != err) {
        fprintf(stderr, <span class="stringliteral">&quot;Unable to create session: %s\n&quot;</span>,
            <a class="code" href="group__error.html#ga983dee341d3c2008830513b7cffe7bf3">sp_error_message</a>(err));
        exit(1);
    }

    g_sess = sp;

    pthread_mutex_init(&amp;g_notify_mutex, NULL);
    pthread_cond_init(&amp;g_notify_cond, NULL);

    <a name="a26"></a><a class="code" href="group__session.html#ga4533a992a120cacb109c892a852afe2a">sp_session_login</a>(sp, username, password, 0, NULL);
    pthread_mutex_lock(&amp;g_notify_mutex);

    <span class="keywordflow">for</span> (;;) {
        <span class="keywordflow">if</span> (next_timeout == 0) {
            <span class="keywordflow">while</span>(!g_notify_do)
                pthread_cond_wait(&amp;g_notify_cond, &amp;g_notify_mutex);
        } <span class="keywordflow">else</span> {
            <span class="keyword">struct </span>timespec ts;

<span class="preprocessor">#if _POSIX_TIMERS &gt; 0</span>
<span class="preprocessor"></span>            clock_gettime(CLOCK_REALTIME, &amp;ts);
<span class="preprocessor">#else</span>
<span class="preprocessor"></span>            <span class="keyword">struct </span>timeval tv;
            gettimeofday(&amp;tv, NULL);
            TIMEVAL_TO_TIMESPEC(&amp;tv, &amp;ts);
<span class="preprocessor">#endif</span>
<span class="preprocessor"></span>            ts.tv_sec += next_timeout / 1000;
            ts.tv_nsec += (next_timeout % 1000) * 1000000;

            pthread_cond_timedwait(&amp;g_notify_cond, &amp;g_notify_mutex, &amp;ts);
        }

        g_notify_do = 0;
        pthread_mutex_unlock(&amp;g_notify_mutex);

        <span class="keywordflow">if</span> (g_playback_done) {
            track_ended();
            g_playback_done = 0;
        }

        <span class="keywordflow">do</span> {
            <a name="a27"></a><a class="code" href="group__session.html#gaff27cb730db6debf55e750e39e7fadd7">sp_session_process_events</a>(sp, &amp;next_timeout);
        } <span class="keywordflow">while</span> (next_timeout == 0);

        pthread_mutex_lock(&amp;g_notify_mutex);
    }

    <span class="keywordflow">return</span> 0;
}
</pre></div> </div>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/modules.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: Module Index</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li class="current"><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="headertitle">
<h1>Modules</h1>  </div>
</div>
<div class="contents">
Here is a list of all modules:<ul>
<li><a class="el" href="group__types.html">Spotify types &amp; structs</a></li>
<li><a class="el" href="group__error.html">Error Handling</a></li>
<li><a class="el" href="group__session.html">Session handling</a></li>
<li><a class="el" href="group__link.html">Links (Spotify URIs)</a></li>
<li><a class="el" href="group__track.html">Track subsystem</a></li>
<li><a class="el" href="group__album.html">Album subsystem</a></li>
<li><a class="el" href="group__artist.html">Artist subsystem</a></li>
<li><a class="el" href="group__albumbrowse.html">Album browsing</a></li>
<li><a class="el" href="group__artistbrowse.html">Artist browsing</a></li>
<li><a class="el" href="group__image.html">Image handling</a></li>
<li><a class="el" href="group__search.html">Search subsystem</a></li>
<li><a class="el" href="group__playlist.html">Playlist subsystem</a></li>
<li><a class="el" href="group__user.html">User handling</a></li>
<li><a class="el" href="group__toplist.html">Toplist handling</a></li>
<li><a class="el" href="group__inbox.html">Inbox subsystem</a></li>
</ul>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/search_8c-example.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: search.c</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="headertitle">
<h1>search.c</h1>  </div>
</div>
<div class="contents">
<p>The search.c example shows how you can use search functions. It is part of the spshell program</p>
<div class="fragment"><pre class="fragment">
<span class="preprocessor">#include &lt;string.h&gt;</span>

<span class="preprocessor">#include &quot;spshell.h&quot;</span>
<span class="preprocessor">#include &quot;cmd.h&quot;</span>


<span class="keyword">static</span> <span class="keywordtype">void</span> print_album(<a class="code" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad" title="An album handle.">sp_album</a> *album)
{
    printf(<span class="stringliteral">&quot;  Album \&quot;%s\&quot; (%d)\n&quot;</span>,
           <a name="a0"></a><a class="code" href="group__album.html#ga0e828c991a8184d60026513f944e19ad">sp_album_name</a>(album),
           <a name="a1"></a><a class="code" href="group__album.html#ga2aadf934b0af43c3ef6ee98b6a8065fd">sp_album_year</a>(album));
}

<span class="keyword">static</span> <span class="keywordtype">void</span> print_artist(<a class="code" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc" title="An artist handle.">sp_artist</a> *artist)
{
    printf(<span class="stringliteral">&quot;  Artist \&quot;%s\&quot;\n&quot;</span>, <a name="a2"></a><a class="code" href="group__artist.html#gad2895555bb48514986823733a7afe5e2">sp_artist_name</a>(artist));
}

<span class="keyword">static</span> <span class="keywordtype">void</span> print_search(<a class="code" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd" title="A handle to a search result.">sp_search</a> *search)
{
    <span class="keywordtype">int</span> i;

    printf(<span class="stringliteral">&quot;Query          : %s\n&quot;</span>, <a name="a3"></a><a class="code" href="group__search.html#ga127e9c2bf98e3602ecfc2926b9d242bf">sp_search_query</a>(search));
    printf(<span class="stringliteral">&quot;Did you mean   : %s\n&quot;</span>, <a name="a4"></a><a class="code" href="group__search.html#ga8561c1da8b93ecdc8f2d325a9d19199b">sp_search_did_you_mean</a>(search));
    printf(<span class="stringliteral">&quot;Tracks in total: %d\n&quot;</span>, <a name="a5"></a><a class="code" href="group__search.html#gab4e50582c517b4639fd1afd6fb011587">sp_search_total_tracks</a>(search));
    puts(<span class="stringliteral">&quot;&quot;</span>);

    <span class="keywordflow">for</span> (i = 0; i &lt; <a name="a6"></a><a class="code" href="group__search.html#ga1dd18cf7b3b3b7f4bf6e92a2140378d0">sp_search_num_tracks</a>(search); ++i)
        print_track(<a name="a7"></a><a class="code" href="group__search.html#gae9da7ca59ce0bbd73f7bcef4e15c4da8">sp_search_track</a>(search, i));

    puts(<span class="stringliteral">&quot;&quot;</span>);

    <span class="keywordflow">for</span> (i = 0; i &lt; <a name="a8"></a><a class="code" href="group__search.html#ga0c456a6396c4c05fbc8677ea641ef1f7">sp_search_num_albums</a>(search); ++i)
        print_album(<a name="a9"></a><a class="code" href="group__search.html#ga4ba7723e70db0c6a4569c4bcd44f0e98">sp_search_album</a>(search, i));

    puts(<span class="stringliteral">&quot;&quot;</span>);

    <span class="keywordflow">for</span> (i = 0; i &lt; <a name="a10"></a><a class="code" href="group__search.html#gabd375a613c2dadecad8c13f8aca6f2d3">sp_search_num_artists</a>(search); ++i)
        print_artist(<a name="a11"></a><a class="code" href="group__search.html#ga79b3d532d5a20a3b2bf2a087eead7888">sp_search_artist</a>(search, i));

    puts(<span class="stringliteral">&quot;&quot;</span>);

    <span class="keywordflow">for</span> (i = 0; i &lt; <a name="a12"></a><a class="code" href="group__search.html#gaa9f007f439d8241bf632f9abb8d926c9">sp_search_num_playlists</a>(search); ++i) {
        <span class="comment">// print some readily available metadata, the rest will</span>
        <span class="comment">// be available from the sp_playlist object loaded through</span>
        <span class="comment">// sp_search_playlist().</span>
        printf(<span class="stringliteral">&quot;  Playlist \&quot;%s\&quot;\n&quot;</span>, <a name="a13"></a><a class="code" href="group__search.html#ga933cd5d5a0ccca9906082ca4549a4ed7">sp_search_playlist_name</a>(search, i));
    }
}

<span class="keyword">static</span> <span class="keywordtype">void</span> SP_CALLCONV search_complete(<a class="code" href="group__types.html#gac95893a6b23d4b19f6f149eed6ead1fd" title="A handle to a search result.">sp_search</a> *search, <span class="keywordtype">void</span> *userdata)
{
    <span class="keywordflow">if</span> (<a name="a14"></a><a class="code" href="group__search.html#ga7cf655e37a823f952d30270d4fb60f10">sp_search_error</a>(search) == <a name="a15"></a><a class="code" href="group__error.html#ggafd27986ce4cd9eeaeca8adda83c9eb6ba16cb277dc84328e4b2c0cf6d5a0c0b8d" title="No errors encountered.">SP_ERROR_OK</a>)
        print_search(search);
    <span class="keywordflow">else</span>
        fprintf(stderr, <span class="stringliteral">&quot;Failed to search: %s\n&quot;</span>,
                <a name="a16"></a><a class="code" href="group__error.html#ga983dee341d3c2008830513b7cffe7bf3">sp_error_message</a>(<a class="code" href="group__search.html#ga7cf655e37a823f952d30270d4fb60f10">sp_search_error</a>(search)));

    <a name="a17"></a><a class="code" href="group__search.html#ga4e01d43067d9f8c533c985f90143821b">sp_search_release</a>(search);
    cmd_done();
}



<span class="keyword">static</span> <span class="keywordtype">void</span> search_usage(<span class="keywordtype">void</span>)
{
    fprintf(stderr, <span class="stringliteral">&quot;Usage: search &lt;query&gt;\n&quot;</span>);
}


<span class="keywordtype">int</span> cmd_search(<span class="keywordtype">int</span> argc, <span class="keywordtype">char</span> **argv)
{
    <span class="keywordtype">char</span> query[1024];
    <span class="keywordtype">int</span> i;

    <span class="keywordflow">if</span> (argc &lt; 2) {
        search_usage();
        <span class="keywordflow">return</span> -1;
    }

    query[0] = 0;
    <span class="keywordflow">for</span>(i = 1; i &lt; argc; i++)
        snprintf(query + strlen(query), <span class="keyword">sizeof</span>(query) - strlen(query), <span class="stringliteral">&quot;%s%s&quot;</span>,
             i == 1 ? <span class="stringliteral">&quot;&quot;</span> : <span class="stringliteral">&quot; &quot;</span>, argv[i]);

    <a name="a18"></a><a class="code" href="group__search.html#ga2f64dfbcc1313e7d5179998cb28208d4">sp_search_create</a>(g_session, query, 0, 100, 0, 100, 0, 100, 0, 100, SP_SEARCH_STANDARD, &amp;search_complete, NULL);
    <span class="keywordflow">return</span> 0;
}


<span class="keywordtype">int</span> cmd_whatsnew(<span class="keywordtype">int</span> argc, <span class="keywordtype">char</span> **argv)
{
    <a class="code" href="group__search.html#ga2f64dfbcc1313e7d5179998cb28208d4">sp_search_create</a>(g_session, <span class="stringliteral">&quot;tag:new&quot;</span>, 0, 0, 0, 250, 0, 0, 0, 0, SP_SEARCH_STANDARD, &amp;search_complete, NULL);
    <span class="keywordflow">return</span> 0;
}
</pre></div> </div>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/structsp__audio__buffer__stats.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: sp_audio_buffer_stats Struct Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li class="current"><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="functions.html"><span>Data&nbsp;Fields</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#pub-attribs">Data Fields</a>  </div>
  <div class="headertitle">
<h1>sp_audio_buffer_stats Struct Reference<br/>
<small>
[<a class="el" href="group__session.html">Session handling</a>]</small>
</h1>  </div>
</div>
<div class="contents">
<!-- doxytag: class="sp_audio_buffer_stats" -->
<p><code>#include &lt;api.h&gt;</code></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-attribs"></a>
Data Fields</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a1ff9dcc75ace1cc954138fedc4c8f854"></a><!-- doxytag: member="sp_audio_buffer_stats::samples" ref="a1ff9dcc75ace1cc954138fedc4c8f854" args="" -->
int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__audio__buffer__stats.html#a1ff9dcc75ace1cc954138fedc4c8f854">samples</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Samples in buffer. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a85f67e5b11d5ba63b4a94f01a5009d96"></a><!-- doxytag: member="sp_audio_buffer_stats::stutter" ref="a85f67e5b11d5ba63b4a94f01a5009d96" args="" -->
int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__audio__buffer__stats.html#a85f67e5b11d5ba63b4a94f01a5009d96">stutter</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Number of stutters (audio dropouts) since last query. <br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Buffer stats used by get_audio_buffer_stats callback </p>
<hr/>The documentation for this struct was generated from the following file:<ul>
<li><a class="el" href="api_8h.html">api.h</a></li>
</ul>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/structsp__audioformat.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: sp_audioformat Struct Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li class="current"><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="functions.html"><span>Data&nbsp;Fields</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#pub-attribs">Data Fields</a>  </div>
  <div class="headertitle">
<h1>sp_audioformat Struct Reference<br/>
<small>
[<a class="el" href="group__session.html">Session handling</a>]</small>
</h1>  </div>
</div>
<div class="contents">
<!-- doxytag: class="sp_audioformat" -->
<p><code>#include &lt;api.h&gt;</code></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-attribs"></a>
Data Fields</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="af128862563608ee7e41a6d6a4e6133bc"></a><!-- doxytag: member="sp_audioformat::sample_type" ref="af128862563608ee7e41a6d6a4e6133bc" args="" -->
<a class="el" href="group__session.html#ga087d21080010768316cfb55d938eb94d">sp_sampletype</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__audioformat.html#af128862563608ee7e41a6d6a4e6133bc">sample_type</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Sample type enum,. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a2eb66d38a418d5c0afe284d4d45a619d"></a><!-- doxytag: member="sp_audioformat::sample_rate" ref="a2eb66d38a418d5c0afe284d4d45a619d" args="" -->
int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__audioformat.html#a2eb66d38a418d5c0afe284d4d45a619d">sample_rate</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Audio sample rate, in samples per second. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ab6b47d8d0ebfaab73229d707dc8bf0b8"></a><!-- doxytag: member="sp_audioformat::channels" ref="ab6b47d8d0ebfaab73229d707dc8bf0b8" args="" -->
int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__audioformat.html#ab6b47d8d0ebfaab73229d707dc8bf0b8">channels</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Number of channels. Currently 1 or 2. <br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Audio format descriptor </p>
<dl><dt><b>Examples: </b></dt><dd>
<p><a class="el" href="jukebox_8c-example.html#_a18">jukebox.c</a>.</p>
</dd>
</dl><hr/>The documentation for this struct was generated from the following file:<ul>
<li><a class="el" href="api_8h.html">api.h</a></li>
</ul>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/structsp__offline__sync__status.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: sp_offline_sync_status Struct Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li class="current"><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="functions.html"><span>Data&nbsp;Fields</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#pub-attribs">Data Fields</a>  </div>
  <div class="headertitle">
<h1>sp_offline_sync_status Struct Reference<br/>
<small>
[<a class="el" href="group__session.html">Session handling</a>]</small>
</h1>  </div>
</div>
<div class="contents">
<!-- doxytag: class="sp_offline_sync_status" -->
<p><code>#include &lt;api.h&gt;</code></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-attribs"></a>
Data Fields</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__offline__sync__status.html#a44a8a719c66266763ed184b575abce61">queued_tracks</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__offline__sync__status.html#aaeb2860d7301485d40d9f0d9bb868fbb">done_tracks</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__offline__sync__status.html#add0d4345a08fc710614be33c5a662f7c">copied_tracks</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__offline__sync__status.html#aa56788dbda2c99047cc79282caf3ffd6">willnotcopy_tracks</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__offline__sync__status.html#aa5002b69e3826edc285d19eb7ca0f582">error_tracks</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__offline__sync__status.html#a5a2a99fdb8eeb38b3c73a44c6df68d06">syncing</a></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Offline sync status </p>
<hr/><h2>Field Documentation</h2>
<a class="anchor" id="add0d4345a08fc710614be33c5a662f7c"></a><!-- doxytag: member="sp_offline_sync_status::copied_tracks" ref="add0d4345a08fc710614be33c5a662f7c" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int <a class="el" href="structsp__offline__sync__status.html#add0d4345a08fc710614be33c5a662f7c">sp_offline_sync_status::copied_tracks</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Copied tracks/bytes is things that has been copied in current sync operation </p>

</div>
</div>
<a class="anchor" id="aaeb2860d7301485d40d9f0d9bb868fbb"></a><!-- doxytag: member="sp_offline_sync_status::done_tracks" ref="aaeb2860d7301485d40d9f0d9bb868fbb" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int <a class="el" href="structsp__offline__sync__status.html#aaeb2860d7301485d40d9f0d9bb868fbb">sp_offline_sync_status::done_tracks</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Done tracks/bytes is things marked for sync that existed on device before current sync operation </p>

</div>
</div>
<a class="anchor" id="aa5002b69e3826edc285d19eb7ca0f582"></a><!-- doxytag: member="sp_offline_sync_status::error_tracks" ref="aa5002b69e3826edc285d19eb7ca0f582" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int <a class="el" href="structsp__offline__sync__status.html#aa5002b69e3826edc285d19eb7ca0f582">sp_offline_sync_status::error_tracks</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>A track is counted as error when something goes wrong while syncing the track </p>

</div>
</div>
<a class="anchor" id="a44a8a719c66266763ed184b575abce61"></a><!-- doxytag: member="sp_offline_sync_status::queued_tracks" ref="a44a8a719c66266763ed184b575abce61" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int <a class="el" href="structsp__offline__sync__status.html#a44a8a719c66266763ed184b575abce61">sp_offline_sync_status::queued_tracks</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Queued tracks/bytes is things left to sync in current sync operation </p>

</div>
</div>
<a class="anchor" id="a5a2a99fdb8eeb38b3c73a44c6df68d06"></a><!-- doxytag: member="sp_offline_sync_status::syncing" ref="a5a2a99fdb8eeb38b3c73a44c6df68d06" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool <a class="el" href="structsp__offline__sync__status.html#a5a2a99fdb8eeb38b3c73a44c6df68d06">sp_offline_sync_status::syncing</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Set if sync operation is in progress </p>

</div>
</div>
<a class="anchor" id="aa56788dbda2c99047cc79282caf3ffd6"></a><!-- doxytag: member="sp_offline_sync_status::willnotcopy_tracks" ref="aa56788dbda2c99047cc79282caf3ffd6" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int <a class="el" href="structsp__offline__sync__status.html#aa56788dbda2c99047cc79282caf3ffd6">sp_offline_sync_status::willnotcopy_tracks</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Tracks that are marked as synced but will not be copied (for various reasons) </p>

</div>
</div>
<hr/>The documentation for this struct was generated from the following file:<ul>
<li><a class="el" href="api_8h.html">api.h</a></li>
</ul>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/structsp__playlist__callbacks.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: sp_playlist_callbacks Struct Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li class="current"><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="functions.html"><span>Data&nbsp;Fields</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#pub-attribs">Data Fields</a>  </div>
  <div class="headertitle">
<h1>sp_playlist_callbacks Struct Reference<br/>
<small>
[<a class="el" href="group__playlist.html">Playlist subsystem</a>]</small>
</h1>  </div>
</div>
<div class="contents">
<!-- doxytag: class="sp_playlist_callbacks" -->
<p><code>#include &lt;api.h&gt;</code></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-attribs"></a>
Data Fields</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__playlist__callbacks.html#a16c3e5758f8f73f5900de4b88424f85e">tracks_added</a> )(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *const *tracks, int num_tracks, int position, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__playlist__callbacks.html#a8f7decf111d725363c968ae4e7b15795">tracks_removed</a> )(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, const int *tracks, int num_tracks, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__playlist__callbacks.html#ac3d51200f7a813cce810561132dba4e9">tracks_moved</a> )(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, const int *tracks, int num_tracks, int new_position, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__playlist__callbacks.html#a25e98e4355cf2d3503c7ac708c8104cf">playlist_renamed</a> )(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__playlist__callbacks.html#a7ff55580625a755b196336a551d210d4">playlist_state_changed</a> )(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__playlist__callbacks.html#ab07f7eb6c283523afb37d683932b62d4">playlist_update_in_progress</a> )(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, bool done, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__playlist__callbacks.html#a0de3ae5463973647c114d5fdc85ade87">playlist_metadata_updated</a> )(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__playlist__callbacks.html#a152a3b599f22f4040ff0581c6927d12e">track_created_changed</a> )(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, int position, <a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *user, int when, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__playlist__callbacks.html#ab78eaf42523f53bb5931eaff8dcdea8b">track_seen_changed</a> )(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, int position, bool seen, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__playlist__callbacks.html#a07d1ebf29e1ba1f8b10c7a8c5e209f41">description_changed</a> )(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, const char *desc, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__playlist__callbacks.html#a910203945dcd26b02b390d5413e4f5dd">image_changed</a> )(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, const byte *image, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__playlist__callbacks.html#ad26fb637a16ed0590bdf7936dfcad82d">track_message_changed</a> )(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, int position, const char *message, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__playlist__callbacks.html#ae33cb7f8ebc9eac186c9f22272d093c3">subscribers_changed</a> )(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, void *userdata)</td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Playlist callbacks</p>
<p>Used to get notifications when playlists are updated. If some callbacks should not be of interest, set them to NULL. </p>
<dl><dt><b>Examples: </b></dt><dd>
<p><a class="el" href="browse_8c-example.html#_a0">browse.c</a>, and <a class="el" href="jukebox_8c-example.html#_a9">jukebox.c</a>.</p>
</dd>
</dl><hr/><h2>Field Documentation</h2>
<a class="anchor" id="a07d1ebf29e1ba1f8b10c7a8c5e209f41"></a><!-- doxytag: member="sp_playlist_callbacks::description_changed" ref="a07d1ebf29e1ba1f8b10c7a8c5e209f41" args=")(sp_playlist *pl, const char *desc, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__playlist__callbacks.html#a07d1ebf29e1ba1f8b10c7a8c5e209f41">sp_playlist_callbacks::description_changed</a>)(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, const char *desc, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when playlist description has changed</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pl</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>desc</em>&nbsp;</td><td>New description </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata passed to <a class="el" href="group__playlist.html#gab15fca12d387c69b4998a4d2b48e5b32">sp_playlist_add_callbacks()</a> </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a910203945dcd26b02b390d5413e4f5dd"></a><!-- doxytag: member="sp_playlist_callbacks::image_changed" ref="a910203945dcd26b02b390d5413e4f5dd" args=")(sp_playlist *pl, const byte *image, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__playlist__callbacks.html#a910203945dcd26b02b390d5413e4f5dd">sp_playlist_callbacks::image_changed</a>)(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, const byte *image, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when playlist image has changed</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pl</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>image</em>&nbsp;</td><td>New image </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata passed to <a class="el" href="group__playlist.html#gab15fca12d387c69b4998a4d2b48e5b32">sp_playlist_add_callbacks()</a> </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a0de3ae5463973647c114d5fdc85ade87"></a><!-- doxytag: member="sp_playlist_callbacks::playlist_metadata_updated" ref="a0de3ae5463973647c114d5fdc85ade87" args=")(sp_playlist *pl, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__playlist__callbacks.html#a0de3ae5463973647c114d5fdc85ade87">sp_playlist_callbacks::playlist_metadata_updated</a>)(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when metadata for one or more tracks in a playlist has been updated.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pl</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata passed to <a class="el" href="group__playlist.html#gab15fca12d387c69b4998a4d2b48e5b32">sp_playlist_add_callbacks()</a> </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a25e98e4355cf2d3503c7ac708c8104cf"></a><!-- doxytag: member="sp_playlist_callbacks::playlist_renamed" ref="a25e98e4355cf2d3503c7ac708c8104cf" args=")(sp_playlist *pl, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__playlist__callbacks.html#a25e98e4355cf2d3503c7ac708c8104cf">sp_playlist_callbacks::playlist_renamed</a>)(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when a playlist has been renamed. <a class="el" href="group__playlist.html#ga61b7e33cc1aedb4e31a2af75ae0ac8cc">sp_playlist_name()</a> can be used to find out the new name</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pl</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata passed to <a class="el" href="group__playlist.html#gab15fca12d387c69b4998a4d2b48e5b32">sp_playlist_add_callbacks()</a> </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a7ff55580625a755b196336a551d210d4"></a><!-- doxytag: member="sp_playlist_callbacks::playlist_state_changed" ref="a7ff55580625a755b196336a551d210d4" args=")(sp_playlist *pl, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__playlist__callbacks.html#a7ff55580625a755b196336a551d210d4">sp_playlist_callbacks::playlist_state_changed</a>)(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when state changed for a playlist.</p>
<p>There are three states that trigger this callback:</p>
<ul>
<li>Collaboration for this playlist has been turned on or off</li>
<li>The playlist started having pending changes, or all pending changes have now been committed</li>
<li>The playlist started loading, or finished loading</li>
</ul>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pl</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata passed to <a class="el" href="group__playlist.html#gab15fca12d387c69b4998a4d2b48e5b32">sp_playlist_add_callbacks()</a> </td></tr>
  </table>
  </dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__playlist.html#ga8ad160f654f02f13690568070dd57353">sp_playlist_is_collaborative</a> </dd>
<dd>
<a class="el" href="group__playlist.html#gaf0e39b5969259d10625eb398af0f3f43">sp_playlist_has_pending_changes</a> </dd>
<dd>
<a class="el" href="group__playlist.html#gaee8ea6c07dfdca3397e27b278fa4870a">sp_playlist_is_loaded</a> </dd></dl>

</div>
</div>
<a class="anchor" id="ab07f7eb6c283523afb37d683932b62d4"></a><!-- doxytag: member="sp_playlist_callbacks::playlist_update_in_progress" ref="ab07f7eb6c283523afb37d683932b62d4" args=")(sp_playlist *pl, bool done, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__playlist__callbacks.html#ab07f7eb6c283523afb37d683932b62d4">sp_playlist_callbacks::playlist_update_in_progress</a>)(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, bool done, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when a playlist is updating or is done updating</p>
<p>This is called before and after a series of changes are applied to the playlist. It allows e.g. the user interface to defer updating until the entire operation is complete.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pl</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>done</em>&nbsp;</td><td>True iff the update is completed </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata passed to <a class="el" href="group__playlist.html#gab15fca12d387c69b4998a4d2b48e5b32">sp_playlist_add_callbacks()</a> </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="ae33cb7f8ebc9eac186c9f22272d093c3"></a><!-- doxytag: member="sp_playlist_callbacks::subscribers_changed" ref="ae33cb7f8ebc9eac186c9f22272d093c3" args=")(sp_playlist *pl, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__playlist__callbacks.html#ae33cb7f8ebc9eac186c9f22272d093c3">sp_playlist_callbacks::subscribers_changed</a>)(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when playlist subscribers changes (count or list of names)</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pl</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata passed to <a class="el" href="group__playlist.html#gab15fca12d387c69b4998a4d2b48e5b32">sp_playlist_add_callbacks()</a> </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a152a3b599f22f4040ff0581c6927d12e"></a><!-- doxytag: member="sp_playlist_callbacks::track_created_changed" ref="a152a3b599f22f4040ff0581c6927d12e" args=")(sp_playlist *pl, int position, sp_user *user, int when, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__playlist__callbacks.html#a152a3b599f22f4040ff0581c6927d12e">sp_playlist_callbacks::track_created_changed</a>)(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, int position, <a class="el" href="group__types.html#gaed2dbaa1eebd6752f76613daad9158bc">sp_user</a> *user, int when, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when create time and/or creator for a playlist entry changes</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pl</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>position</em>&nbsp;</td><td>Position in playlist </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>user</em>&nbsp;</td><td>User object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>time</em>&nbsp;</td><td>When entry was created, seconds since the unix epoch. </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata passed to <a class="el" href="group__playlist.html#gab15fca12d387c69b4998a4d2b48e5b32">sp_playlist_add_callbacks()</a> </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="ad26fb637a16ed0590bdf7936dfcad82d"></a><!-- doxytag: member="sp_playlist_callbacks::track_message_changed" ref="ad26fb637a16ed0590bdf7936dfcad82d" args=")(sp_playlist *pl, int position, const char *message, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__playlist__callbacks.html#ad26fb637a16ed0590bdf7936dfcad82d">sp_playlist_callbacks::track_message_changed</a>)(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, int position, const char *message, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when message attribute for a playlist entry changes.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pl</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>position</em>&nbsp;</td><td>Position in playlist </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>message</em>&nbsp;</td><td>UTF-8 encoded message </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata passed to <a class="el" href="group__playlist.html#gab15fca12d387c69b4998a4d2b48e5b32">sp_playlist_add_callbacks()</a> </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="ab78eaf42523f53bb5931eaff8dcdea8b"></a><!-- doxytag: member="sp_playlist_callbacks::track_seen_changed" ref="ab78eaf42523f53bb5931eaff8dcdea8b" args=")(sp_playlist *pl, int position, bool seen, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__playlist__callbacks.html#ab78eaf42523f53bb5931eaff8dcdea8b">sp_playlist_callbacks::track_seen_changed</a>)(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, int position, bool seen, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when seen attribute for a playlist entry changes.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pl</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>position</em>&nbsp;</td><td>Position in playlist </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>seen</em>&nbsp;</td><td>Set if entry it marked as seen </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata passed to <a class="el" href="group__playlist.html#gab15fca12d387c69b4998a4d2b48e5b32">sp_playlist_add_callbacks()</a> </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a16c3e5758f8f73f5900de4b88424f85e"></a><!-- doxytag: member="sp_playlist_callbacks::tracks_added" ref="a16c3e5758f8f73f5900de4b88424f85e" args=")(sp_playlist *pl, sp_track *const *tracks, int num_tracks, int position, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__playlist__callbacks.html#a16c3e5758f8f73f5900de4b88424f85e">sp_playlist_callbacks::tracks_added</a>)(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, <a class="el" href="group__types.html#ga47bbd2262f0c8b5d7147af7d62198e48">sp_track</a> *const *tracks, int num_tracks, int position, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when one or more tracks have been added to a playlist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pl</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>tracks</em>&nbsp;</td><td>Array of pointers to track objects </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>num_tracks</em>&nbsp;</td><td>Number of entries in <code>tracks</code> </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>position</em>&nbsp;</td><td>Position in the playlist for the first track. </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata passed to <a class="el" href="group__playlist.html#gab15fca12d387c69b4998a4d2b48e5b32">sp_playlist_add_callbacks()</a> </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="ac3d51200f7a813cce810561132dba4e9"></a><!-- doxytag: member="sp_playlist_callbacks::tracks_moved" ref="ac3d51200f7a813cce810561132dba4e9" args=")(sp_playlist *pl, const int *tracks, int num_tracks, int new_position, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__playlist__callbacks.html#ac3d51200f7a813cce810561132dba4e9">sp_playlist_callbacks::tracks_moved</a>)(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, const int *tracks, int num_tracks, int new_position, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when one or more tracks have been moved within a playlist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pl</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>tracks</em>&nbsp;</td><td>Array of positions representing the tracks that were moved </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>num_tracks</em>&nbsp;</td><td>Number of entries in <code>tracks</code> </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>position</em>&nbsp;</td><td>New position in the playlist for the first track. </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata passed to <a class="el" href="group__playlist.html#gab15fca12d387c69b4998a4d2b48e5b32">sp_playlist_add_callbacks()</a> </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a8f7decf111d725363c968ae4e7b15795"></a><!-- doxytag: member="sp_playlist_callbacks::tracks_removed" ref="a8f7decf111d725363c968ae4e7b15795" args=")(sp_playlist *pl, const int *tracks, int num_tracks, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__playlist__callbacks.html#a8f7decf111d725363c968ae4e7b15795">sp_playlist_callbacks::tracks_removed</a>)(<a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *pl, const int *tracks, int num_tracks, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when one or more tracks have been removed from a playlist</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pl</em>&nbsp;</td><td>Playlist object </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>tracks</em>&nbsp;</td><td>Array of positions representing the tracks that were removed </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>num_tracks</em>&nbsp;</td><td>Number of entries in <code>tracks</code> </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata passed to <a class="el" href="group__playlist.html#gab15fca12d387c69b4998a4d2b48e5b32">sp_playlist_add_callbacks()</a> </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<hr/>The documentation for this struct was generated from the following file:<ul>
<li><a class="el" href="api_8h.html">api.h</a></li>
</ul>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/structsp__playlistcontainer__callbacks.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: sp_playlistcontainer_callbacks Struct Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li class="current"><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="functions.html"><span>Data&nbsp;Fields</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#pub-attribs">Data Fields</a>  </div>
  <div class="headertitle">
<h1>sp_playlistcontainer_callbacks Struct Reference<br/>
<small>
[<a class="el" href="group__playlist.html">Playlist subsystem</a>]</small>
</h1>  </div>
</div>
<div class="contents">
<!-- doxytag: class="sp_playlistcontainer_callbacks" -->
<p><code>#include &lt;api.h&gt;</code></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-attribs"></a>
Data Fields</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__playlistcontainer__callbacks.html#ab1ba98e60fe050aeda8edc95166dd6fe">playlist_added</a> )(<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, int position, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__playlistcontainer__callbacks.html#ad49b8c0f44f6c05e4ab3562b023f0928">playlist_removed</a> )(<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, int position, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__playlistcontainer__callbacks.html#a64889a47ae2023e21be1ca4a8024c663">playlist_moved</a> )(<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, int position, int new_position, void *userdata)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__playlistcontainer__callbacks.html#a8a0c301dd9cf90cccb4657a7d65c61b1">container_loaded</a> )(<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, void *userdata)</td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Playlist container callbacks. If some callbacks should not be of interest, set them to NULL.</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__playlist.html#ga1976cb49c391cdd2dbe7c40d1bc71570">sp_playlistcontainer_add_callbacks</a> </dd>
<dd>
<a class="el" href="group__playlist.html#gafb5242b8f0f9964cec29d32f4d6c1164">sp_playlistcontainer_remove_callbacks</a> </dd></dl>
<dl><dt><b>Examples: </b></dt><dd>
<p><a class="el" href="jukebox_8c-example.html#_a13">jukebox.c</a>.</p>
</dd>
</dl><hr/><h2>Field Documentation</h2>
<a class="anchor" id="a8a0c301dd9cf90cccb4657a7d65c61b1"></a><!-- doxytag: member="sp_playlistcontainer_callbacks::container_loaded" ref="a8a0c301dd9cf90cccb4657a7d65c61b1" args=")(sp_playlistcontainer *pc, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__playlistcontainer__callbacks.html#a8a0c301dd9cf90cccb4657a7d65c61b1">sp_playlistcontainer_callbacks::container_loaded</a>)(<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when the playlist container is loaded</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pc</em>&nbsp;</td><td>Playlist container </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata as set in <a class="el" href="group__playlist.html#ga1976cb49c391cdd2dbe7c40d1bc71570">sp_playlistcontainer_add_callbacks()</a> </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="ab1ba98e60fe050aeda8edc95166dd6fe"></a><!-- doxytag: member="sp_playlistcontainer_callbacks::playlist_added" ref="ab1ba98e60fe050aeda8edc95166dd6fe" args=")(sp_playlistcontainer *pc, sp_playlist *playlist, int position, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__playlistcontainer__callbacks.html#ab1ba98e60fe050aeda8edc95166dd6fe">sp_playlistcontainer_callbacks::playlist_added</a>)(<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, int position, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when a new playlist has been added to the playlist container.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pc</em>&nbsp;</td><td>Playlist container </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object. </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>position</em>&nbsp;</td><td>Position in list </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata as set in <a class="el" href="group__playlist.html#ga1976cb49c391cdd2dbe7c40d1bc71570">sp_playlistcontainer_add_callbacks()</a> </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a64889a47ae2023e21be1ca4a8024c663"></a><!-- doxytag: member="sp_playlistcontainer_callbacks::playlist_moved" ref="a64889a47ae2023e21be1ca4a8024c663" args=")(sp_playlistcontainer *pc, sp_playlist *playlist, int position, int new_position, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__playlistcontainer__callbacks.html#a64889a47ae2023e21be1ca4a8024c663">sp_playlistcontainer_callbacks::playlist_moved</a>)(<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, int position, int new_position, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when a playlist has been moved in the playlist container</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pc</em>&nbsp;</td><td>Playlist container </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object. </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>position</em>&nbsp;</td><td>Previous position in playlist container list </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>new_position</em>&nbsp;</td><td>New position in playlist container list </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata as set in <a class="el" href="group__playlist.html#ga1976cb49c391cdd2dbe7c40d1bc71570">sp_playlistcontainer_add_callbacks()</a> </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="ad49b8c0f44f6c05e4ab3562b023f0928"></a><!-- doxytag: member="sp_playlistcontainer_callbacks::playlist_removed" ref="ad49b8c0f44f6c05e4ab3562b023f0928" args=")(sp_playlistcontainer *pc, sp_playlist *playlist, int position, void *userdata)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__playlistcontainer__callbacks.html#ad49b8c0f44f6c05e4ab3562b023f0928">sp_playlistcontainer_callbacks::playlist_removed</a>)(<a class="el" href="group__types.html#ga45a2febbe167483e48dab8d606d462d7">sp_playlistcontainer</a> *pc, <a class="el" href="group__types.html#ga1bcf54cbc117a20ab2c15e59eb3a8174">sp_playlist</a> *playlist, int position, void *userdata)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when a new playlist has been removed from playlist container</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>pc</em>&nbsp;</td><td>Playlist container </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>playlist</em>&nbsp;</td><td>Playlist object. </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>position</em>&nbsp;</td><td>Position in list </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>userdata</em>&nbsp;</td><td>Userdata as set in <a class="el" href="group__playlist.html#ga1976cb49c391cdd2dbe7c40d1bc71570">sp_playlistcontainer_add_callbacks()</a> </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<hr/>The documentation for this struct was generated from the following file:<ul>
<li><a class="el" href="api_8h.html">api.h</a></li>
</ul>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/structsp__session__callbacks.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: sp_session_callbacks Struct Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li class="current"><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="functions.html"><span>Data&nbsp;Fields</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#pub-attribs">Data Fields</a>  </div>
  <div class="headertitle">
<h1>sp_session_callbacks Struct Reference<br/>
<small>
[<a class="el" href="group__session.html">Session handling</a>]</small>
</h1>  </div>
</div>
<div class="contents">
<!-- doxytag: class="sp_session_callbacks" -->
<p><code>#include &lt;api.h&gt;</code></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-attribs"></a>
Data Fields</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html#a52d509962541f7d8fdd71284f40d8415">logged_in</a> )(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> error)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html#a073231e9ceb3d40f4a772ab64ba4ece7">logged_out</a> )(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html#a09912988f00ea5e90835681b382a18fc">metadata_updated</a> )(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html#a45bf5d3fac7953099a191ea39fcfc018">connection_error</a> )(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> error)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html#ae5d6e4a9a4296cfcbca1e57acdb4d64d">message_to_user</a> )(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, const char *message)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html#a085cfd82e77aee2b592f314321019a29">notify_main_thread</a> )(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html#a33a31478b8de1882ad7847ad033fbaeb">music_delivery</a> )(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, const <a class="el" href="structsp__audioformat.html">sp_audioformat</a> *format, const void *frames, int num_frames)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html#a641fc97950305fbcd83d5114918c53b9">play_token_lost</a> )(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html#aae0ce9c91f2779fafa40ebd640060a05">log_message</a> )(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, const char *data)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html#a6bc198d89ff46d930c32dae950bd0294">end_of_track</a> )(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html#a003db54ec10236a3e3d77bfbf31f38ae">streaming_error</a> )(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> error)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html#a8685310c1755044ec0ea0e316de8be6e">userinfo_updated</a> )(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html#adcfcee6abf1b6f408010e5615d2a79c8">start_playback</a> )(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html#a2a225bc017266c935c05d18142f27ad6">stop_playback</a> )(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html#a328404ac150210387ea3f9cc973149c9">get_audio_buffer_stats</a> )(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="structsp__audio__buffer__stats.html">sp_audio_buffer_stats</a> *stats)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html#aa0f62ed875aab47e5ae093576a6d54c8">offline_status_updated</a> )(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html#ad403ac063f5512b277c924add75dfbea">offline_error</a> )(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> error)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html#ae7c5c209735f5c437d76a512eebbf30b">credentials_blob_updated</a> )(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, const char *blob)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html#a379c96577e927d6c65ac61fe13c1e412">connectionstate_updated</a> )(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html#a01a47778439fa233187fdefa75a0f7dc">scrobble_error</a> )(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> error)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void(*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__callbacks.html#ad04af396785f8973a3c15a68bb617830">private_session_mode_changed</a> )(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, bool is_private)</td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Session callbacks</p>
<p>Registered when you create a session. If some callbacks should not be of interest, set them to NULL. </p>
<dl><dt><b>Examples: </b></dt><dd>
<p><a class="el" href="jukebox_8c-example.html#_a21">jukebox.c</a>.</p>
</dd>
</dl><hr/><h2>Field Documentation</h2>
<a class="anchor" id="a45bf5d3fac7953099a191ea39fcfc018"></a><!-- doxytag: member="sp_session_callbacks::connection_error" ref="a45bf5d3fac7953099a191ea39fcfc018" args=")(sp_session *session, sp_error error)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__session__callbacks.html#a45bf5d3fac7953099a191ea39fcfc018">sp_session_callbacks::connection_error</a>)(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> error)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when there is a connection error, and the library has problems reconnecting to the Spotify service. Could be called multiple times (as long as the problem is present)</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>error</em>&nbsp;</td><td>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_CLIENT_TOO_OLD SP_ERROR_UNABLE_TO_CONTACT_SERVER SP_ERROR_BAD_USERNAME_OR_PASSWORD SP_ERROR_USER_BANNED SP_ERROR_USER_NEEDS_PREMIUM SP_ERROR_OTHER_TRANSIENT SP_ERROR_OTHER_PERMANENT </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a379c96577e927d6c65ac61fe13c1e412"></a><!-- doxytag: member="sp_session_callbacks::connectionstate_updated" ref="a379c96577e927d6c65ac61fe13c1e412" args=")(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__session__callbacks.html#a379c96577e927d6c65ac61fe13c1e412">sp_session_callbacks::connectionstate_updated</a>)(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when the connection state has updated - such as when logging in, going offline, etc.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="ae7c5c209735f5c437d76a512eebbf30b"></a><!-- doxytag: member="sp_session_callbacks::credentials_blob_updated" ref="ae7c5c209735f5c437d76a512eebbf30b" args=")(sp_session *session, const char *blob)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__session__callbacks.html#ae7c5c209735f5c437d76a512eebbf30b">sp_session_callbacks::credentials_blob_updated</a>)(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, const char *blob)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when storable credentials have been updated, usually called when we have connected to the AP.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>blob</em>&nbsp;</td><td>Blob is a null-terminated string which contains an encrypted token that can be stored safely on disk instead of storing plaintext passwords. </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a6bc198d89ff46d930c32dae950bd0294"></a><!-- doxytag: member="sp_session_callbacks::end_of_track" ref="a6bc198d89ff46d930c32dae950bd0294" args=")(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__session__callbacks.html#a6bc198d89ff46d930c32dae950bd0294">sp_session_callbacks::end_of_track</a>)(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>End of track. Called when the currently played track has reached its end.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>This function is invoked from the main thread</dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a328404ac150210387ea3f9cc973149c9"></a><!-- doxytag: member="sp_session_callbacks::get_audio_buffer_stats" ref="a328404ac150210387ea3f9cc973149c9" args=")(sp_session *session, sp_audio_buffer_stats *stats)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__session__callbacks.html#a328404ac150210387ea3f9cc973149c9">sp_session_callbacks::get_audio_buffer_stats</a>)(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="structsp__audio__buffer__stats.html">sp_audio_buffer_stats</a> *stats)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called to query application about its audio buffer</p>
<dl class="note"><dt><b>Note:</b></dt><dd>This function is called from an internal session thread - you need to have proper synchronization!</dd>
<dd>
This function must never block.</dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
    <tr><td valign="top"><tt>[out]</tt>&nbsp;</td><td valign="top"><em>stats</em>&nbsp;</td><td>Stats struct to be filled by application </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="aae0ce9c91f2779fafa40ebd640060a05"></a><!-- doxytag: member="sp_session_callbacks::log_message" ref="aae0ce9c91f2779fafa40ebd640060a05" args=")(sp_session *session, const char *data)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__session__callbacks.html#aae0ce9c91f2779fafa40ebd640060a05">sp_session_callbacks::log_message</a>)(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, const char *data)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Logging callback.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>data</em>&nbsp;</td><td>Log data </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a52d509962541f7d8fdd71284f40d8415"></a><!-- doxytag: member="sp_session_callbacks::logged_in" ref="a52d509962541f7d8fdd71284f40d8415" args=")(sp_session *session, sp_error error)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__session__callbacks.html#a52d509962541f7d8fdd71284f40d8415">sp_session_callbacks::logged_in</a>)(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> error)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when login has been processed and was successful</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>error</em>&nbsp;</td><td>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_OK SP_ERROR_CLIENT_TOO_OLD SP_ERROR_UNABLE_TO_CONTACT_SERVER SP_ERROR_BAD_USERNAME_OR_PASSWORD SP_ERROR_USER_BANNED SP_ERROR_USER_NEEDS_PREMIUM SP_ERROR_OTHER_TRANSIENT SP_ERROR_OTHER_PERMANENT </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a073231e9ceb3d40f4a772ab64ba4ece7"></a><!-- doxytag: member="sp_session_callbacks::logged_out" ref="a073231e9ceb3d40f4a772ab64ba4ece7" args=")(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__session__callbacks.html#a073231e9ceb3d40f4a772ab64ba4ece7">sp_session_callbacks::logged_out</a>)(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when logout has been processed. Either called explicitly if you initialize a logout operation, or implicitly if there is a permanent connection error</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="ae5d6e4a9a4296cfcbca1e57acdb4d64d"></a><!-- doxytag: member="sp_session_callbacks::message_to_user" ref="ae5d6e4a9a4296cfcbca1e57acdb4d64d" args=")(sp_session *session, const char *message)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__session__callbacks.html#ae5d6e4a9a4296cfcbca1e57acdb4d64d">sp_session_callbacks::message_to_user</a>)(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, const char *message)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when the access point wants to display a message to the user</p>
<p>In the desktop client, these are shown in a blueish toolbar just below the search box.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>message</em>&nbsp;</td><td>String in UTF-8 format. </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a09912988f00ea5e90835681b382a18fc"></a><!-- doxytag: member="sp_session_callbacks::metadata_updated" ref="a09912988f00ea5e90835681b382a18fc" args=")(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__session__callbacks.html#a09912988f00ea5e90835681b382a18fc">sp_session_callbacks::metadata_updated</a>)(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called whenever metadata has been updated</p>
<p>If you have metadata cached outside of libspotify, you should purge your caches and fetch new versions.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a33a31478b8de1882ad7847ad033fbaeb"></a><!-- doxytag: member="sp_session_callbacks::music_delivery" ref="a33a31478b8de1882ad7847ad033fbaeb" args=")(sp_session *session, const sp_audioformat *format, const void *frames, int num_frames)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int( * <a class="el" href="structsp__session__callbacks.html#a33a31478b8de1882ad7847ad033fbaeb">sp_session_callbacks::music_delivery</a>)(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, const <a class="el" href="structsp__audioformat.html">sp_audioformat</a> *format, const void *frames, int num_frames)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when there is decompressed audio data available.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>format</em>&nbsp;</td><td>Audio format descriptor <a class="el" href="structsp__audioformat.html">sp_audioformat</a> </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>frames</em>&nbsp;</td><td>Points to raw PCM data as described by <code>format</code> </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>num_frames</em>&nbsp;</td><td>Number of available samples in <code>frames</code>. If this is 0, a discontinuity has occurred (such as after a seek). The application should flush its audio fifos, etc.</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Number of frames consumed. This value can be used to rate limit the output from the library if your output buffers are saturated. The library will retry delivery in about 100ms.</dd></dl>
<dl class="note"><dt><b>Note:</b></dt><dd>This function is called from an internal session thread - you need to have proper synchronization!</dd>
<dd>
This function must never block. If your output buffers are full you must return 0 to signal that the library should retry delivery in a short while. </dd></dl>

</div>
</div>
<a class="anchor" id="a085cfd82e77aee2b592f314321019a29"></a><!-- doxytag: member="sp_session_callbacks::notify_main_thread" ref="a085cfd82e77aee2b592f314321019a29" args=")(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__session__callbacks.html#a085cfd82e77aee2b592f314321019a29">sp_session_callbacks::notify_main_thread</a>)(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when processing needs to take place on the main thread.</p>
<p>You need to call <a class="el" href="group__session.html#gaff27cb730db6debf55e750e39e7fadd7">sp_session_process_events()</a> in the main thread to get libspotify to do more work. Failure to do so may cause request timeouts, or a lost connection.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session</td></tr>
  </table>
  </dd>
</dl>
<dl class="note"><dt><b>Note:</b></dt><dd>This function is called from an internal session thread - you need to have proper synchronization! </dd></dl>

</div>
</div>
<a class="anchor" id="ad403ac063f5512b277c924add75dfbea"></a><!-- doxytag: member="sp_session_callbacks::offline_error" ref="ad403ac063f5512b277c924add75dfbea" args=")(sp_session *session, sp_error error)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__session__callbacks.html#ad403ac063f5512b277c924add75dfbea">sp_session_callbacks::offline_error</a>)(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> error)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when offline synchronization status is updated</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>error</em>&nbsp;</td><td>Offline error. Will be SP_ERROR_OK if the offline synchronization error state has cleared </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="aa0f62ed875aab47e5ae093576a6d54c8"></a><!-- doxytag: member="sp_session_callbacks::offline_status_updated" ref="aa0f62ed875aab47e5ae093576a6d54c8" args=")(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__session__callbacks.html#aa0f62ed875aab47e5ae093576a6d54c8">sp_session_callbacks::offline_status_updated</a>)(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when offline synchronization status is updated</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a641fc97950305fbcd83d5114918c53b9"></a><!-- doxytag: member="sp_session_callbacks::play_token_lost" ref="a641fc97950305fbcd83d5114918c53b9" args=")(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__session__callbacks.html#a641fc97950305fbcd83d5114918c53b9">sp_session_callbacks::play_token_lost</a>)(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Music has been paused because an account only allows music to be played from one location simultaneously.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>When this callback is invoked the application should behave just as if the user pressed the pause button. The application should also display a message to the user indicating the playback has been paused because another application is playing using the same account.</dd>
<dd>
IT MUST NOT automatically resume playback but must instead wait for the user to press play.</dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="ad04af396785f8973a3c15a68bb617830"></a><!-- doxytag: member="sp_session_callbacks::private_session_mode_changed" ref="ad04af396785f8973a3c15a68bb617830" args=")(sp_session *session, bool is_private)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__session__callbacks.html#ad04af396785f8973a3c15a68bb617830">sp_session_callbacks::private_session_mode_changed</a>)(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, bool is_private)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when there is a change in the private session mode</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>isPrivate</em>&nbsp;</td><td>True if in private session, false otherwhise </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a01a47778439fa233187fdefa75a0f7dc"></a><!-- doxytag: member="sp_session_callbacks::scrobble_error" ref="a01a47778439fa233187fdefa75a0f7dc" args=")(sp_session *session, sp_error error)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__session__callbacks.html#a01a47778439fa233187fdefa75a0f7dc">sp_session_callbacks::scrobble_error</a>)(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> error)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when there is a scrobble error event</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>error</em>&nbsp;</td><td>Scrobble error. Currently SP_ERROR_LASTFM_AUTH_ERROR. </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="adcfcee6abf1b6f408010e5615d2a79c8"></a><!-- doxytag: member="sp_session_callbacks::start_playback" ref="adcfcee6abf1b6f408010e5615d2a79c8" args=")(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__session__callbacks.html#adcfcee6abf1b6f408010e5615d2a79c8">sp_session_callbacks::start_playback</a>)(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when audio playback should start</p>
<dl class="note"><dt><b>Note:</b></dt><dd>For this to work correctly the application must also implement <a class="el" href="structsp__session__callbacks.html#a328404ac150210387ea3f9cc973149c9">get_audio_buffer_stats()</a></dd>
<dd>
This function is called from an internal session thread - you need to have proper synchronization!</dd>
<dd>
This function must never block.</dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a2a225bc017266c935c05d18142f27ad6"></a><!-- doxytag: member="sp_session_callbacks::stop_playback" ref="a2a225bc017266c935c05d18142f27ad6" args=")(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__session__callbacks.html#a2a225bc017266c935c05d18142f27ad6">sp_session_callbacks::stop_playback</a>)(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called when audio playback should stop</p>
<dl class="note"><dt><b>Note:</b></dt><dd>For this to work correctly the application must also implement <a class="el" href="structsp__session__callbacks.html#a328404ac150210387ea3f9cc973149c9">get_audio_buffer_stats()</a></dd>
<dd>
This function is called from an internal session thread - you need to have proper synchronization!</dd>
<dd>
This function must never block.</dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a003db54ec10236a3e3d77bfbf31f38ae"></a><!-- doxytag: member="sp_session_callbacks::streaming_error" ref="a003db54ec10236a3e3d77bfbf31f38ae" args=")(sp_session *session, sp_error error)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__session__callbacks.html#a003db54ec10236a3e3d77bfbf31f38ae">sp_session_callbacks::streaming_error</a>)(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session, <a class="el" href="group__error.html#gafd27986ce4cd9eeaeca8adda83c9eb6b">sp_error</a> error)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Streaming error. Called when streaming cannot start or continue.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>This function is invoked from the main thread</dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>error</em>&nbsp;</td><td>One of the following errors, from <a class="el" href="group__error.html#ga83154178d3a32668658734d2facfa22b">sp_error</a> SP_ERROR_NO_STREAM_AVAILABLE SP_ERROR_OTHER_TRANSIENT SP_ERROR_OTHER_PERMANENT </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a8685310c1755044ec0ea0e316de8be6e"></a><!-- doxytag: member="sp_session_callbacks::userinfo_updated" ref="a8685310c1755044ec0ea0e316de8be6e" args=")(sp_session *session)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void( * <a class="el" href="structsp__session__callbacks.html#a8685310c1755044ec0ea0e316de8be6e">sp_session_callbacks::userinfo_updated</a>)(<a class="el" href="group__types.html#ga70dd19c6f824cf6a159575aa4c128b53">sp_session</a> *session)</td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Called after user info (anything related to sp_user objects) have been updated.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"><tt>[in]</tt>&nbsp;</td><td valign="top"><em>session</em>&nbsp;</td><td>Session </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<hr/>The documentation for this struct was generated from the following file:<ul>
<li><a class="el" href="api_8h.html">api.h</a></li>
</ul>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/structsp__session__config.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: sp_session_config Struct Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li class="current"><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="functions.html"><span>Data&nbsp;Fields</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#pub-attribs">Data Fields</a>  </div>
  <div class="headertitle">
<h1>sp_session_config Struct Reference<br/>
<small>
[<a class="el" href="group__session.html">Session handling</a>]</small>
</h1>  </div>
</div>
<div class="contents">
<!-- doxytag: class="sp_session_config" -->
<p><code>#include &lt;api.h&gt;</code></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-attribs"></a>
Data Fields</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a1ed9d4ff26e6f666ba96dce41d5f1bac"></a><!-- doxytag: member="sp_session_config::api_version" ref="a1ed9d4ff26e6f666ba96dce41d5f1bac" args="" -->
int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__config.html#a1ed9d4ff26e6f666ba96dce41d5f1bac">api_version</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">The version of the Spotify API your application is compiled with. Set to <a class="el" href="group__session.html#ga63b2309874193750ec3395f6cae32899">SPOTIFY_API_VERSION</a>. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__config.html#ad1cb5e3670451d8cee3d8c9766b523fc">cache_location</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__config.html#a342532432040d476aaaf73f10893d23b">settings_location</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ab5a5296a8e34bb454e7575940a19b9ae"></a><!-- doxytag: member="sp_session_config::application_key" ref="ab5a5296a8e34bb454e7575940a19b9ae" args="" -->
const void *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__config.html#ab5a5296a8e34bb454e7575940a19b9ae">application_key</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Your application key. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ab10b332fe29b941162fd1d9ea1003b82"></a><!-- doxytag: member="sp_session_config::application_key_size" ref="ab10b332fe29b941162fd1d9ea1003b82" args="" -->
size_t&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__config.html#ab10b332fe29b941162fd1d9ea1003b82">application_key_size</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">The size of the application key in bytes. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__config.html#a69d5b5aa58c901d7916bdea6e5b75c88">user_agent</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="af0b456e6b9228ed812cd8ad28acbb127"></a><!-- doxytag: member="sp_session_config::callbacks" ref="af0b456e6b9228ed812cd8ad28acbb127" args="" -->
const <a class="el" href="structsp__session__callbacks.html">sp_session_callbacks</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__config.html#af0b456e6b9228ed812cd8ad28acbb127">callbacks</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Delivery callbacks for session events, or NULL if you are not interested in any callbacks (not recommended!). <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a931b9a253380fdf910afc715e2c2d040"></a><!-- doxytag: member="sp_session_config::userdata" ref="a931b9a253380fdf910afc715e2c2d040" args="" -->
void *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__config.html#a931b9a253380fdf910afc715e2c2d040">userdata</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">User supplied data for your application. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__config.html#a8413a38bf3db9047b45525ac5dd4bc7b">compress_playlists</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__config.html#a190139f3c0842cfe27c61ebf2da5ee9f">dont_save_metadata_for_playlists</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__config.html#a3460b768cf69d1c646ac39f507e39287">initially_unload_playlists</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__config.html#af51c373555138dc4012501fa94b2bedc">device_id</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__config.html#af7a09f94350796ae7dde15a6518f51e2">proxy</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__config.html#a393cd7cf64c064f1647fe0045ac0d5cb">proxy_username</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__config.html#a33f2d3aa26d3db999b3026529aa5d670">proxy_password</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__config.html#a4a94ad4270e5401e68587952661bd3ca">ca_certs_filename</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__session__config.html#aa7df4256deac84eea21053a7ca2cc3da">tracefile</a></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Session config </p>
<dl><dt><b>Examples: </b></dt><dd>
<p><a class="el" href="jukebox_8c-example.html#_a22">jukebox.c</a>.</p>
</dd>
</dl><hr/><h2>Field Documentation</h2>
<a class="anchor" id="a4a94ad4270e5401e68587952661bd3ca"></a><!-- doxytag: member="sp_session_config::ca_certs_filename" ref="a4a94ad4270e5401e68587952661bd3ca" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* <a class="el" href="structsp__session__config.html#a4a94ad4270e5401e68587952661bd3ca">sp_session_config::ca_certs_filename</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Path to a file containing the root ca certificates that the peer should be verified with. The file must be a concatenation of all certificates in PEM format. Provided with libspotify is a sample pem file in examples. It is recommended that the application export a similar file from the local certificate store. </p>

</div>
</div>
<a class="anchor" id="ad1cb5e3670451d8cee3d8c9766b523fc"></a><!-- doxytag: member="sp_session_config::cache_location" ref="ad1cb5e3670451d8cee3d8c9766b523fc" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* <a class="el" href="structsp__session__config.html#ad1cb5e3670451d8cee3d8c9766b523fc">sp_session_config::cache_location</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>The location where Spotify will write cache files. This cache include tracks, cached browse results and coverarts. Set to empty string ("") to disable cache </p>

</div>
</div>
<a class="anchor" id="a8413a38bf3db9047b45525ac5dd4bc7b"></a><!-- doxytag: member="sp_session_config::compress_playlists" ref="a8413a38bf3db9047b45525ac5dd4bc7b" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool <a class="el" href="structsp__session__config.html#a8413a38bf3db9047b45525ac5dd4bc7b">sp_session_config::compress_playlists</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Compress local copy of playlists, reduces disk space usage </p>

</div>
</div>
<a class="anchor" id="af51c373555138dc4012501fa94b2bedc"></a><!-- doxytag: member="sp_session_config::device_id" ref="af51c373555138dc4012501fa94b2bedc" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* <a class="el" href="structsp__session__config.html#af51c373555138dc4012501fa94b2bedc">sp_session_config::device_id</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Device ID for offline synchronization and logging purposes. The Device Id must be unique to the particular device instance, i.e. no two units must supply the same Device ID. The Device ID must not change between sessions or power cycles. Good examples is the device's MAC address or unique serial number. </p>

</div>
</div>
<a class="anchor" id="a190139f3c0842cfe27c61ebf2da5ee9f"></a><!-- doxytag: member="sp_session_config::dont_save_metadata_for_playlists" ref="a190139f3c0842cfe27c61ebf2da5ee9f" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool <a class="el" href="structsp__session__config.html#a190139f3c0842cfe27c61ebf2da5ee9f">sp_session_config::dont_save_metadata_for_playlists</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Don't save metadata for local copies of playlists Reduces disk space usage at the expense of needing to request metadata from Spotify backend when loading list </p>

</div>
</div>
<a class="anchor" id="a3460b768cf69d1c646ac39f507e39287"></a><!-- doxytag: member="sp_session_config::initially_unload_playlists" ref="a3460b768cf69d1c646ac39f507e39287" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool <a class="el" href="structsp__session__config.html#a3460b768cf69d1c646ac39f507e39287">sp_session_config::initially_unload_playlists</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Avoid loading playlists into RAM on startup. See <a class="el" href="group__playlist.html#ga28456d1242693c6d890516dc782ab3ec">sp_playlist_is_in_ram()</a> for more details. </p>

</div>
</div>
<a class="anchor" id="af7a09f94350796ae7dde15a6518f51e2"></a><!-- doxytag: member="sp_session_config::proxy" ref="af7a09f94350796ae7dde15a6518f51e2" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* <a class="el" href="structsp__session__config.html#af7a09f94350796ae7dde15a6518f51e2">sp_session_config::proxy</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Url to the proxy server that should be used. The format is protocol://&lt;host&gt;:port (where protocal is http/https/socks4/socks5) </p>

</div>
</div>
<a class="anchor" id="a33f2d3aa26d3db999b3026529aa5d670"></a><!-- doxytag: member="sp_session_config::proxy_password" ref="a33f2d3aa26d3db999b3026529aa5d670" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* <a class="el" href="structsp__session__config.html#a33f2d3aa26d3db999b3026529aa5d670">sp_session_config::proxy_password</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Password to authenticate with proxy server </p>

</div>
</div>
<a class="anchor" id="a393cd7cf64c064f1647fe0045ac0d5cb"></a><!-- doxytag: member="sp_session_config::proxy_username" ref="a393cd7cf64c064f1647fe0045ac0d5cb" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* <a class="el" href="structsp__session__config.html#a393cd7cf64c064f1647fe0045ac0d5cb">sp_session_config::proxy_username</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Username to authenticate with proxy server </p>

</div>
</div>
<a class="anchor" id="a342532432040d476aaaf73f10893d23b"></a><!-- doxytag: member="sp_session_config::settings_location" ref="a342532432040d476aaaf73f10893d23b" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* <a class="el" href="structsp__session__config.html#a342532432040d476aaaf73f10893d23b">sp_session_config::settings_location</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>The location where Spotify will write setting files and per-user cache items. This includes playlists, track metadata, etc. 'settings_location' may be the same path as 'cache_location'. 'settings_location' folder will not be created (unlike 'cache_location'), if you don't want to create the folder yourself, you can set 'settings_location' to 'cache_location'. </p>

</div>
</div>
<a class="anchor" id="aa7df4256deac84eea21053a7ca2cc3da"></a><!-- doxytag: member="sp_session_config::tracefile" ref="aa7df4256deac84eea21053a7ca2cc3da" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* <a class="el" href="structsp__session__config.html#aa7df4256deac84eea21053a7ca2cc3da">sp_session_config::tracefile</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Path to API trace file </p>

</div>
</div>
<a class="anchor" id="a69d5b5aa58c901d7916bdea6e5b75c88"></a><!-- doxytag: member="sp_session_config::user_agent" ref="a69d5b5aa58c901d7916bdea6e5b75c88" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const char* <a class="el" href="structsp__session__config.html#a69d5b5aa58c901d7916bdea6e5b75c88">sp_session_config::user_agent</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>"User-Agent" for your application - max 255 characters long The User-Agent should be a relevant, customer facing identification of your application </p>

</div>
</div>
<hr/>The documentation for this struct was generated from the following file:<ul>
<li><a class="el" href="api_8h.html">api.h</a></li>
</ul>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/structsp__subscribers.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: sp_subscribers Struct Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li class="current"><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
  <div class="tabs2">
    <ul class="tablist">
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="functions.html"><span>Data&nbsp;Fields</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#pub-attribs">Data Fields</a>  </div>
  <div class="headertitle">
<h1>sp_subscribers Struct Reference<br/>
<small>
[<a class="el" href="group__session.html">Session handling</a>]</small>
</h1>  </div>
</div>
<div class="contents">
<!-- doxytag: class="sp_subscribers" -->
<p><code>#include &lt;api.h&gt;</code></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-attribs"></a>
Data Fields</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a37fd3d0daff9f2d856db1e891ce44bab"></a><!-- doxytag: member="sp_subscribers::count" ref="a37fd3d0daff9f2d856db1e891ce44bab" args="" -->
unsigned int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__subscribers.html#a37fd3d0daff9f2d856db1e891ce44bab">count</a></td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Number of elements in 'subscribers'. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aaac89593785dc926976885dfd33efb0c"></a><!-- doxytag: member="sp_subscribers::subscribers" ref="aaac89593785dc926976885dfd33efb0c" args="[1]" -->
char *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structsp__subscribers.html#aaac89593785dc926976885dfd33efb0c">subscribers</a> [1]</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Actual size is 'count'. Array of pointers to canonical usernames. <br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>List of subscribers returned by <a class="el" href="group__playlist.html#gad49f491babc475f8d4aeea1b4452ff8b">sp_playlist_subscribers()</a> </p>
<hr/>The documentation for this struct was generated from the following file:<ul>
<li><a class="el" href="api_8h.html">api.h</a></li>
</ul>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/html/tabs.css
================================================
.tabs, .tabs2, .tabs3 {
    background-image: url('tab_b.png');
    width: 100%;
    z-index: 101;
    font-size: 13px;
}

.tabs2 {
    font-size: 10px;
}
.tabs3 {
    font-size: 9px;
}

.tablist {
    margin: 0;
    padding: 0;
    display: table;
}

.tablist li {
    float: left;
    display: table-cell;
    background-image: url('tab_b.png');
    line-height: 36px;
    list-style: none;
}

.tablist a {
    display: block;
    padding: 0 20px;
    font-weight: bold;
    background-image:url('tab_s.png');
    background-repeat:no-repeat;
    background-position:right;
    color: #283A5D;
    text-shadow: 0px 1px 1px rgba(255, 255, 255, 0.9);
    text-decoration: none;
    outline: none;
}

.tabs3 .tablist a {
    padding: 0 10px;
}

.tablist a:hover {
    background-image: url('tab_h.png');
    background-repeat:repeat-x;
    color: #fff;
    text-shadow: 0px 1px 1px rgba(0, 0, 0, 1.0);
    text-decoration: none;
}

.tablist li.current a {
    background-image: url('tab_a.png');
    background-repeat:repeat-x;
    color: #fff;
    text-shadow: 0px 1px 1px rgba(0, 0, 0, 1.0);
}


================================================
FILE: libspotify/docs/html/toplist_8c-example.html
================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libspotify: toplist.c</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li><a href="files.html"><span>Files</span></a></li>
      <li><a href="examples.html"><span>Examples</span></a></li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="headertitle">
<h1>toplist.c</h1>  </div>
</div>
<div class="contents">
<p>The toplist.c example shows how you can use toplist functions. It is part of the spshell program</p>
<div class="fragment"><pre class="fragment">
<span class="preprocessor">#include &lt;string.h&gt;</span>

<span class="preprocessor">#include &quot;spshell.h&quot;</span>
<span class="preprocessor">#include &quot;cmd.h&quot;</span>

<span class="keyword">static</span> <span class="keywordtype">void</span> print_album(<span class="keywordtype">int</span> index, <a class="code" href="group__types.html#ga6fd3e5de729c429fef3ff18ece6dcfad" title="An album handle.">sp_album</a> *album)
{
    printf(<span class="stringliteral">&quot;  Album %3d: \&quot;%s\&quot; by \&quot;%s\&quot;\n&quot;</span>, index, <a name="a0"></a><a class="code" href="group__album.html#ga0e828c991a8184d60026513f944e19ad">sp_album_name</a>(album), 
           <a name="a1"></a><a class="code" href="group__artist.html#gad2895555bb48514986823733a7afe5e2">sp_artist_name</a>(<a name="a2"></a><a class="code" href="group__album.html#ga42309972141dab10c32d741d357c01de">sp_album_artist</a>(album)));
}

<span class="keyword">static</span> <span class="keywordtype">void</span> print_artist(<span class="keywordtype">int</span> index, <a class="code" href="group__types.html#ga31764fbd69618c10be173c6c03d4c1bc" title="An artist handle.">sp_artist</a> *artist)
{
    <a class="code" href="group__types.html#gaf90a23d6b662c96d52ac19f7f4bc1e39" title="A handle to the libspotify internal representation of a URI.">sp_link</a> *l;
    <span class="keywordtype">char</span> url[200];
    printf(<span class="stringliteral">&quot;  Artist %3d: \&quot;%s\&quot;\n&quot;</span>, index, <a class="code" href="group__artist.html#gad2895555bb48514986823733a7afe5e2">sp_artist_name</a>(artist));

    l = <a name="a3"></a><a class="code" href="group__link.html#gaafb25ee14bfb27f9cbbab1b039d4d225">sp_link_create_from_artist_portrait</a>(artist, <a name="a4"></a><a class="code" href="group__session.html#gga61bc424465d776af3ceeb69eee2bb492ad20c808fd1f8180d1f49f643975d1dd7" title="Normal image size.">SP_IMAGE_SIZE_NORMAL</a>);
    <span class="keywordflow">if</span>(l != NULL) {
        <a name="a5"></a><a class="code" href="group__link.html#ga9f169be53f098adcf12f7a10b8bd3ef7">sp_link_as_string</a>(l, url, <span class="keyword">sizeof</span>(url));
        printf(<span class="stringliteral">&quot;    Portrait: %s\n&quot;</span>, url);
        <a name="a6"></a><a class="code" href="group__link.html#ga2b06ab16d1f6436cd8d36dbff2b5c022">sp_link_release</a>(l);
    }
}


<span class="keyword">static</span> <span class="keywordtype">void</span> SP_CALLCONV got_toplist(<a class="code" href="group__types.html#ga723de429cd073bcf5d13fb4e0f466ffd" title="A handle to a toplist browse result.">sp_toplistbrowse</a> *result, <span class="keywordtype">void</span> *userdata)
{
    <span class="keywordtype">int</span> i;

    <span class="comment">// We print from all types. Only one of the loops will acually yield anything.</span>

    <span class="keywordflow">for</span>(i = 0; i &lt; <a name="a7"></a><a class="code" href="group__toplist.html#gae2f5c09fbbf947834b1b1e73461f1fb3">sp_toplistbrowse_num_artists</a>(result); i++)
        print_artist(i + 1, <a name="a8"></a><a class="code" href="group__toplist.html#ga504cc45074d40c817dffbcc2906ef57f">sp_toplistbrowse_artist</a>(result, i));

    <span class="keywordflow">for</span>(i = 0; i &lt; <a name="a9"></a><a class="code" href="group__toplist.html#ga69f5e70269c1eb08e1ddb1c77bb8c3e3">sp_toplistbrowse_num_albums</a>(result); i++)
        print_album(i + 1, <a name="a10"></a><a class="code" href="group__toplist.html#gaa080ace445d269f56942ac3d7f1f157e">sp_toplistbrowse_album</a>(result, i));

    <span class="keywordflow">for</span>(i = 0; i &lt; <a name="a11"></a><a class="code" href="group__toplist.html#gaeb0ddfd565474dc7e444aabebbc119b7">sp_toplistbrowse_num_tracks</a>(result); i++) {
        printf(<span class="stringliteral">&quot;%3d: &quot;</span>, i + 1);
        print_track(<a name="a12"></a><a class="code" href="group__toplist.html#gaf3d00b8bf089134a4f320a8d3d6ab683">sp_toplistbrowse_track</a>(result, i));
    }

    <a name="a13"></a><a class="code" href="group__toplist.html#gac6cf969c9cb6b431aeaa4723820ca8de">sp_toplistbrowse_release</a>(result);
    cmd_done();
}



<span class="keyword">static</span> <span class="keywordtype">void</span> toplist_usage(<span class="keywordtype">void</span>)
{
    fprintf(stderr, <span class="stringliteral">&quot;Usage: toplist (tracks | albums | artists) (global | region &lt;countrycode&gt; | user)\n&quot;</span>);
}

<span class="keywordtype">int</span> cmd_toplist(<span class="keywordtype">int</span> argc, <span class="keywordtype">char</span> **argv)
{
    <a class="code" href="group__toplist.html#ga220f32522efb2828e4f8ffb949af234a">sp_toplisttype</a> type;
    <a class="code" href="group__toplist.html#ga6fa5cfed2cbb33f2f64542d0b63f6c8d">sp_toplistregion</a> region;

    <span class="keywordflow">if</span>(argc &lt; 3) {
        toplist_usage();
        <span class="keywordflow">return</span> -1;
    }

    <span class="keywordflow">if</span>(!strcasecmp(argv[1], <span class="stringliteral">&quot;artists&quot;</span>))
        type = SP_TOPLIST_TYPE_ARTISTS;
    <span class="keywordflow">else</span> <span class="keywordflow">if</span>(!strcasecmp(argv[1], <span class="stringliteral">&quot;albums&quot;</span>))
        type = SP_TOPLIST_TYPE_ALBUMS;
    <span class="keywordflow">else</span> <span class="keywordflow">if</span>(!strcasecmp(argv[1], <span class="stringliteral">&quot;tracks&quot;</span>))
        type = SP_TOPLIST_TYPE_TRACKS;
    <span class="keywordflow">else</span> {
        toplist_usage();
        <span class="keywordflow">return</span> -1;
    }


    <span class="keywordflow">if</span>(!strcasecmp(argv[2], <span class="stringliteral">&quot;global&quot;</span>))
        region = SP_TOPLIST_REGION_EVERYWHERE;
    <span class="keywordflow">else</span> <span class="keywordflow">if</span>(!strcasecmp(argv[2], <span class="stringliteral">&quot;user&quot;</span>))
        region = SP_TOPLIST_REGION_USER;
    <span class="keywordflow">else</span> <span class="keywordflow">if</span>(!strcasecmp(argv[2], <span class="stringliteral">&quot;region&quot;</span>)) {

        <span class="keywordflow">if</span>(argc != 4 || strlen(argv[3]) != 2) {
            toplist_usage();
            <span class="keywordflow">return</span> -1;
        }
        region = <a name="a14"></a><a class="code" href="group__toplist.html#gaa078b44491f976af43e4941fd1dd032c">SP_TOPLIST_REGION</a>(argv[3][0], argv[3][1]);
    } <span class="keywordflow">else</span> {
        toplist_usage();
        <span class="keywordflow">return</span> -1;
    }

    <a name="a15"></a><a class="code" href="group__toplist.html#gac2fe366e0050747438e09cdd22ed0e31">sp_toplistbrowse_create</a>(g_session, type, region, NULL, got_toplist, NULL);
    <span class="keywordflow">return</span> 0;
}
</pre></div> </div>
</div>
<hr size="1"><address style="text-align: right;"><small>
Generated on Wed Jun 13 2012 14:22:40.<br>
Copyright &copy; 2006&ndash;2012 Spotify Ltd</small></address>
</body>
</html>


================================================
FILE: libspotify/docs/images/spotify-core.txt
================================================
Uses SPOTIFY(R) CORE


================================================
FILE: libspotify/examples/Makefile
================================================
EXAMPLES=jukebox spshell localfiles

.PHONY: all clean

ifdef LIBSPOTIFY_PATH
ARG=LIBSPOTIFY_PATH="$(shell cd "$(LIBSPOTIFY_PATH)" && pwd)"
endif

all clean:
	for a in $(EXAMPLES); do $(MAKE) -C $$a $(ARG) $@; done


================================================
FILE: libspotify/examples/Randomify/English.lproj/InfoPlist.strings
================================================
/* Localized versions of Info.plist keys */



================================================
FILE: libspotify/examples/Randomify/English.lproj/MainMenu.xib
================================================
<?xml version="1.0" encoding="UTF-8"?>
<archive type="com.apple.InterfaceBuilder3.Cocoa.XIB" version="7.10">
	<data>
		<int key="IBDocument.SystemTarget">1050</int>
		<string key="IBDocument.SystemVersion">10C540</string>
		<string key="IBDocument.InterfaceBuilderVersion">740</string>
		<string key="IBDocument.AppKitVersion">1038.25</string>
		<string key="IBDocument.HIToolboxVersion">458.00</string>
		<object class="NSMutableDictionary" key="IBDocument.PluginVersions">
			<string key="NS.key.0">com.apple.InterfaceBuilder.CocoaPlugin</string>
			<string key="NS.object.0">740</string>
		</object>
		<object class="NSMutableArray" key="IBDocument.EditedObjectIDs">
			<bool key="EncodedWithXMLCoder">YES</bool>
			<integer value="29"/>
			<integer value="372"/>
		</object>
		<object class="NSArray" key="IBDocument.PluginDependencies">
			<bool key="EncodedWithXMLCoder">YES</bool>
			<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
		</object>
		<object class="NSMutableDictionary" key="IBDocument.Metadata">
			<bool key="EncodedWithXMLCoder">YES</bool>
			<object class="NSArray" key="dict.sortedKeys" id="0">
				<bool key="EncodedWithXMLCoder">YES</bool>
			</object>
			<object class="NSMutableArray" key="dict.values">
				<bool key="EncodedWithXMLCoder">YES</bool>
			</object>
		</object>
		<object class="NSMutableArray" key="IBDocument.RootObjects" id="1048">
			<bool key="EncodedWithXMLCoder">YES</bool>
			<object class="NSCustomObject" id="1021">
				<string key="NSClassName">NSApplication</string>
			</object>
			<object class="NSCustomObject" id="1014">
				<string key="NSClassName">FirstResponder</string>
			</object>
			<object class="NSCustomObject" id="1050">
				<string key="NSClassName">NSApplication</string>
			</object>
			<object class="NSMenu" id="649796088">
				<string key="NSTitle">AMainMenu</string>
				<object class="NSMutableArray" key="NSMenuItems">
					<bool key="EncodedWithXMLCoder">YES</bool>
					<object class="NSMenuItem" id="694149608">
						<reference key="NSMenu" ref="649796088"/>
						<string key="NSTitle">Randomify</string>
						<string key="NSKeyEquiv"/>
						<int key="NSKeyEquivModMask">1048576</int>
						<int key="NSMnemonicLoc">2147483647</int>
						<object class="NSCustomResource" key="NSOnImage" id="35465992">
							<string key="NSClassName">NSImage</string>
							<string key="NSResourceName">NSMenuCheckmark</string>
						</object>
						<object class="NSCustomResource" key="NSMixedImage" id="502551668">
							<string key="NSClassName">NSImage</string>
							<string key="NSResourceName">NSMenuMixedState</string>
						</object>
						<string key="NSAction">submenuAction:</string>
						<object class="NSMenu" key="NSSubmenu" id="110575045">
							<string key="NSTitle">Randomify</string>
							<object class="NSMutableArray" key="NSMenuItems">
								<bool key="EncodedWithXMLCoder">YES</bool>
								<object class="NSMenuItem" id="238522557">
									<reference key="NSMenu" ref="110575045"/>
									<string key="NSTitle">About Randomify</string>
									<string key="NSKeyEquiv"/>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="304266470">
									<reference key="NSMenu" ref="110575045"/>
									<bool key="NSIsDisabled">YES</bool>
									<bool key="NSIsSeparator">YES</bool>
									<string key="NSTitle"/>
									<string key="NSKeyEquiv"/>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="609285721">
									<reference key="NSMenu" ref="110575045"/>
									<string key="NSTitle">Preferences…</string>
									<string key="NSKeyEquiv">,</string>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="481834944">
									<reference key="NSMenu" ref="110575045"/>
									<bool key="NSIsDisabled">YES</bool>
									<bool key="NSIsSeparator">YES</bool>
									<string key="NSTitle"/>
									<string key="NSKeyEquiv"/>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="1046388886">
									<reference key="NSMenu" ref="110575045"/>
									<string key="NSTitle">Services</string>
									<string key="NSKeyEquiv"/>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
									<string key="NSAction">submenuAction:</string>
									<object class="NSMenu" key="NSSubmenu" id="752062318">
										<string key="NSTitle">Services</string>
										<object class="NSMutableArray" key="NSMenuItems">
											<bool key="EncodedWithXMLCoder">YES</bool>
										</object>
										<string key="NSName">_NSServicesMenu</string>
									</object>
								</object>
								<object class="NSMenuItem" id="646227648">
									<reference key="NSMenu" ref="110575045"/>
									<bool key="NSIsDisabled">YES</bool>
									<bool key="NSIsSeparator">YES</bool>
									<string key="NSTitle"/>
									<string key="NSKeyEquiv"/>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="755159360">
									<reference key="NSMenu" ref="110575045"/>
									<string key="NSTitle">Hide Randomify</string>
									<string key="NSKeyEquiv">h</string>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="342932134">
									<reference key="NSMenu" ref="110575045"/>
									<string key="NSTitle">Hide Others</string>
									<string key="NSKeyEquiv">h</string>
									<int key="NSKeyEquivModMask">1572864</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="908899353">
									<reference key="NSMenu" ref="110575045"/>
									<string key="NSTitle">Show All</string>
									<string key="NSKeyEquiv"/>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="1056857174">
									<reference key="NSMenu" ref="110575045"/>
									<bool key="NSIsDisabled">YES</bool>
									<bool key="NSIsSeparator">YES</bool>
									<string key="NSTitle"/>
									<string key="NSKeyEquiv"/>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="632727374">
									<reference key="NSMenu" ref="110575045"/>
									<string key="NSTitle">Quit Randomify</string>
									<string key="NSKeyEquiv">q</string>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
							</object>
							<string key="NSName">_NSAppleMenu</string>
						</object>
					</object>
					<object class="NSMenuItem" id="379814623">
						<reference key="NSMenu" ref="649796088"/>
						<string key="NSTitle">File</string>
						<string key="NSKeyEquiv"/>
						<int key="NSKeyEquivModMask">1048576</int>
						<int key="NSMnemonicLoc">2147483647</int>
						<reference key="NSOnImage" ref="35465992"/>
						<reference key="NSMixedImage" ref="502551668"/>
						<string key="NSAction">submenuAction:</string>
						<object class="NSMenu" key="NSSubmenu" id="720053764">
							<string key="NSTitle">File</string>
							<object class="NSMutableArray" key="NSMenuItems">
								<bool key="EncodedWithXMLCoder">YES</bool>
								<object class="NSMenuItem" id="705341025">
									<reference key="NSMenu" ref="720053764"/>
									<string key="NSTitle">New</string>
									<string key="NSKeyEquiv">n</string>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="722745758">
									<reference key="NSMenu" ref="720053764"/>
									<string key="NSTitle">Open…</string>
									<string key="NSKeyEquiv">o</string>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="1025936716">
									<reference key="NSMenu" ref="720053764"/>
									<string key="NSTitle">Open Recent</string>
									<string key="NSKeyEquiv"/>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
									<string key="NSAction">submenuAction:</string>
									<object class="NSMenu" key="NSSubmenu" id="1065607017">
										<string key="NSTitle">Open Recent</string>
										<object class="NSMutableArray" key="NSMenuItems">
											<bool key="EncodedWithXMLCoder">YES</bool>
											<object class="NSMenuItem" id="759406840">
												<reference key="NSMenu" ref="1065607017"/>
												<string key="NSTitle">Clear Menu</string>
												<string key="NSKeyEquiv"/>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
										</object>
										<string key="NSName">_NSRecentDocumentsMenu</string>
									</object>
								</object>
								<object class="NSMenuItem" id="425164168">
									<reference key="NSMenu" ref="720053764"/>
									<bool key="NSIsDisabled">YES</bool>
									<bool key="NSIsSeparator">YES</bool>
									<string key="NSTitle"/>
									<string key="NSKeyEquiv"/>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="776162233">
									<reference key="NSMenu" ref="720053764"/>
									<string key="NSTitle">Close</string>
									<string key="NSKeyEquiv">w</string>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="1023925487">
									<reference key="NSMenu" ref="720053764"/>
									<string key="NSTitle">Save</string>
									<string key="NSKeyEquiv">s</string>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="117038363">
									<reference key="NSMenu" ref="720053764"/>
									<string key="NSTitle">Save As…</string>
									<string key="NSKeyEquiv">S</string>
									<int key="NSKeyEquivModMask">1179648</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="579971712">
									<reference key="NSMenu" ref="720053764"/>
									<string key="NSTitle">Revert to Saved</string>
									<string key="NSKeyEquiv"/>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="1010469920">
									<reference key="NSMenu" ref="720053764"/>
									<bool key="NSIsDisabled">YES</bool>
									<bool key="NSIsSeparator">YES</bool>
									<string key="NSTitle"/>
									<string key="NSKeyEquiv"/>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="294629803">
									<reference key="NSMenu" ref="720053764"/>
									<string key="NSTitle">Page Setup...</string>
									<string key="NSKeyEquiv">P</string>
									<int key="NSKeyEquivModMask">1179648</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
									<string key="NSToolTip"/>
								</object>
								<object class="NSMenuItem" id="49223823">
									<reference key="NSMenu" ref="720053764"/>
									<string key="NSTitle">Print…</string>
									<string key="NSKeyEquiv">p</string>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
							</object>
						</object>
					</object>
					<object class="NSMenuItem" id="952259628">
						<reference key="NSMenu" ref="649796088"/>
						<string key="NSTitle">Edit</string>
						<string key="NSKeyEquiv"/>
						<int key="NSKeyEquivModMask">1048576</int>
						<int key="NSMnemonicLoc">2147483647</int>
						<reference key="NSOnImage" ref="35465992"/>
						<reference key="NSMixedImage" ref="502551668"/>
						<string key="NSAction">submenuAction:</string>
						<object class="NSMenu" key="NSSubmenu" id="789758025">
							<string key="NSTitle">Edit</string>
							<object class="NSMutableArray" key="NSMenuItems">
								<bool key="EncodedWithXMLCoder">YES</bool>
								<object class="NSMenuItem" id="1058277027">
									<reference key="NSMenu" ref="789758025"/>
									<string key="NSTitle">Undo</string>
									<string key="NSKeyEquiv">z</string>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="790794224">
									<reference key="NSMenu" ref="789758025"/>
									<string key="NSTitle">Redo</string>
									<string key="NSKeyEquiv">Z</string>
									<int key="NSKeyEquivModMask">1179648</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="1040322652">
									<reference key="NSMenu" ref="789758025"/>
									<bool key="NSIsDisabled">YES</bool>
									<bool key="NSIsSeparator">YES</bool>
									<string key="NSTitle"/>
									<string key="NSKeyEquiv"/>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="296257095">
									<reference key="NSMenu" ref="789758025"/>
									<string key="NSTitle">Cut</string>
									<string key="NSKeyEquiv">x</string>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="860595796">
									<reference key="NSMenu" ref="789758025"/>
									<string key="NSTitle">Copy</string>
									<string key="NSKeyEquiv">c</string>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="29853731">
									<reference key="NSMenu" ref="789758025"/>
									<string key="NSTitle">Paste</string>
									<string key="NSKeyEquiv">v</string>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="82994268">
									<reference key="NSMenu" ref="789758025"/>
									<string key="NSTitle">Paste and Match Style</string>
									<string key="NSKeyEquiv">V</string>
									<int key="NSKeyEquivModMask">1572864</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="437104165">
									<reference key="NSMenu" ref="789758025"/>
									<string key="NSTitle">Delete</string>
									<string key="NSKeyEquiv"/>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="583158037">
									<reference key="NSMenu" ref="789758025"/>
									<string key="NSTitle">Select All</string>
									<string key="NSKeyEquiv">a</string>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="212016141">
									<reference key="NSMenu" ref="789758025"/>
									<bool key="NSIsDisabled">YES</bool>
									<bool key="NSIsSeparator">YES</bool>
									<string key="NSTitle"/>
									<string key="NSKeyEquiv"/>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="892235320">
									<reference key="NSMenu" ref="789758025"/>
									<string key="NSTitle">Find</string>
									<string key="NSKeyEquiv"/>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
									<string key="NSAction">submenuAction:</string>
									<object class="NSMenu" key="NSSubmenu" id="963351320">
										<string key="NSTitle">Find</string>
										<object class="NSMutableArray" key="NSMenuItems">
											<bool key="EncodedWithXMLCoder">YES</bool>
											<object class="NSMenuItem" id="447796847">
												<reference key="NSMenu" ref="963351320"/>
												<string key="NSTitle">Find…</string>
												<string key="NSKeyEquiv">f</string>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
												<int key="NSTag">1</int>
											</object>
											<object class="NSMenuItem" id="326711663">
												<reference key="NSMenu" ref="963351320"/>
												<string key="NSTitle">Find Next</string>
												<string key="NSKeyEquiv">g</string>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
												<int key="NSTag">2</int>
											</object>
											<object class="NSMenuItem" id="270902937">
												<reference key="NSMenu" ref="963351320"/>
												<string key="NSTitle">Find Previous</string>
												<string key="NSKeyEquiv">G</string>
												<int key="NSKeyEquivModMask">1179648</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
												<int key="NSTag">3</int>
											</object>
											<object class="NSMenuItem" id="159080638">
												<reference key="NSMenu" ref="963351320"/>
												<string key="NSTitle">Use Selection for Find</string>
												<string key="NSKeyEquiv">e</string>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
												<int key="NSTag">7</int>
											</object>
											<object class="NSMenuItem" id="88285865">
												<reference key="NSMenu" ref="963351320"/>
												<string key="NSTitle">Jump to Selection</string>
												<string key="NSKeyEquiv">j</string>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
										</object>
									</object>
								</object>
								<object class="NSMenuItem" id="972420730">
									<reference key="NSMenu" ref="789758025"/>
									<string key="NSTitle">Spelling and Grammar</string>
									<string key="NSKeyEquiv"/>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
									<string key="NSAction">submenuAction:</string>
									<object class="NSMenu" key="NSSubmenu" id="769623530">
										<string key="NSTitle">Spelling and Grammar</string>
										<object class="NSMutableArray" key="NSMenuItems">
											<bool key="EncodedWithXMLCoder">YES</bool>
											<object class="NSMenuItem" id="679648819">
												<reference key="NSMenu" ref="769623530"/>
												<string key="NSTitle">Show Spelling and Grammar</string>
												<string key="NSKeyEquiv">:</string>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="96193923">
												<reference key="NSMenu" ref="769623530"/>
												<string key="NSTitle">Check Document Now</string>
												<string key="NSKeyEquiv">;</string>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="859480356">
												<reference key="NSMenu" ref="769623530"/>
												<bool key="NSIsDisabled">YES</bool>
												<bool key="NSIsSeparator">YES</bool>
												<string key="NSTitle"/>
												<string key="NSKeyEquiv"/>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="948374510">
												<reference key="NSMenu" ref="769623530"/>
												<string key="NSTitle">Check Spelling While Typing</string>
												<string key="NSKeyEquiv"/>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="967646866">
												<reference key="NSMenu" ref="769623530"/>
												<string key="NSTitle">Check Grammar With Spelling</string>
												<string key="NSKeyEquiv"/>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="795346622">
												<reference key="NSMenu" ref="769623530"/>
												<string key="NSTitle">Correct Spelling Automatically</string>
												<string key="NSKeyEquiv"/>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
										</object>
									</object>
								</object>
								<object class="NSMenuItem" id="507821607">
									<reference key="NSMenu" ref="789758025"/>
									<string key="NSTitle">Substitutions</string>
									<string key="NSKeyEquiv"/>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
									<string key="NSAction">submenuAction:</string>
									<object class="NSMenu" key="NSSubmenu" id="698887838">
										<string key="NSTitle">Substitutions</string>
										<object class="NSMutableArray" key="NSMenuItems">
											<bool key="EncodedWithXMLCoder">YES</bool>
											<object class="NSMenuItem" id="65139061">
												<reference key="NSMenu" ref="698887838"/>
												<string key="NSTitle">Show Substitutions</string>
												<string key="NSKeyEquiv"/>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="19036812">
												<reference key="NSMenu" ref="698887838"/>
												<bool key="NSIsDisabled">YES</bool>
												<bool key="NSIsSeparator">YES</bool>
												<string key="NSTitle"/>
												<string key="NSKeyEquiv"/>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="605118523">
												<reference key="NSMenu" ref="698887838"/>
												<string key="NSTitle">Smart Copy/Paste</string>
												<string key="NSKeyEquiv">f</string>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
												<int key="NSTag">1</int>
											</object>
											<object class="NSMenuItem" id="197661976">
												<reference key="NSMenu" ref="698887838"/>
												<string key="NSTitle">Smart Quotes</string>
												<string key="NSKeyEquiv">g</string>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
												<int key="NSTag">2</int>
											</object>
											<object class="NSMenuItem" id="672708820">
												<reference key="NSMenu" ref="698887838"/>
												<string key="NSTitle">Smart Dashes</string>
												<string key="NSKeyEquiv"/>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="708854459">
												<reference key="NSMenu" ref="698887838"/>
												<string key="NSTitle">Smart Links</string>
												<string key="NSKeyEquiv">G</string>
												<int key="NSKeyEquivModMask">1179648</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
												<int key="NSTag">3</int>
											</object>
											<object class="NSMenuItem" id="537092702">
												<reference key="NSMenu" ref="698887838"/>
												<string key="NSTitle">Text Replacement</string>
												<string key="NSKeyEquiv"/>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
										</object>
									</object>
								</object>
								<object class="NSMenuItem" id="288088188">
									<reference key="NSMenu" ref="789758025"/>
									<string key="NSTitle">Transformations</string>
									<string key="NSKeyEquiv"/>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
									<string key="NSAction">submenuAction:</string>
									<object class="NSMenu" key="NSSubmenu" id="579392910">
										<string key="NSTitle">Transformations</string>
										<object class="NSMutableArray" key="NSMenuItems">
											<bool key="EncodedWithXMLCoder">YES</bool>
											<object class="NSMenuItem" id="1060694897">
												<reference key="NSMenu" ref="579392910"/>
												<string key="NSTitle">Make Upper Case</string>
												<string key="NSKeyEquiv"/>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="879586729">
												<reference key="NSMenu" ref="579392910"/>
												<string key="NSTitle">Make Lower Case</string>
												<string key="NSKeyEquiv"/>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="56570060">
												<reference key="NSMenu" ref="579392910"/>
												<string key="NSTitle">Capitalize</string>
												<string key="NSKeyEquiv"/>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
										</object>
									</object>
								</object>
								<object class="NSMenuItem" id="676164635">
									<reference key="NSMenu" ref="789758025"/>
									<string key="NSTitle">Speech</string>
									<string key="NSKeyEquiv"/>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
									<string key="NSAction">submenuAction:</string>
									<object class="NSMenu" key="NSSubmenu" id="785027613">
										<string key="NSTitle">Speech</string>
										<object class="NSMutableArray" key="NSMenuItems">
											<bool key="EncodedWithXMLCoder">YES</bool>
											<object class="NSMenuItem" id="731782645">
												<reference key="NSMenu" ref="785027613"/>
												<string key="NSTitle">Start Speaking</string>
												<string key="NSKeyEquiv"/>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="680220178">
												<reference key="NSMenu" ref="785027613"/>
												<string key="NSTitle">Stop Speaking</string>
												<string key="NSKeyEquiv"/>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
										</object>
									</object>
								</object>
							</object>
						</object>
					</object>
					<object class="NSMenuItem" id="302598603">
						<reference key="NSMenu" ref="649796088"/>
						<string key="NSTitle">Format</string>
						<string key="NSKeyEquiv"/>
						<int key="NSMnemonicLoc">2147483647</int>
						<reference key="NSOnImage" ref="35465992"/>
						<reference key="NSMixedImage" ref="502551668"/>
						<string key="NSAction">submenuAction:</string>
						<object class="NSMenu" key="NSSubmenu" id="941447902">
							<string key="NSTitle">Format</string>
							<object class="NSMutableArray" key="NSMenuItems">
								<bool key="EncodedWithXMLCoder">YES</bool>
								<object class="NSMenuItem" id="792887677">
									<reference key="NSMenu" ref="941447902"/>
									<string key="NSTitle">Font</string>
									<string key="NSKeyEquiv"/>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
									<string key="NSAction">submenuAction:</string>
									<object class="NSMenu" key="NSSubmenu" id="786677654">
										<string key="NSTitle">Font</string>
										<object class="NSMutableArray" key="NSMenuItems">
											<bool key="EncodedWithXMLCoder">YES</bool>
											<object class="NSMenuItem" id="159677712">
												<reference key="NSMenu" ref="786677654"/>
												<string key="NSTitle">Show Fonts</string>
												<string key="NSKeyEquiv">t</string>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="305399458">
												<reference key="NSMenu" ref="786677654"/>
												<string key="NSTitle">Bold</string>
												<string key="NSKeyEquiv">b</string>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
												<int key="NSTag">2</int>
											</object>
											<object class="NSMenuItem" id="814362025">
												<reference key="NSMenu" ref="786677654"/>
												<string key="NSTitle">Italic</string>
												<string key="NSKeyEquiv">i</string>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
												<int key="NSTag">1</int>
											</object>
											<object class="NSMenuItem" id="330926929">
												<reference key="NSMenu" ref="786677654"/>
												<string key="NSTitle">Underline</string>
												<string key="NSKeyEquiv">u</string>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="533507878">
												<reference key="NSMenu" ref="786677654"/>
												<bool key="NSIsDisabled">YES</bool>
												<bool key="NSIsSeparator">YES</bool>
												<string key="NSTitle"/>
												<string key="NSKeyEquiv"/>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="158063935">
												<reference key="NSMenu" ref="786677654"/>
												<string key="NSTitle">Bigger</string>
												<string key="NSKeyEquiv">+</string>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
												<int key="NSTag">3</int>
											</object>
											<object class="NSMenuItem" id="885547335">
												<reference key="NSMenu" ref="786677654"/>
												<string key="NSTitle">Smaller</string>
												<string key="NSKeyEquiv">-</string>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
												<int key="NSTag">4</int>
											</object>
											<object class="NSMenuItem" id="901062459">
												<reference key="NSMenu" ref="786677654"/>
												<bool key="NSIsDisabled">YES</bool>
												<bool key="NSIsSeparator">YES</bool>
												<string key="NSTitle"/>
												<string key="NSKeyEquiv"/>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="767671776">
												<reference key="NSMenu" ref="786677654"/>
												<string key="NSTitle">Kern</string>
												<string key="NSKeyEquiv"/>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
												<string key="NSAction">submenuAction:</string>
												<object class="NSMenu" key="NSSubmenu" id="175441468">
													<string key="NSTitle">Kern</string>
													<object class="NSMutableArray" key="NSMenuItems">
														<bool key="EncodedWithXMLCoder">YES</bool>
														<object class="NSMenuItem" id="252969304">
															<reference key="NSMenu" ref="175441468"/>
															<string key="NSTitle">Use Default</string>
															<string key="NSKeyEquiv"/>
															<int key="NSMnemonicLoc">2147483647</int>
															<reference key="NSOnImage" ref="35465992"/>
															<reference key="NSMixedImage" ref="502551668"/>
														</object>
														<object class="NSMenuItem" id="766922938">
															<reference key="NSMenu" ref="175441468"/>
															<string key="NSTitle">Use None</string>
															<string key="NSKeyEquiv"/>
															<int key="NSMnemonicLoc">2147483647</int>
															<reference key="NSOnImage" ref="35465992"/>
															<reference key="NSMixedImage" ref="502551668"/>
														</object>
														<object class="NSMenuItem" id="677519740">
															<reference key="NSMenu" ref="175441468"/>
															<string key="NSTitle">Tighten</string>
															<string key="NSKeyEquiv"/>
															<int key="NSMnemonicLoc">2147483647</int>
															<reference key="NSOnImage" ref="35465992"/>
															<reference key="NSMixedImage" ref="502551668"/>
														</object>
														<object class="NSMenuItem" id="238351151">
															<reference key="NSMenu" ref="175441468"/>
															<string key="NSTitle">Loosen</string>
															<string key="NSKeyEquiv"/>
															<int key="NSMnemonicLoc">2147483647</int>
															<reference key="NSOnImage" ref="35465992"/>
															<reference key="NSMixedImage" ref="502551668"/>
														</object>
													</object>
												</object>
											</object>
											<object class="NSMenuItem" id="691570813">
												<reference key="NSMenu" ref="786677654"/>
												<string key="NSTitle">Ligature</string>
												<string key="NSKeyEquiv"/>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
												<string key="NSAction">submenuAction:</string>
												<object class="NSMenu" key="NSSubmenu" id="1058217995">
													<string key="NSTitle">Ligature</string>
													<object class="NSMutableArray" key="NSMenuItems">
														<bool key="EncodedWithXMLCoder">YES</bool>
														<object class="NSMenuItem" id="706297211">
															<reference key="NSMenu" ref="1058217995"/>
															<string key="NSTitle">Use Default</string>
															<string key="NSKeyEquiv"/>
															<int key="NSMnemonicLoc">2147483647</int>
															<reference key="NSOnImage" ref="35465992"/>
															<reference key="NSMixedImage" ref="502551668"/>
														</object>
														<object class="NSMenuItem" id="568384683">
															<reference key="NSMenu" ref="1058217995"/>
															<string key="NSTitle">Use None</string>
															<string key="NSKeyEquiv"/>
															<int key="NSMnemonicLoc">2147483647</int>
															<reference key="NSOnImage" ref="35465992"/>
															<reference key="NSMixedImage" ref="502551668"/>
														</object>
														<object class="NSMenuItem" id="663508465">
															<reference key="NSMenu" ref="1058217995"/>
															<string key="NSTitle">Use All</string>
															<string key="NSKeyEquiv"/>
															<int key="NSMnemonicLoc">2147483647</int>
															<reference key="NSOnImage" ref="35465992"/>
															<reference key="NSMixedImage" ref="502551668"/>
														</object>
													</object>
												</object>
											</object>
											<object class="NSMenuItem" id="769124883">
												<reference key="NSMenu" ref="786677654"/>
												<string key="NSTitle">Baseline</string>
												<string key="NSKeyEquiv"/>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
												<string key="NSAction">submenuAction:</string>
												<object class="NSMenu" key="NSSubmenu" id="18263474">
													<string key="NSTitle">Baseline</string>
													<object class="NSMutableArray" key="NSMenuItems">
														<bool key="EncodedWithXMLCoder">YES</bool>
														<object class="NSMenuItem" id="257962622">
															<reference key="NSMenu" ref="18263474"/>
															<string key="NSTitle">Use Default</string>
															<string key="NSKeyEquiv"/>
															<int key="NSMnemonicLoc">2147483647</int>
															<reference key="NSOnImage" ref="35465992"/>
															<reference key="NSMixedImage" ref="502551668"/>
														</object>
														<object class="NSMenuItem" id="644725453">
															<reference key="NSMenu" ref="18263474"/>
															<string key="NSTitle">Superscript</string>
															<string key="NSKeyEquiv"/>
															<int key="NSMnemonicLoc">2147483647</int>
															<reference key="NSOnImage" ref="35465992"/>
															<reference key="NSMixedImage" ref="502551668"/>
														</object>
														<object class="NSMenuItem" id="1037576581">
															<reference key="NSMenu" ref="18263474"/>
															<string key="NSTitle">Subscript</string>
															<string key="NSKeyEquiv"/>
															<int key="NSMnemonicLoc">2147483647</int>
															<reference key="NSOnImage" ref="35465992"/>
															<reference key="NSMixedImage" ref="502551668"/>
														</object>
														<object class="NSMenuItem" id="941806246">
															<reference key="NSMenu" ref="18263474"/>
															<string key="NSTitle">Raise</string>
															<string key="NSKeyEquiv"/>
															<int key="NSMnemonicLoc">2147483647</int>
															<reference key="NSOnImage" ref="35465992"/>
															<reference key="NSMixedImage" ref="502551668"/>
														</object>
														<object class="NSMenuItem" id="1045724900">
															<reference key="NSMenu" ref="18263474"/>
															<string key="NSTitle">Lower</string>
															<string key="NSKeyEquiv"/>
															<int key="NSMnemonicLoc">2147483647</int>
															<reference key="NSOnImage" ref="35465992"/>
															<reference key="NSMixedImage" ref="502551668"/>
														</object>
													</object>
												</object>
											</object>
											<object class="NSMenuItem" id="739652853">
												<reference key="NSMenu" ref="786677654"/>
												<bool key="NSIsDisabled">YES</bool>
												<bool key="NSIsSeparator">YES</bool>
												<string key="NSTitle"/>
												<string key="NSKeyEquiv"/>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="1012600125">
												<reference key="NSMenu" ref="786677654"/>
												<string key="NSTitle">Show Colors</string>
												<string key="NSKeyEquiv">C</string>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="214559597">
												<reference key="NSMenu" ref="786677654"/>
												<bool key="NSIsDisabled">YES</bool>
												<bool key="NSIsSeparator">YES</bool>
												<string key="NSTitle"/>
												<string key="NSKeyEquiv"/>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="596732606">
												<reference key="NSMenu" ref="786677654"/>
												<string key="NSTitle">Copy Style</string>
												<string key="NSKeyEquiv">c</string>
												<int key="NSKeyEquivModMask">1572864</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="393423671">
												<reference key="NSMenu" ref="786677654"/>
												<string key="NSTitle">Paste Style</string>
												<string key="NSKeyEquiv">v</string>
												<int key="NSKeyEquivModMask">1572864</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
										</object>
										<string key="NSName">_NSFontMenu</string>
									</object>
								</object>
								<object class="NSMenuItem" id="215659978">
									<reference key="NSMenu" ref="941447902"/>
									<string key="NSTitle">Text</string>
									<string key="NSKeyEquiv"/>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
									<string key="NSAction">submenuAction:</string>
									<object class="NSMenu" key="NSSubmenu" id="446991534">
										<string key="NSTitle">Text</string>
										<object class="NSMutableArray" key="NSMenuItems">
											<bool key="EncodedWithXMLCoder">YES</bool>
											<object class="NSMenuItem" id="875092757">
												<reference key="NSMenu" ref="446991534"/>
												<string key="NSTitle">Align Left</string>
												<string key="NSKeyEquiv">{</string>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="630155264">
												<reference key="NSMenu" ref="446991534"/>
												<string key="NSTitle">Center</string>
												<string key="NSKeyEquiv">|</string>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="945678886">
												<reference key="NSMenu" ref="446991534"/>
												<string key="NSTitle">Justify</string>
												<string key="NSKeyEquiv"/>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="512868991">
												<reference key="NSMenu" ref="446991534"/>
												<string key="NSTitle">Align Right</string>
												<string key="NSKeyEquiv">}</string>
												<int key="NSKeyEquivModMask">1048576</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="163117631">
												<reference key="NSMenu" ref="446991534"/>
												<bool key="NSIsDisabled">YES</bool>
												<bool key="NSIsSeparator">YES</bool>
												<string key="NSTitle"/>
												<string key="NSKeyEquiv"/>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="31516759">
												<reference key="NSMenu" ref="446991534"/>
												<string key="NSTitle">Writing Direction</string>
												<string key="NSKeyEquiv"/>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
												<string key="NSAction">submenuAction:</string>
												<object class="NSMenu" key="NSSubmenu" id="956096989">
													<string key="NSTitle">Writing Direction</string>
													<object class="NSMutableArray" key="NSMenuItems">
														<bool key="EncodedWithXMLCoder">YES</bool>
														<object class="NSMenuItem" id="257099033">
															<reference key="NSMenu" ref="956096989"/>
															<bool key="NSIsDisabled">YES</bool>
															<string key="NSTitle">Paragraph</string>
															<string key="NSKeyEquiv"/>
															<int key="NSMnemonicLoc">2147483647</int>
															<reference key="NSOnImage" ref="35465992"/>
															<reference key="NSMixedImage" ref="502551668"/>
														</object>
														<object class="NSMenuItem" id="551969625">
															<reference key="NSMenu" ref="956096989"/>
															<string type="base64-UTF8" key="NSTitle">CURlZmF1bHQ</string>
															<string key="NSKeyEquiv"/>
															<int key="NSMnemonicLoc">2147483647</int>
															<reference key="NSOnImage" ref="35465992"/>
															<reference key="NSMixedImage" ref="502551668"/>
														</object>
														<object class="NSMenuItem" id="249532473">
															<reference key="NSMenu" ref="956096989"/>
															<string type="base64-UTF8" key="NSTitle">CUxlZnQgdG8gUmlnaHQ</string>
															<string key="NSKeyEquiv"/>
															<int key="NSMnemonicLoc">2147483647</int>
															<reference key="NSOnImage" ref="35465992"/>
															<reference key="NSMixedImage" ref="502551668"/>
														</object>
														<object class="NSMenuItem" id="607364498">
															<reference key="NSMenu" ref="956096989"/>
															<string type="base64-UTF8" key="NSTitle">CVJpZ2h0IHRvIExlZnQ</string>
															<string key="NSKeyEquiv"/>
															<int key="NSMnemonicLoc">2147483647</int>
															<reference key="NSOnImage" ref="35465992"/>
															<reference key="NSMixedImage" ref="502551668"/>
														</object>
														<object class="NSMenuItem" id="508151438">
															<reference key="NSMenu" ref="956096989"/>
															<bool key="NSIsDisabled">YES</bool>
															<bool key="NSIsSeparator">YES</bool>
															<string key="NSTitle"/>
															<string key="NSKeyEquiv"/>
															<int key="NSMnemonicLoc">2147483647</int>
															<reference key="NSOnImage" ref="35465992"/>
															<reference key="NSMixedImage" ref="502551668"/>
														</object>
														<object class="NSMenuItem" id="981751889">
															<reference key="NSMenu" ref="956096989"/>
															<bool key="NSIsDisabled">YES</bool>
															<string key="NSTitle">Selection</string>
															<string key="NSKeyEquiv"/>
															<int key="NSMnemonicLoc">2147483647</int>
															<reference key="NSOnImage" ref="35465992"/>
															<reference key="NSMixedImage" ref="502551668"/>
														</object>
														<object class="NSMenuItem" id="380031999">
															<reference key="NSMenu" ref="956096989"/>
															<string type="base64-UTF8" key="NSTitle">CURlZmF1bHQ</string>
															<string key="NSKeyEquiv"/>
															<int key="NSMnemonicLoc">2147483647</int>
															<reference key="NSOnImage" ref="35465992"/>
															<reference key="NSMixedImage" ref="502551668"/>
														</object>
														<object class="NSMenuItem" id="825984362">
															<reference key="NSMenu" ref="956096989"/>
															<string type="base64-UTF8" key="NSTitle">CUxlZnQgdG8gUmlnaHQ</string>
															<string key="NSKeyEquiv"/>
															<int key="NSMnemonicLoc">2147483647</int>
															<reference key="NSOnImage" ref="35465992"/>
															<reference key="NSMixedImage" ref="502551668"/>
														</object>
														<object class="NSMenuItem" id="560145579">
															<reference key="NSMenu" ref="956096989"/>
															<string type="base64-UTF8" key="NSTitle">CVJpZ2h0IHRvIExlZnQ</string>
															<string key="NSKeyEquiv"/>
															<int key="NSMnemonicLoc">2147483647</int>
															<reference key="NSOnImage" ref="35465992"/>
															<reference key="NSMixedImage" ref="502551668"/>
														</object>
													</object>
												</object>
											</object>
											<object class="NSMenuItem" id="908105787">
												<reference key="NSMenu" ref="446991534"/>
												<bool key="NSIsDisabled">YES</bool>
												<bool key="NSIsSeparator">YES</bool>
												<string key="NSTitle"/>
												<string key="NSKeyEquiv"/>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="644046920">
												<reference key="NSMenu" ref="446991534"/>
												<string key="NSTitle">Show Ruler</string>
												<string key="NSKeyEquiv"/>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="231811626">
												<reference key="NSMenu" ref="446991534"/>
												<string key="NSTitle">Copy Ruler</string>
												<string key="NSKeyEquiv">c</string>
												<int key="NSKeyEquivModMask">1310720</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
											<object class="NSMenuItem" id="883618387">
												<reference key="NSMenu" ref="446991534"/>
												<string key="NSTitle">Paste Ruler</string>
												<string key="NSKeyEquiv">v</string>
												<int key="NSKeyEquivModMask">1310720</int>
												<int key="NSMnemonicLoc">2147483647</int>
												<reference key="NSOnImage" ref="35465992"/>
												<reference key="NSMixedImage" ref="502551668"/>
											</object>
										</object>
									</object>
								</object>
							</object>
						</object>
					</object>
					<object class="NSMenuItem" id="586577488">
						<reference key="NSMenu" ref="649796088"/>
						<string key="NSTitle">View</string>
						<string key="NSKeyEquiv"/>
						<int key="NSKeyEquivModMask">1048576</int>
						<int key="NSMnemonicLoc">2147483647</int>
						<reference key="NSOnImage" ref="35465992"/>
						<reference key="NSMixedImage" ref="502551668"/>
						<string key="NSAction">submenuAction:</string>
						<object class="NSMenu" key="NSSubmenu" id="466310130">
							<string key="NSTitle">View</string>
							<object class="NSMutableArray" key="NSMenuItems">
								<bool key="EncodedWithXMLCoder">YES</bool>
								<object class="NSMenuItem" id="102151532">
									<reference key="NSMenu" ref="466310130"/>
									<string key="NSTitle">Show Toolbar</string>
									<string key="NSKeyEquiv">t</string>
									<int key="NSKeyEquivModMask">1572864</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="237841660">
									<reference key="NSMenu" ref="466310130"/>
									<string key="NSTitle">Customize Toolbar…</string>
									<string key="NSKeyEquiv"/>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
							</object>
						</object>
					</object>
					<object class="NSMenuItem" id="713487014">
						<reference key="NSMenu" ref="649796088"/>
						<string key="NSTitle">Window</string>
						<string key="NSKeyEquiv"/>
						<int key="NSKeyEquivModMask">1048576</int>
						<int key="NSMnemonicLoc">2147483647</int>
						<reference key="NSOnImage" ref="35465992"/>
						<reference key="NSMixedImage" ref="502551668"/>
						<string key="NSAction">submenuAction:</string>
						<object class="NSMenu" key="NSSubmenu" id="835318025">
							<string key="NSTitle">Window</string>
							<object class="NSMutableArray" key="NSMenuItems">
								<bool key="EncodedWithXMLCoder">YES</bool>
								<object class="NSMenuItem" id="1011231497">
									<reference key="NSMenu" ref="835318025"/>
									<string key="NSTitle">Minimize</string>
									<string key="NSKeyEquiv">m</string>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="575023229">
									<reference key="NSMenu" ref="835318025"/>
									<string key="NSTitle">Zoom</string>
									<string key="NSKeyEquiv"/>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="299356726">
									<reference key="NSMenu" ref="835318025"/>
									<bool key="NSIsDisabled">YES</bool>
									<bool key="NSIsSeparator">YES</bool>
									<string key="NSTitle"/>
									<string key="NSKeyEquiv"/>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
								<object class="NSMenuItem" id="625202149">
									<reference key="NSMenu" ref="835318025"/>
									<string key="NSTitle">Bring All to Front</string>
									<string key="NSKeyEquiv"/>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
							</object>
							<string key="NSName">_NSWindowsMenu</string>
						</object>
					</object>
					<object class="NSMenuItem" id="448692316">
						<reference key="NSMenu" ref="649796088"/>
						<string key="NSTitle">Help</string>
						<string key="NSKeyEquiv"/>
						<int key="NSMnemonicLoc">2147483647</int>
						<reference key="NSOnImage" ref="35465992"/>
						<reference key="NSMixedImage" ref="502551668"/>
						<string key="NSAction">submenuAction:</string>
						<object class="NSMenu" key="NSSubmenu" id="992780483">
							<string key="NSTitle">Help</string>
							<object class="NSMutableArray" key="NSMenuItems">
								<bool key="EncodedWithXMLCoder">YES</bool>
								<object class="NSMenuItem" id="105068016">
									<reference key="NSMenu" ref="992780483"/>
									<string key="NSTitle">Randomify Help</string>
									<string key="NSKeyEquiv">?</string>
									<int key="NSKeyEquivModMask">1048576</int>
									<int key="NSMnemonicLoc">2147483647</int>
									<reference key="NSOnImage" ref="35465992"/>
									<reference key="NSMixedImage" ref="502551668"/>
								</object>
							</object>
							<string key="NSName">_NSHelpMenu</string>
						</object>
					</object>
				</object>
				<string key="NSName">_NSMainMenu</string>
			</object>
			<object class="NSWindowTemplate" id="972006081">
				<int key="NSWindowStyleMask">15</int>
				<int key="NSWindowBacking">2</int>
				<string key="NSWindowRect">{{335, 428}, {497, 322}}</string>
				<int key="NSWTFlags">1954021376</int>
				<string key="NSWindowTitle">Randomify</string>
				<string key="NSWindowClass">NSWindow</string>
				<nil key="NSViewClass"/>
				<string key="NSWindowContentMaxSize">{1.79769e+308, 1.79769e+308}</string>
				<object class="NSView" key="NSWindowView" id="439893737">
					<reference key="NSNextResponder"/>
					<int key="NSvFlags">256</int>
					<object class="NSMutableArray" key="NSSubviews">
						<bool key="EncodedWithXMLCoder">YES</bool>
						<object class="NSTextField" id="765794976">
							<reference key="NSNextResponder" ref="439893737"/>
							<int key="NSvFlags">292</int>
							<string key="NSFrame">{{20, 20}, {158, 22}}</string>
							<reference key="NSSuperview" ref="439893737"/>
							<bool key="NSEnabled">YES</bool>
							<object class="NSTextFieldCell" key="NSCell" id="579012641">
								<int key="NSCellFlags">-1804468671</int>
								<int key="NSCellFlags2">272630784</int>
								<string key="NSContents"/>
								<object class="NSFont" key="NSSupport" id="667493830">
									<string key="NSName">LucidaGrande</string>
									<double key="NSSize">13</double>
									<int key="NSfFlags">1044</int>
								</object>
								<string key="NSPlaceholderString">Username</string>
								<reference key="NSControlView" ref="765794976"/>
								<bool key="NSDrawsBackground">YES</bool>
								<object class="NSColor" key="NSBackgroundColor" id="869802087">
									<int key="NSColorSpace">6</int>
									<string key="NSCatalogName">System</string>
									<string key="NSColorName">textBackgroundColor</string>
									<object class="NSColor" key="NSColor">
										<int key="NSColorSpace">3</int>
										<bytes key="NSWhite">MQA</bytes>
									</object>
								</object>
								<object class="NSColor" key="NSTextColor" id="327752861">
									<int key="NSColorSpace">6</int>
									<string key="NSCatalogName">System</string>
									<string key="NSColorName">textColor</string>
									<object class="NSColor" key="NSColor" id="1009300105">
										<int key="NSColorSpace">3</int>
										<bytes key="NSWhite">MAA</bytes>
									</object>
								</object>
							</object>
						</object>
						<object class="NSSecureTextField" id="394479719">
							<reference key="NSNextResponder" ref="439893737"/>
							<int key="NSvFlags">288</int>
							<string key="NSFrame">{{182, 20}, {158, 22}}</string>
							<reference key="NSSuperview" ref="439893737"/>
							<bool key="NSEnabled">YES</bool>
							<object class="NSSecureTextFieldCell" key="NSCell" id="16471822">
								<int key="NSCellFlags">343014976</int>
								<int key="NSCellFlags2">272630784</int>
								<string key="NSContents"/>
								<reference key="NSSupport" ref="667493830"/>
								<string key="NSPlaceholderString">Password</string>
								<reference key="NSControlView" ref="394479719"/>
								<bool key="NSDrawsBackground">YES</bool>
								<reference key="NSBackgroundColor" ref="869802087"/>
								<reference key="NSTextColor" ref="327752861"/>
								<object class="NSArray" key="NSAllowedInputLocales">
									<bool key="EncodedWithXMLCoder">YES</bool>
									<string>NSAllRomanInputSourcesLocaleIdentifier</string>
								</object>
							</object>
						</object>
						<object class="NSButton" id="327821739">
							<reference key="NSNextResponder" ref="439893737"/>
							<int key="NSvFlags">297</int>
							<string key="NSFrame">{{366, 13}, {117, 32}}</string>
							<reference key="NSSuperview" ref="439893737"/>
							<bool key="NSEnabled">YES</bool>
							<object class="NSButtonCell" key="NSCell" id="122895619">
								<int key="NSCellFlags">67239424</int>
								<int key="NSCellFlags2">134217728</int>
								<string key="NSContents">Login &amp; Play</string>
								<reference key="NSSupport" ref="667493830"/>
								<reference key="NSControlView" ref="327821739"/>
								<int key="NSButtonFlags">-2038284033</int>
								<int key="NSButtonFlags2">129</int>
								<string key="NSAlternateContents"/>
								<string type="base64-UTF8" key="NSKeyEquivalent">DQ</string>
								<int key="NSPeriodicDelay">200</int>
								<int key="NSPeriodicInterval">25</int>
							</object>
						</object>
						<object class="NSTextField" id="167731747">
							<reference key="NSNextResponder" ref="439893737"/>
							<int key="NSvFlags">274</int>
							<string key="NSFrame">{{20, 66}, {457, 216}}</string>
							<reference key="NSSuperview" ref="439893737"/>
							<bool key="NSEnabled">YES</bool>
							<object class="NSTextFieldCell" key="NSCell" id="855023043">
								<int key="NSCellFlags">-2073952767</int>
								<int key="NSCellFlags2">272629760</int>
								<string key="NSContents"/>
								<reference key="NSSupport" ref="667493830"/>
								<reference key="NSControlView" ref="167731747"/>
								<bool key="NSDrawsBackground">YES</bool>
								<reference key="NSBackgroundColor" ref="869802087"/>
								<reference key="NSTextColor" ref="327752861"/>
							</object>
						</object>
						<object class="NSButton" id="935404353">
							<reference key="NSNextResponder" ref="439893737"/>
							<int key="NSvFlags">265</int>
							<string key="NSFrame">{{372, 289}, {48, 26}}</string>
							<reference key="NSSuperview" ref="439893737"/>
							<bool key="NSEnabled">YES</bool>
							<object class="NSButtonCell" key="NSCell" id="785091278">
								<int key="NSCellFlags">-2080244224</int>
								<int key="NSCellFlags2">134217728</int>
								<string key="NSContents">║</string>
								<object class="NSFont" key="NSSupport">
									<string key="NSName">STHeitiSC-Light</string>
									<double key="NSSize">12</double>
									<int key="NSfFlags">16</int>
								</object>
								<reference key="NSControlView" ref="935404353"/>
								<int key="NSButtonFlags">-2033434369</int>
								<int key="NSButtonFlags2">162</int>
								<string key="NSAlternateContents"/>
								<string key="NSKeyEquivalent"/>
								<int key="NSPeriodicDelay">400</int>
								<int key="NSPeriodicInterval">75</int>
							</object>
						</object>
						<object class="NSButton" id="264769268">
							<reference key="NSNextResponder" ref="439893737"/>
							<int key="NSvFlags">265</int>
							<string key="NSFrame">{{429, 290}, {48, 25}}</string>
							<reference key="NSSuperview" ref="439893737"/>
							<bool key="NSEnabled">YES</bool>
							<object class="NSButtonCell" key="NSCell" id="516108178">
								<int key="NSCellFlags">-2080244224</int>
								<int key="NSCellFlags2">134217728</int>
								<string key="NSContents">⇒</string>
								<object class="NSFont" key="NSSupport">
									<string key="NSName">HiraKakuProN-W3</string>
									<double key="NSSize">32</double>
									<int key="NSfFlags">16</int>
								</object>
								<reference key="NSControlView" ref="264769268"/>
								<int key="NSButtonFlags">-2033434369</int>
								<int key="NSButtonFlags2">162</int>
								<string key="NSAlternateContents"/>
								<string key="NSKeyEquivalent"/>
								<int key="NSPeriodicDelay">400</int>
								<int key="NSPeriodicInterval">75</int>
							</object>
						</object>
						<object class="NSTextField" id="663855000">
							<reference key="NSNextResponder" ref="439893737"/>
							<int key="NSvFlags">292</int>
							<string key="NSFrame">{{17, 44}, {164, 14}}</string>
							<reference key="NSSuperview" ref="439893737"/>
							<bool key="NSEnabled">YES</bool>
							<object class="NSTextFieldCell" key="NSCell" id="400581401">
								<int key="NSCellFlags">68288064</int>
								<int key="NSCellFlags2">272761856</int>
								<string key="NSContents">Username</string>
								<object class="NSFont" key="NSSupport" id="26">
									<string key="NSName">LucidaGrande</string>
									<double key="NSSize">11</double>
									<int key="NSfFlags">3100</int>
								</object>
								<reference key="NSControlView" ref="663855000"/>
								<object class="NSColor" key="NSBackgroundColor" id="113529340">
									<int key="NSColorSpace">6</int>
									<string key="NSCatalogName">System</string>
									<string key="NSColorName">controlColor</string>
									<object class="NSColor" key="NSColor">
										<int key="NSColorSpace">3</int>
										<bytes key="NSWhite">MC42NjY2NjY2NjY3AA</bytes>
									</object>
								</object>
								<object class="NSColor" key="NSTextColor" id="769338032">
									<int key="NSColorSpace">6</int>
									<string key="NSCatalogName">System</string>
									<string key="NSColorName">controlTextColor</string>
									<reference key="NSColor" ref="1009300105"/>
								</object>
							</object>
						</object>
						<object class="NSTextField" id="783923701">
							<reference key="NSNextResponder" ref="439893737"/>
							<int key="NSvFlags">292</int>
							<string key="NSFrame">{{179, 44}, {164, 14}}</string>
							<reference key="NSSuperview" ref="439893737"/>
							<bool key="NSEnabled">YES</bool>
							<object class="NSTextFieldCell" key="NSCell" id="78164212">
								<int key="NSCellFlags">68288064</int>
								<int key="NSCellFlags2">272761856</int>
								<string key="NSContents">Password</string>
								<reference key="NSSupport" ref="26"/>
								<reference key="NSControlView" ref="783923701"/>
								<reference key="NSBackgroundColor" ref="113529340"/>
								<reference key="NSTextColor" ref="769338032"/>
							</object>
						</object>
						<object class="NSTextField" id="161503078">
							<reference key="NSNextResponder" ref="439893737"/>
							<int key="NSvFlags">266</int>
							<string key="NSFrame">{{17, 291}, {340, 18}}</string>
							<reference key="NSSuperview" ref="439893737"/>
							<bool key="NSEnabled">YES</bool>
							<object class="NSTextFieldCell" key="NSCell" id="1040653779">
								<int key="NSCellFlags">67239488</int>
								<int key="NSCellFlags2">272631808</int>
								<string key="NSContents">Playing x by y</string>
								<object class="NSFont" key="NSSupport">
									<string key="NSName">LucidaGrande-Bold</string>
									<double key="NSSize">14</double>
									<int key="NSfFlags">16</int>
								</object>
								<reference key="NSControlView" ref="161503078"/>
								<reference key="NSBackgroundColor" ref="113529340"/>
								<reference key="NSTextColor" ref="769338032"/>
							</object>
						</object>
					</object>
					<string key="NSFrameSize">{497, 322}</string>
					<reference key="NSSuperview"/>
				</object>
				<string key="NSScreenRect">{{0, 0}, {1920, 1178}}</string>
				<string key="NSMaxSize">{1.79769e+308, 1.79769e+308}</string>
			</object>
			<object class="NSCustomObject" id="976324537">
				<string key="NSClassName">RandomifyAppDelegate</string>
			</object>
			<object class="NSCustomObject" id="755631768">
				<string key="NSClassName">NSFontManager</string>
			</object>
			<object class="NSUserDefaultsController" id="1007787480">
				<object class="NSMutableArray" key="NSDeclaredKeys">
					<bool key="EncodedWithXMLCoder">YES</bool>
					<string>username</string>
					<string>password</string>
				</object>
				<bool key="NSSharedInstance">YES</bool>
			</object>
		</object>
		<object class="IBObjectContainer" key="IBDocument.Objects">
			<object class="NSMutableArray" key="connectionRecords">
				<bool key="EncodedWithXMLCoder">YES</bool>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">performMiniaturize:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="1011231497"/>
					</object>
					<int key="connectionID">37</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">arrangeInFront:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="625202149"/>
					</object>
					<int key="connectionID">39</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">print:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="49223823"/>
					</object>
					<int key="connectionID">86</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">runPageLayout:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="294629803"/>
					</object>
					<int key="connectionID">87</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">clearRecentDocuments:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="759406840"/>
					</object>
					<int key="connectionID">127</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">orderFrontStandardAboutPanel:</string>
						<reference key="source" ref="1021"/>
						<reference key="destination" ref="238522557"/>
					</object>
					<int key="connectionID">142</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">performClose:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="776162233"/>
					</object>
					<int key="connectionID">193</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">toggleContinuousSpellChecking:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="948374510"/>
					</object>
					<int key="connectionID">222</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">undo:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="1058277027"/>
					</object>
					<int key="connectionID">223</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">copy:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="860595796"/>
					</object>
					<int key="connectionID">224</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">checkSpelling:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="96193923"/>
					</object>
					<int key="connectionID">225</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">paste:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="29853731"/>
					</object>
					<int key="connectionID">226</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">stopSpeaking:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="680220178"/>
					</object>
					<int key="connectionID">227</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">cut:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="296257095"/>
					</object>
					<int key="connectionID">228</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">showGuessPanel:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="679648819"/>
					</object>
					<int key="connectionID">230</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">redo:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="790794224"/>
					</object>
					<int key="connectionID">231</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">selectAll:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="583158037"/>
					</object>
					<int key="connectionID">232</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">startSpeaking:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="731782645"/>
					</object>
					<int key="connectionID">233</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">delete:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="437104165"/>
					</object>
					<int key="connectionID">235</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">performZoom:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="575023229"/>
					</object>
					<int key="connectionID">240</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">performFindPanelAction:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="447796847"/>
					</object>
					<int key="connectionID">241</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">centerSelectionInVisibleArea:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="88285865"/>
					</object>
					<int key="connectionID">245</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">toggleGrammarChecking:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="967646866"/>
					</object>
					<int key="connectionID">347</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">toggleSmartInsertDelete:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="605118523"/>
					</object>
					<int key="connectionID">355</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">toggleAutomaticQuoteSubstitution:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="197661976"/>
					</object>
					<int key="connectionID">356</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">toggleAutomaticLinkDetection:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="708854459"/>
					</object>
					<int key="connectionID">357</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">saveDocument:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="1023925487"/>
					</object>
					<int key="connectionID">362</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">saveDocumentAs:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="117038363"/>
					</object>
					<int key="connectionID">363</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">revertDocumentToSaved:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="579971712"/>
					</object>
					<int key="connectionID">364</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">runToolbarCustomizationPalette:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="237841660"/>
					</object>
					<int key="connectionID">365</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">toggleToolbarShown:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="102151532"/>
					</object>
					<int key="connectionID">366</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">hide:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="755159360"/>
					</object>
					<int key="connectionID">367</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">hideOtherApplications:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="342932134"/>
					</object>
					<int key="connectionID">368</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">unhideAllApplications:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="908899353"/>
					</object>
					<int key="connectionID">370</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">newDocument:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="705341025"/>
					</object>
					<int key="connectionID">373</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">openDocument:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="722745758"/>
					</object>
					<int key="connectionID">374</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">addFontTrait:</string>
						<reference key="source" ref="755631768"/>
						<reference key="destination" ref="305399458"/>
					</object>
					<int key="connectionID">421</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">addFontTrait:</string>
						<reference key="source" ref="755631768"/>
						<reference key="destination" ref="814362025"/>
					</object>
					<int key="connectionID">422</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">modifyFont:</string>
						<reference key="source" ref="755631768"/>
						<reference key="destination" ref="885547335"/>
					</object>
					<int key="connectionID">423</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">orderFrontFontPanel:</string>
						<reference key="source" ref="755631768"/>
						<reference key="destination" ref="159677712"/>
					</object>
					<int key="connectionID">424</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">modifyFont:</string>
						<reference key="source" ref="755631768"/>
						<reference key="destination" ref="158063935"/>
					</object>
					<int key="connectionID">425</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">raiseBaseline:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="941806246"/>
					</object>
					<int key="connectionID">426</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">lowerBaseline:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="1045724900"/>
					</object>
					<int key="connectionID">427</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">copyFont:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="596732606"/>
					</object>
					<int key="connectionID">428</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">subscript:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="1037576581"/>
					</object>
					<int key="connectionID">429</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">superscript:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="644725453"/>
					</object>
					<int key="connectionID">430</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">tightenKerning:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="677519740"/>
					</object>
					<int key="connectionID">431</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">underline:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="330926929"/>
					</object>
					<int key="connectionID">432</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">orderFrontColorPanel:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="1012600125"/>
					</object>
					<int key="connectionID">433</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">useAllLigatures:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="663508465"/>
					</object>
					<int key="connectionID">434</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">loosenKerning:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="238351151"/>
					</object>
					<int key="connectionID">435</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">pasteFont:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="393423671"/>
					</object>
					<int key="connectionID">436</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">unscript:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="257962622"/>
					</object>
					<int key="connectionID">437</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">useStandardKerning:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="252969304"/>
					</object>
					<int key="connectionID">438</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">useStandardLigatures:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="706297211"/>
					</object>
					<int key="connectionID">439</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">turnOffLigatures:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="568384683"/>
					</object>
					<int key="connectionID">440</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">turnOffKerning:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="766922938"/>
					</object>
					<int key="connectionID">441</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">terminate:</string>
						<reference key="source" ref="1050"/>
						<reference key="destination" ref="632727374"/>
					</object>
					<int key="connectionID">449</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">toggleAutomaticSpellingCorrection:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="795346622"/>
					</object>
					<int key="connectionID">456</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">orderFrontSubstitutionsPanel:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="65139061"/>
					</object>
					<int key="connectionID">458</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">toggleAutomaticDashSubstitution:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="672708820"/>
					</object>
					<int key="connectionID">461</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">toggleAutomaticTextReplacement:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="537092702"/>
					</object>
					<int key="connectionID">463</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">uppercaseWord:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="1060694897"/>
					</object>
					<int key="connectionID">464</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">capitalizeWord:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="56570060"/>
					</object>
					<int key="connectionID">467</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">lowercaseWord:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="879586729"/>
					</object>
					<int key="connectionID">468</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">pasteAsPlainText:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="82994268"/>
					</object>
					<int key="connectionID">486</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">performFindPanelAction:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="326711663"/>
					</object>
					<int key="connectionID">487</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">performFindPanelAction:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="270902937"/>
					</object>
					<int key="connectionID">488</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">performFindPanelAction:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="159080638"/>
					</object>
					<int key="connectionID">489</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">showHelp:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="105068016"/>
					</object>
					<int key="connectionID">493</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBOutletConnection" key="connection">
						<string key="label">delegate</string>
						<reference key="source" ref="1021"/>
						<reference key="destination" ref="976324537"/>
					</object>
					<int key="connectionID">495</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">alignCenter:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="630155264"/>
					</object>
					<int key="connectionID">518</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">pasteRuler:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="883618387"/>
					</object>
					<int key="connectionID">519</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">toggleRuler:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="644046920"/>
					</object>
					<int key="connectionID">520</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">alignRight:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="512868991"/>
					</object>
					<int key="connectionID">521</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">copyRuler:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="231811626"/>
					</object>
					<int key="connectionID">522</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">alignJustified:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="945678886"/>
					</object>
					<int key="connectionID">523</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">alignLeft:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="875092757"/>
					</object>
					<int key="connectionID">524</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">makeBaseWritingDirectionNatural:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="551969625"/>
					</object>
					<int key="connectionID">525</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">makeBaseWritingDirectionLeftToRight:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="249532473"/>
					</object>
					<int key="connectionID">526</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">makeBaseWritingDirectionRightToLeft:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="607364498"/>
					</object>
					<int key="connectionID">527</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">makeTextWritingDirectionNatural:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="380031999"/>
					</object>
					<int key="connectionID">528</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">makeTextWritingDirectionLeftToRight:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="825984362"/>
					</object>
					<int key="connectionID">529</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">makeTextWritingDirectionRightToLeft:</string>
						<reference key="source" ref="1014"/>
						<reference key="destination" ref="560145579"/>
					</object>
					<int key="connectionID">530</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBOutletConnection" key="connection">
						<string key="label">window</string>
						<reference key="source" ref="976324537"/>
						<reference key="destination" ref="972006081"/>
					</object>
					<int key="connectionID">532</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBOutletConnection" key="connection">
						<string key="label">password</string>
						<reference key="source" ref="976324537"/>
						<reference key="destination" ref="394479719"/>
					</object>
					<int key="connectionID">539</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBOutletConnection" key="connection">
						<string key="label">username</string>
						<reference key="source" ref="976324537"/>
						<reference key="destination" ref="765794976"/>
					</object>
					<int key="connectionID">540</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">loginAndPlay:</string>
						<reference key="source" ref="976324537"/>
						<reference key="destination" ref="327821739"/>
					</object>
					<int key="connectionID">541</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBOutletConnection" key="connection">
						<string key="label">log</string>
						<reference key="source" ref="976324537"/>
						<reference key="destination" ref="167731747"/>
					</object>
					<int key="connectionID">544</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBBindingConnection" key="connection">
						<string key="label">value: values.username</string>
						<reference key="source" ref="765794976"/>
						<reference key="destination" ref="1007787480"/>
						<object class="NSNibBindingConnector" key="connector">
							<reference key="NSSource" ref="765794976"/>
							<reference key="NSDestination" ref="1007787480"/>
							<string key="NSLabel">value: values.username</string>
							<string key="NSBinding">value</string>
							<string key="NSKeyPath">values.username</string>
							<int key="NSNibBindingConnectorVersion">2</int>
						</object>
					</object>
					<int key="connectionID">547</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBBindingConnection" key="connection">
						<string key="label">value: values.password</string>
						<reference key="source" ref="394479719"/>
						<reference key="destination" ref="1007787480"/>
						<object class="NSNibBindingConnector" key="connector">
							<reference key="NSSource" ref="394479719"/>
							<reference key="NSDestination" ref="1007787480"/>
							<string key="NSLabel">value: values.password</string>
							<string key="NSBinding">value</string>
							<string key="NSKeyPath">values.password</string>
							<int key="NSNibBindingConnectorVersion">2</int>
						</object>
					</object>
					<int key="connectionID">549</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">togglePlay:</string>
						<reference key="source" ref="976324537"/>
						<reference key="destination" ref="935404353"/>
					</object>
					<int key="connectionID">554</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBActionConnection" key="connection">
						<string key="label">playARandomSong:</string>
						<reference key="source" ref="976324537"/>
						<reference key="destination" ref="264769268"/>
					</object>
					<int key="connectionID">555</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBOutletConnection" key="connection">
						<string key="label">playButton</string>
						<reference key="source" ref="976324537"/>
						<reference key="destination" ref="935404353"/>
					</object>
					<int key="connectionID">556</int>
				</object>
				<object class="IBConnectionRecord">
					<object class="IBOutletConnection" key="connection">
						<string key="label">status</string>
						<reference key="source" ref="976324537"/>
						<reference key="destination" ref="161503078"/>
					</object>
					<int key="connectionID">563</int>
				</object>
			</object>
			<object class="IBMutableOrderedSet" key="objectRecords">
				<object class="NSArray" key="orderedObjects">
					<bool key="EncodedWithXMLCoder">YES</bool>
					<object class="IBObjectRecord">
						<int key="objectID">0</int>
						<reference key="object" ref="0"/>
						<reference key="children" ref="1048"/>
						<nil key="parent"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">-2</int>
						<reference key="object" ref="1021"/>
						<reference key="parent" ref="0"/>
						<string key="objectName">File's Owner</string>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">-1</int>
						<reference key="object" ref="1014"/>
						<reference key="parent" ref="0"/>
						<string key="objectName">First Responder</string>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">-3</int>
						<reference key="object" ref="1050"/>
						<reference key="parent" ref="0"/>
						<string key="objectName">Application</string>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">29</int>
						<reference key="object" ref="649796088"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="713487014"/>
							<reference ref="694149608"/>
							<reference ref="952259628"/>
							<reference ref="379814623"/>
							<reference ref="586577488"/>
							<reference ref="302598603"/>
							<reference ref="448692316"/>
						</object>
						<reference key="parent" ref="0"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">19</int>
						<reference key="object" ref="713487014"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="835318025"/>
						</object>
						<reference key="parent" ref="649796088"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">56</int>
						<reference key="object" ref="694149608"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="110575045"/>
						</object>
						<reference key="parent" ref="649796088"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">217</int>
						<reference key="object" ref="952259628"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="789758025"/>
						</object>
						<reference key="parent" ref="649796088"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">83</int>
						<reference key="object" ref="379814623"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="720053764"/>
						</object>
						<reference key="parent" ref="649796088"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">81</int>
						<reference key="object" ref="720053764"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="1023925487"/>
							<reference ref="117038363"/>
							<reference ref="49223823"/>
							<reference ref="722745758"/>
							<reference ref="705341025"/>
							<reference ref="1025936716"/>
							<reference ref="294629803"/>
							<reference ref="776162233"/>
							<reference ref="425164168"/>
							<reference ref="579971712"/>
							<reference ref="1010469920"/>
						</object>
						<reference key="parent" ref="379814623"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">75</int>
						<reference key="object" ref="1023925487"/>
						<reference key="parent" ref="720053764"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">80</int>
						<reference key="object" ref="117038363"/>
						<reference key="parent" ref="720053764"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">78</int>
						<reference key="object" ref="49223823"/>
						<reference key="parent" ref="720053764"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">72</int>
						<reference key="object" ref="722745758"/>
						<reference key="parent" ref="720053764"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">82</int>
						<reference key="object" ref="705341025"/>
						<reference key="parent" ref="720053764"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">124</int>
						<reference key="object" ref="1025936716"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="1065607017"/>
						</object>
						<reference key="parent" ref="720053764"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">77</int>
						<reference key="object" ref="294629803"/>
						<reference key="parent" ref="720053764"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">73</int>
						<reference key="object" ref="776162233"/>
						<reference key="parent" ref="720053764"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">79</int>
						<reference key="object" ref="425164168"/>
						<reference key="parent" ref="720053764"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">112</int>
						<reference key="object" ref="579971712"/>
						<reference key="parent" ref="720053764"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">74</int>
						<reference key="object" ref="1010469920"/>
						<reference key="parent" ref="720053764"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">125</int>
						<reference key="object" ref="1065607017"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="759406840"/>
						</object>
						<reference key="parent" ref="1025936716"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">126</int>
						<reference key="object" ref="759406840"/>
						<reference key="parent" ref="1065607017"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">205</int>
						<reference key="object" ref="789758025"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="437104165"/>
							<reference ref="583158037"/>
							<reference ref="1058277027"/>
							<reference ref="212016141"/>
							<reference ref="296257095"/>
							<reference ref="29853731"/>
							<reference ref="860595796"/>
							<reference ref="1040322652"/>
							<reference ref="790794224"/>
							<reference ref="892235320"/>
							<reference ref="972420730"/>
							<reference ref="676164635"/>
							<reference ref="507821607"/>
							<reference ref="288088188"/>
							<reference ref="82994268"/>
						</object>
						<reference key="parent" ref="952259628"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">202</int>
						<reference key="object" ref="437104165"/>
						<reference key="parent" ref="789758025"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">198</int>
						<reference key="object" ref="583158037"/>
						<reference key="parent" ref="789758025"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">207</int>
						<reference key="object" ref="1058277027"/>
						<reference key="parent" ref="789758025"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">214</int>
						<reference key="object" ref="212016141"/>
						<reference key="parent" ref="789758025"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">199</int>
						<reference key="object" ref="296257095"/>
						<reference key="parent" ref="789758025"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">203</int>
						<reference key="object" ref="29853731"/>
						<reference key="parent" ref="789758025"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">197</int>
						<reference key="object" ref="860595796"/>
						<reference key="parent" ref="789758025"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">206</int>
						<reference key="object" ref="1040322652"/>
						<reference key="parent" ref="789758025"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">215</int>
						<reference key="object" ref="790794224"/>
						<reference key="parent" ref="789758025"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">218</int>
						<reference key="object" ref="892235320"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="963351320"/>
						</object>
						<reference key="parent" ref="789758025"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">216</int>
						<reference key="object" ref="972420730"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="769623530"/>
						</object>
						<reference key="parent" ref="789758025"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">200</int>
						<reference key="object" ref="769623530"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="948374510"/>
							<reference ref="96193923"/>
							<reference ref="679648819"/>
							<reference ref="967646866"/>
							<reference ref="859480356"/>
							<reference ref="795346622"/>
						</object>
						<reference key="parent" ref="972420730"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">219</int>
						<reference key="object" ref="948374510"/>
						<reference key="parent" ref="769623530"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">201</int>
						<reference key="object" ref="96193923"/>
						<reference key="parent" ref="769623530"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">204</int>
						<reference key="object" ref="679648819"/>
						<reference key="parent" ref="769623530"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">220</int>
						<reference key="object" ref="963351320"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="270902937"/>
							<reference ref="88285865"/>
							<reference ref="159080638"/>
							<reference ref="326711663"/>
							<reference ref="447796847"/>
						</object>
						<reference key="parent" ref="892235320"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">213</int>
						<reference key="object" ref="270902937"/>
						<reference key="parent" ref="963351320"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">210</int>
						<reference key="object" ref="88285865"/>
						<reference key="parent" ref="963351320"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">221</int>
						<reference key="object" ref="159080638"/>
						<reference key="parent" ref="963351320"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">208</int>
						<reference key="object" ref="326711663"/>
						<reference key="parent" ref="963351320"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">209</int>
						<reference key="object" ref="447796847"/>
						<reference key="parent" ref="963351320"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">57</int>
						<reference key="object" ref="110575045"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="238522557"/>
							<reference ref="755159360"/>
							<reference ref="908899353"/>
							<reference ref="632727374"/>
							<reference ref="646227648"/>
							<reference ref="609285721"/>
							<reference ref="481834944"/>
							<reference ref="304266470"/>
							<reference ref="1046388886"/>
							<reference ref="1056857174"/>
							<reference ref="342932134"/>
						</object>
						<reference key="parent" ref="694149608"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">58</int>
						<reference key="object" ref="238522557"/>
						<reference key="parent" ref="110575045"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">134</int>
						<reference key="object" ref="755159360"/>
						<reference key="parent" ref="110575045"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">150</int>
						<reference key="object" ref="908899353"/>
						<reference key="parent" ref="110575045"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">136</int>
						<reference key="object" ref="632727374"/>
						<reference key="parent" ref="110575045"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">144</int>
						<reference key="object" ref="646227648"/>
						<reference key="parent" ref="110575045"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">129</int>
						<reference key="object" ref="609285721"/>
						<reference key="parent" ref="110575045"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">143</int>
						<reference key="object" ref="481834944"/>
						<reference key="parent" ref="110575045"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">236</int>
						<reference key="object" ref="304266470"/>
						<reference key="parent" ref="110575045"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">131</int>
						<reference key="object" ref="1046388886"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="752062318"/>
						</object>
						<reference key="parent" ref="110575045"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">149</int>
						<reference key="object" ref="1056857174"/>
						<reference key="parent" ref="110575045"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">145</int>
						<reference key="object" ref="342932134"/>
						<reference key="parent" ref="110575045"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">130</int>
						<reference key="object" ref="752062318"/>
						<reference key="parent" ref="1046388886"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">24</int>
						<reference key="object" ref="835318025"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="299356726"/>
							<reference ref="625202149"/>
							<reference ref="575023229"/>
							<reference ref="1011231497"/>
						</object>
						<reference key="parent" ref="713487014"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">92</int>
						<reference key="object" ref="299356726"/>
						<reference key="parent" ref="835318025"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">5</int>
						<reference key="object" ref="625202149"/>
						<reference key="parent" ref="835318025"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">239</int>
						<reference key="object" ref="575023229"/>
						<reference key="parent" ref="835318025"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">23</int>
						<reference key="object" ref="1011231497"/>
						<reference key="parent" ref="835318025"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">295</int>
						<reference key="object" ref="586577488"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="466310130"/>
						</object>
						<reference key="parent" ref="649796088"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">296</int>
						<reference key="object" ref="466310130"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="102151532"/>
							<reference ref="237841660"/>
						</object>
						<reference key="parent" ref="586577488"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">297</int>
						<reference key="object" ref="102151532"/>
						<reference key="parent" ref="466310130"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">298</int>
						<reference key="object" ref="237841660"/>
						<reference key="parent" ref="466310130"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">211</int>
						<reference key="object" ref="676164635"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="785027613"/>
						</object>
						<reference key="parent" ref="789758025"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">212</int>
						<reference key="object" ref="785027613"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="680220178"/>
							<reference ref="731782645"/>
						</object>
						<reference key="parent" ref="676164635"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">195</int>
						<reference key="object" ref="680220178"/>
						<reference key="parent" ref="785027613"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">196</int>
						<reference key="object" ref="731782645"/>
						<reference key="parent" ref="785027613"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">346</int>
						<reference key="object" ref="967646866"/>
						<reference key="parent" ref="769623530"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">348</int>
						<reference key="object" ref="507821607"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="698887838"/>
						</object>
						<reference key="parent" ref="789758025"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">349</int>
						<reference key="object" ref="698887838"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="605118523"/>
							<reference ref="197661976"/>
							<reference ref="708854459"/>
							<reference ref="65139061"/>
							<reference ref="19036812"/>
							<reference ref="672708820"/>
							<reference ref="537092702"/>
						</object>
						<reference key="parent" ref="507821607"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">350</int>
						<reference key="object" ref="605118523"/>
						<reference key="parent" ref="698887838"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">351</int>
						<reference key="object" ref="197661976"/>
						<reference key="parent" ref="698887838"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">354</int>
						<reference key="object" ref="708854459"/>
						<reference key="parent" ref="698887838"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">371</int>
						<reference key="object" ref="972006081"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="439893737"/>
						</object>
						<reference key="parent" ref="0"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">372</int>
						<reference key="object" ref="439893737"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="765794976"/>
							<reference ref="394479719"/>
							<reference ref="327821739"/>
							<reference ref="663855000"/>
							<reference ref="783923701"/>
							<reference ref="167731747"/>
							<reference ref="161503078"/>
							<reference ref="935404353"/>
							<reference ref="264769268"/>
						</object>
						<reference key="parent" ref="972006081"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">375</int>
						<reference key="object" ref="302598603"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="941447902"/>
						</object>
						<reference key="parent" ref="649796088"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">376</int>
						<reference key="object" ref="941447902"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="792887677"/>
							<reference ref="215659978"/>
						</object>
						<reference key="parent" ref="302598603"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">377</int>
						<reference key="object" ref="792887677"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="786677654"/>
						</object>
						<reference key="parent" ref="941447902"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">388</int>
						<reference key="object" ref="786677654"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="159677712"/>
							<reference ref="305399458"/>
							<reference ref="814362025"/>
							<reference ref="330926929"/>
							<reference ref="533507878"/>
							<reference ref="158063935"/>
							<reference ref="885547335"/>
							<reference ref="901062459"/>
							<reference ref="767671776"/>
							<reference ref="691570813"/>
							<reference ref="769124883"/>
							<reference ref="739652853"/>
							<reference ref="1012600125"/>
							<reference ref="214559597"/>
							<reference ref="596732606"/>
							<reference ref="393423671"/>
						</object>
						<reference key="parent" ref="792887677"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">389</int>
						<reference key="object" ref="159677712"/>
						<reference key="parent" ref="786677654"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">390</int>
						<reference key="object" ref="305399458"/>
						<reference key="parent" ref="786677654"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">391</int>
						<reference key="object" ref="814362025"/>
						<reference key="parent" ref="786677654"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">392</int>
						<reference key="object" ref="330926929"/>
						<reference key="parent" ref="786677654"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">393</int>
						<reference key="object" ref="533507878"/>
						<reference key="parent" ref="786677654"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">394</int>
						<reference key="object" ref="158063935"/>
						<reference key="parent" ref="786677654"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">395</int>
						<reference key="object" ref="885547335"/>
						<reference key="parent" ref="786677654"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">396</int>
						<reference key="object" ref="901062459"/>
						<reference key="parent" ref="786677654"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">397</int>
						<reference key="object" ref="767671776"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="175441468"/>
						</object>
						<reference key="parent" ref="786677654"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">398</int>
						<reference key="object" ref="691570813"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="1058217995"/>
						</object>
						<reference key="parent" ref="786677654"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">399</int>
						<reference key="object" ref="769124883"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="18263474"/>
						</object>
						<reference key="parent" ref="786677654"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">400</int>
						<reference key="object" ref="739652853"/>
						<reference key="parent" ref="786677654"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">401</int>
						<reference key="object" ref="1012600125"/>
						<reference key="parent" ref="786677654"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">402</int>
						<reference key="object" ref="214559597"/>
						<reference key="parent" ref="786677654"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">403</int>
						<reference key="object" ref="596732606"/>
						<reference key="parent" ref="786677654"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">404</int>
						<reference key="object" ref="393423671"/>
						<reference key="parent" ref="786677654"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">405</int>
						<reference key="object" ref="18263474"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="257962622"/>
							<reference ref="644725453"/>
							<reference ref="1037576581"/>
							<reference ref="941806246"/>
							<reference ref="1045724900"/>
						</object>
						<reference key="parent" ref="769124883"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">406</int>
						<reference key="object" ref="257962622"/>
						<reference key="parent" ref="18263474"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">407</int>
						<reference key="object" ref="644725453"/>
						<reference key="parent" ref="18263474"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">408</int>
						<reference key="object" ref="1037576581"/>
						<reference key="parent" ref="18263474"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">409</int>
						<reference key="object" ref="941806246"/>
						<reference key="parent" ref="18263474"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">410</int>
						<reference key="object" ref="1045724900"/>
						<reference key="parent" ref="18263474"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">411</int>
						<reference key="object" ref="1058217995"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="706297211"/>
							<reference ref="568384683"/>
							<reference ref="663508465"/>
						</object>
						<reference key="parent" ref="691570813"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">412</int>
						<reference key="object" ref="706297211"/>
						<reference key="parent" ref="1058217995"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">413</int>
						<reference key="object" ref="568384683"/>
						<reference key="parent" ref="1058217995"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">414</int>
						<reference key="object" ref="663508465"/>
						<reference key="parent" ref="1058217995"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">415</int>
						<reference key="object" ref="175441468"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="252969304"/>
							<reference ref="766922938"/>
							<reference ref="677519740"/>
							<reference ref="238351151"/>
						</object>
						<reference key="parent" ref="767671776"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">416</int>
						<reference key="object" ref="252969304"/>
						<reference key="parent" ref="175441468"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">417</int>
						<reference key="object" ref="766922938"/>
						<reference key="parent" ref="175441468"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">418</int>
						<reference key="object" ref="677519740"/>
						<reference key="parent" ref="175441468"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">419</int>
						<reference key="object" ref="238351151"/>
						<reference key="parent" ref="175441468"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">420</int>
						<reference key="object" ref="755631768"/>
						<reference key="parent" ref="0"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">450</int>
						<reference key="object" ref="288088188"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="579392910"/>
						</object>
						<reference key="parent" ref="789758025"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">451</int>
						<reference key="object" ref="579392910"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="1060694897"/>
							<reference ref="879586729"/>
							<reference ref="56570060"/>
						</object>
						<reference key="parent" ref="288088188"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">452</int>
						<reference key="object" ref="1060694897"/>
						<reference key="parent" ref="579392910"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">453</int>
						<reference key="object" ref="859480356"/>
						<reference key="parent" ref="769623530"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">454</int>
						<reference key="object" ref="795346622"/>
						<reference key="parent" ref="769623530"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">457</int>
						<reference key="object" ref="65139061"/>
						<reference key="parent" ref="698887838"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">459</int>
						<reference key="object" ref="19036812"/>
						<reference key="parent" ref="698887838"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">460</int>
						<reference key="object" ref="672708820"/>
						<reference key="parent" ref="698887838"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">462</int>
						<reference key="object" ref="537092702"/>
						<reference key="parent" ref="698887838"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">465</int>
						<reference key="object" ref="879586729"/>
						<reference key="parent" ref="579392910"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">466</int>
						<reference key="object" ref="56570060"/>
						<reference key="parent" ref="579392910"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">485</int>
						<reference key="object" ref="82994268"/>
						<reference key="parent" ref="789758025"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">490</int>
						<reference key="object" ref="448692316"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="992780483"/>
						</object>
						<reference key="parent" ref="649796088"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">491</int>
						<reference key="object" ref="992780483"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="105068016"/>
						</object>
						<reference key="parent" ref="448692316"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">492</int>
						<reference key="object" ref="105068016"/>
						<reference key="parent" ref="992780483"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">494</int>
						<reference key="object" ref="976324537"/>
						<reference key="parent" ref="0"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">496</int>
						<reference key="object" ref="215659978"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="446991534"/>
						</object>
						<reference key="parent" ref="941447902"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">497</int>
						<reference key="object" ref="446991534"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="875092757"/>
							<reference ref="630155264"/>
							<reference ref="945678886"/>
							<reference ref="512868991"/>
							<reference ref="163117631"/>
							<reference ref="31516759"/>
							<reference ref="908105787"/>
							<reference ref="644046920"/>
							<reference ref="231811626"/>
							<reference ref="883618387"/>
						</object>
						<reference key="parent" ref="215659978"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">498</int>
						<reference key="object" ref="875092757"/>
						<reference key="parent" ref="446991534"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">499</int>
						<reference key="object" ref="630155264"/>
						<reference key="parent" ref="446991534"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">500</int>
						<reference key="object" ref="945678886"/>
						<reference key="parent" ref="446991534"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">501</int>
						<reference key="object" ref="512868991"/>
						<reference key="parent" ref="446991534"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">502</int>
						<reference key="object" ref="163117631"/>
						<reference key="parent" ref="446991534"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">503</int>
						<reference key="object" ref="31516759"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="956096989"/>
						</object>
						<reference key="parent" ref="446991534"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">504</int>
						<reference key="object" ref="908105787"/>
						<reference key="parent" ref="446991534"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">505</int>
						<reference key="object" ref="644046920"/>
						<reference key="parent" ref="446991534"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">506</int>
						<reference key="object" ref="231811626"/>
						<reference key="parent" ref="446991534"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">507</int>
						<reference key="object" ref="883618387"/>
						<reference key="parent" ref="446991534"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">508</int>
						<reference key="object" ref="956096989"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="257099033"/>
							<reference ref="551969625"/>
							<reference ref="249532473"/>
							<reference ref="607364498"/>
							<reference ref="508151438"/>
							<reference ref="981751889"/>
							<reference ref="380031999"/>
							<reference ref="825984362"/>
							<reference ref="560145579"/>
						</object>
						<reference key="parent" ref="31516759"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">509</int>
						<reference key="object" ref="257099033"/>
						<reference key="parent" ref="956096989"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">510</int>
						<reference key="object" ref="551969625"/>
						<reference key="parent" ref="956096989"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">511</int>
						<reference key="object" ref="249532473"/>
						<reference key="parent" ref="956096989"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">512</int>
						<reference key="object" ref="607364498"/>
						<reference key="parent" ref="956096989"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">513</int>
						<reference key="object" ref="508151438"/>
						<reference key="parent" ref="956096989"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">514</int>
						<reference key="object" ref="981751889"/>
						<reference key="parent" ref="956096989"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">515</int>
						<reference key="object" ref="380031999"/>
						<reference key="parent" ref="956096989"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">516</int>
						<reference key="object" ref="825984362"/>
						<reference key="parent" ref="956096989"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">517</int>
						<reference key="object" ref="560145579"/>
						<reference key="parent" ref="956096989"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">533</int>
						<reference key="object" ref="765794976"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="579012641"/>
						</object>
						<reference key="parent" ref="439893737"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">534</int>
						<reference key="object" ref="579012641"/>
						<reference key="parent" ref="765794976"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">535</int>
						<reference key="object" ref="394479719"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="16471822"/>
						</object>
						<reference key="parent" ref="439893737"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">536</int>
						<reference key="object" ref="16471822"/>
						<reference key="parent" ref="394479719"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">537</int>
						<reference key="object" ref="327821739"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="122895619"/>
						</object>
						<reference key="parent" ref="439893737"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">538</int>
						<reference key="object" ref="122895619"/>
						<reference key="parent" ref="327821739"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">542</int>
						<reference key="object" ref="167731747"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="855023043"/>
						</object>
						<reference key="parent" ref="439893737"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">543</int>
						<reference key="object" ref="855023043"/>
						<reference key="parent" ref="167731747"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">545</int>
						<reference key="object" ref="1007787480"/>
						<reference key="parent" ref="0"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">550</int>
						<reference key="object" ref="935404353"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="785091278"/>
						</object>
						<reference key="parent" ref="439893737"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">551</int>
						<reference key="object" ref="785091278"/>
						<reference key="parent" ref="935404353"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">552</int>
						<reference key="object" ref="264769268"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="516108178"/>
						</object>
						<reference key="parent" ref="439893737"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">553</int>
						<reference key="object" ref="516108178"/>
						<reference key="parent" ref="264769268"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">557</int>
						<reference key="object" ref="663855000"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="400581401"/>
						</object>
						<reference key="parent" ref="439893737"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">558</int>
						<reference key="object" ref="400581401"/>
						<reference key="parent" ref="663855000"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">559</int>
						<reference key="object" ref="783923701"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="78164212"/>
						</object>
						<reference key="parent" ref="439893737"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">560</int>
						<reference key="object" ref="78164212"/>
						<reference key="parent" ref="783923701"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">561</int>
						<reference key="object" ref="161503078"/>
						<object class="NSMutableArray" key="children">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<reference ref="1040653779"/>
						</object>
						<reference key="parent" ref="439893737"/>
					</object>
					<object class="IBObjectRecord">
						<int key="objectID">562</int>
						<reference key="object" ref="1040653779"/>
						<reference key="parent" ref="161503078"/>
					</object>
				</object>
			</object>
			<object class="NSMutableDictionary" key="flattenedProperties">
				<bool key="EncodedWithXMLCoder">YES</bool>
				<object class="NSArray" key="dict.sortedKeys">
					<bool key="EncodedWithXMLCoder">YES</bool>
					<string>-3.IBPluginDependency</string>
					<string>112.IBPluginDependency</string>
					<string>112.ImportedFromIB2</string>
					<string>124.IBPluginDependency</string>
					<string>124.ImportedFromIB2</string>
					<string>125.IBPluginDependency</string>
					<string>125.ImportedFromIB2</string>
					<string>125.editorWindowContentRectSynchronizationRect</string>
					<string>126.IBPluginDependency</string>
					<string>126.ImportedFromIB2</string>
					<string>129.IBPluginDependency</string>
					<string>129.ImportedFromIB2</string>
					<string>130.IBPluginDependency</string>
					<string>130.ImportedFromIB2</string>
					<string>130.editorWindowContentRectSynchronizationRect</string>
					<string>131.IBPluginDependency</string>
					<string>131.ImportedFromIB2</string>
					<string>134.IBPluginDependency</string>
					<string>134.ImportedFromIB2</string>
					<string>136.IBPluginDependency</string>
					<string>136.ImportedFromIB2</string>
					<string>143.IBPluginDependency</string>
					<string>143.ImportedFromIB2</string>
					<string>144.IBPluginDependency</string>
					<string>144.ImportedFromIB2</string>
					<string>145.IBPluginDependency</string>
					<string>145.ImportedFromIB2</string>
					<string>149.IBPluginDependency</string>
					<string>149.ImportedFromIB2</string>
					<string>150.IBPluginDependency</string>
					<string>150.ImportedFromIB2</string>
					<string>19.IBPluginDependency</string>
					<string>19.ImportedFromIB2</string>
					<string>195.IBPluginDependency</string>
					<string>195.ImportedFromIB2</string>
					<string>196.IBPluginDependency</string>
					<string>196.ImportedFromIB2</string>
					<string>197.IBPluginDependency</string>
					<string>197.ImportedFromIB2</string>
					<string>198.IBPluginDependency</string>
					<string>198.ImportedFromIB2</string>
					<string>199.IBPluginDependency</string>
					<string>199.ImportedFromIB2</string>
					<string>200.IBEditorWindowLastContentRect</string>
					<string>200.IBPluginDependency</string>
					<string>200.ImportedFromIB2</string>
					<string>200.editorWindowContentRectSynchronizationRect</string>
					<string>201.IBPluginDependency</string>
					<string>201.ImportedFromIB2</string>
					<string>202.IBPluginDependency</string>
					<string>202.ImportedFromIB2</string>
					<string>203.IBPluginDependency</string>
					<string>203.ImportedFromIB2</string>
					<string>204.IBPluginDependency</string>
					<string>204.ImportedFromIB2</string>
					<string>205.IBEditorWindowLastContentRect</string>
					<string>205.IBPluginDependency</string>
					<string>205.ImportedFromIB2</string>
					<string>205.editorWindowContentRectSynchronizationRect</string>
					<string>206.IBPluginDependency</string>
					<string>206.ImportedFromIB2</string>
					<string>207.IBPluginDependency</string>
					<string>207.ImportedFromIB2</string>
					<string>208.IBPluginDependency</string>
					<string>208.ImportedFromIB2</string>
					<string>209.IBPluginDependency</string>
					<string>209.ImportedFromIB2</string>
					<string>210.IBPluginDependency</string>
					<string>210.ImportedFromIB2</string>
					<string>211.IBPluginDependency</string>
					<string>211.ImportedFromIB2</string>
					<string>212.IBPluginDependency</string>
					<string>212.ImportedFromIB2</string>
					<string>212.editorWindowContentRectSynchronizationRect</string>
					<string>213.IBPluginDependency</string>
					<string>213.ImportedFromIB2</string>
					<string>214.IBPluginDependency</string>
					<string>214.ImportedFromIB2</string>
					<string>215.IBPluginDependency</string>
					<string>215.ImportedFromIB2</string>
					<string>216.IBPluginDependency</string>
					<string>216.ImportedFromIB2</string>
					<string>217.IBPluginDependency</string>
					<string>217.ImportedFromIB2</string>
					<string>218.IBPluginDependency</string>
					<string>218.ImportedFromIB2</string>
					<string>219.IBPluginDependency</string>
					<string>219.ImportedFromIB2</string>
					<string>220.IBEditorWindowLastContentRect</string>
					<string>220.IBPluginDependency</string>
					<string>220.ImportedFromIB2</string>
					<string>220.editorWindowContentRectSynchronizationRect</string>
					<string>221.IBPluginDependency</string>
					<string>221.ImportedFromIB2</string>
					<string>23.IBPluginDependency</string>
					<string>23.ImportedFromIB2</string>
					<string>236.IBPluginDependency</string>
					<string>236.ImportedFromIB2</string>
					<string>239.IBPluginDependency</string>
					<string>239.ImportedFromIB2</string>
					<string>24.IBEditorWindowLastContentRect</string>
					<string>24.IBPluginDependency</string>
					<string>24.ImportedFromIB2</string>
					<string>24.editorWindowContentRectSynchronizationRect</string>
					<string>29.IBEditorWindowLastContentRect</string>
					<string>29.IBPluginDependency</string>
					<string>29.ImportedFromIB2</string>
					<string>29.WindowOrigin</string>
					<string>29.editorWindowContentRectSynchronizationRect</string>
					<string>295.IBPluginDependency</string>
					<string>296.IBEditorWindowLastContentRect</string>
					<string>296.IBPluginDependency</string>
					<string>296.editorWindowContentRectSynchronizationRect</string>
					<string>297.IBPluginDependency</string>
					<string>298.IBPluginDependency</string>
					<string>346.IBPluginDependency</string>
					<string>346.ImportedFromIB2</string>
					<string>348.IBPluginDependency</string>
					<string>348.ImportedFromIB2</string>
					<string>349.IBEditorWindowLastContentRect</string>
					<string>349.IBPluginDependency</string>
					<string>349.ImportedFromIB2</string>
					<string>349.editorWindowContentRectSynchronizationRect</string>
					<string>350.IBPluginDependency</string>
					<string>350.ImportedFromIB2</string>
					<string>351.IBPluginDependency</string>
					<string>351.ImportedFromIB2</string>
					<string>354.IBPluginDependency</string>
					<string>354.ImportedFromIB2</string>
					<string>371.IBEditorWindowLastContentRect</string>
					<string>371.IBPluginDependency</string>
					<string>371.IBWindowTemplateEditedContentRect</string>
					<string>371.NSWindowTemplate.visibleAtLaunch</string>
					<string>371.editorWindowContentRectSynchronizationRect</string>
					<string>371.windowTemplate.hasMaxSize</string>
					<string>371.windowTemplate.maxSize</string>
					<string>372.IBPluginDependency</string>
					<string>375.IBPluginDependency</string>
					<string>376.IBEditorWindowLastContentRect</string>
					<string>376.IBPluginDependency</string>
					<string>377.IBPluginDependency</string>
					<string>388.IBEditorWindowLastContentRect</string>
					<string>388.IBPluginDependency</string>
					<string>389.IBPluginDependency</string>
					<string>390.IBPluginDependency</string>
					<string>391.IBPluginDependency</string>
					<string>392.IBPluginDependency</string>
					<string>393.IBPluginDependency</string>
					<string>394.IBPluginDependency</string>
					<string>395.IBPluginDependency</string>
					<string>396.IBPluginDependency</string>
					<string>397.IBPluginDependency</string>
					<string>398.IBPluginDependency</string>
					<string>399.IBPluginDependency</string>
					<string>400.IBPluginDependency</string>
					<string>401.IBPluginDependency</string>
					<string>402.IBPluginDependency</string>
					<string>403.IBPluginDependency</string>
					<string>404.IBPluginDependency</string>
					<string>405.IBPluginDependency</string>
					<string>406.IBPluginDependency</string>
					<string>407.IBPluginDependency</string>
					<string>408.IBPluginDependency</string>
					<string>409.IBPluginDependency</string>
					<string>410.IBPluginDependency</string>
					<string>411.IBPluginDependency</string>
					<string>412.IBPluginDependency</string>
					<string>413.IBPluginDependency</string>
					<string>414.IBPluginDependency</string>
					<string>415.IBPluginDependency</string>
					<string>416.IBPluginDependency</string>
					<string>417.IBPluginDependency</string>
					<string>418.IBPluginDependency</string>
					<string>419.IBPluginDependency</string>
					<string>450.IBPluginDependency</string>
					<string>451.IBEditorWindowLastContentRect</string>
					<string>451.IBPluginDependency</string>
					<string>452.IBPluginDependency</string>
					<string>453.IBPluginDependency</string>
					<string>454.IBPluginDependency</string>
					<string>457.IBPluginDependency</string>
					<string>459.IBPluginDependency</string>
					<string>460.IBPluginDependency</string>
					<string>462.IBPluginDependency</string>
					<string>465.IBPluginDependency</string>
					<string>466.IBPluginDependency</string>
					<string>485.IBPluginDependency</string>
					<string>490.IBPluginDependency</string>
					<string>491.IBEditorWindowLastContentRect</string>
					<string>491.IBPluginDependency</string>
					<string>492.IBPluginDependency</string>
					<string>496.IBPluginDependency</string>
					<string>497.IBEditorWindowLastContentRect</string>
					<string>497.IBPluginDependency</string>
					<string>498.IBPluginDependency</string>
					<string>499.IBPluginDependency</string>
					<string>5.IBPluginDependency</string>
					<string>5.ImportedFromIB2</string>
					<string>500.IBPluginDependency</string>
					<string>501.IBPluginDependency</string>
					<string>502.IBPluginDependency</string>
					<string>503.IBPluginDependency</string>
					<string>504.IBPluginDependency</string>
					<string>505.IBPluginDependency</string>
					<string>506.IBPluginDependency</string>
					<string>507.IBPluginDependency</string>
					<string>508.IBEditorWindowLastContentRect</string>
					<string>508.IBPluginDependency</string>
					<string>509.IBPluginDependency</string>
					<string>510.IBPluginDependency</string>
					<string>511.IBPluginDependency</string>
					<string>512.IBPluginDependency</string>
					<string>513.IBPluginDependency</string>
					<string>514.IBPluginDependency</string>
					<string>515.IBPluginDependency</string>
					<string>516.IBPluginDependency</string>
					<string>517.IBPluginDependency</string>
					<string>533.IBPluginDependency</string>
					<string>534.IBPluginDependency</string>
					<string>535.IBPluginDependency</string>
					<string>536.IBPluginDependency</string>
					<string>537.IBPluginDependency</string>
					<string>538.IBPluginDependency</string>
					<string>542.IBPluginDependency</string>
					<string>543.IBPluginDependency</string>
					<string>550.IBPluginDependency</string>
					<string>551.IBPluginDependency</string>
					<string>552.IBPluginDependency</string>
					<string>553.IBPluginDependency</string>
					<string>557.IBPluginDependency</string>
					<string>558.IBPluginDependency</string>
					<string>559.IBPluginDependency</string>
					<string>56.IBPluginDependency</string>
					<string>56.ImportedFromIB2</string>
					<string>560.IBPluginDependency</string>
					<string>561.IBPluginDependency</string>
					<string>562.IBPluginDependency</string>
					<string>57.IBEditorWindowLastContentRect</string>
					<string>57.IBPluginDependency</string>
					<string>57.ImportedFromIB2</string>
					<string>57.editorWindowContentRectSynchronizationRect</string>
					<string>58.IBPluginDependency</string>
					<string>58.ImportedFromIB2</string>
					<string>72.IBPluginDependency</string>
					<string>72.ImportedFromIB2</string>
					<string>73.IBPluginDependency</string>
					<string>73.ImportedFromIB2</string>
					<string>74.IBPluginDependency</string>
					<string>74.ImportedFromIB2</string>
					<string>75.IBPluginDependency</string>
					<string>75.ImportedFromIB2</string>
					<string>77.IBPluginDependency</string>
					<string>77.ImportedFromIB2</string>
					<string>78.IBPluginDependency</string>
					<string>78.ImportedFromIB2</string>
					<string>79.IBPluginDependency</string>
					<string>79.ImportedFromIB2</string>
					<string>80.IBPluginDependency</string>
					<string>80.ImportedFromIB2</string>
					<string>81.IBEditorWindowLastContentRect</string>
					<string>81.IBPluginDependency</string>
					<string>81.ImportedFromIB2</string>
					<string>81.editorWindowContentRectSynchronizationRect</string>
					<string>82.IBPluginDependency</string>
					<string>82.ImportedFromIB2</string>
					<string>83.IBPluginDependency</string>
					<string>83.ImportedFromIB2</string>
					<string>92.IBPluginDependency</string>
					<string>92.ImportedFromIB2</string>
				</object>
				<object class="NSMutableArray" key="dict.values">
					<bool key="EncodedWithXMLCoder">YES</bool>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>{{522, 812}, {146, 23}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>{{436, 809}, {64, 6}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>{{753, 187}, {275, 113}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>{{608, 612}, {275, 83}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>{{547, 180}, {254, 283}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>{{187, 434}, {243, 243}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>{{608, 612}, {167, 43}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>{{753, 217}, {238, 103}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>{{608, 612}, {241, 103}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>{{654, 239}, {194, 73}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>{{525, 802}, {197, 73}}</string>
					<string>{{380, 836}, {442, 20}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>{74, 862}</string>
					<string>{{6, 978}, {478, 20}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>{{604, 269}, {231, 43}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>{{475, 832}, {234, 43}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>{{746, 287}, {220, 133}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>{{608, 612}, {215, 63}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>{{183, 462}, {497, 322}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>{{183, 462}, {497, 322}}</string>
					<integer value="1"/>
					<string>{{33, 99}, {480, 360}}</string>
					<boolean value="NO"/>
					<string>{9999, 122}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>{{591, 420}, {83, 43}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>{{523, 2}, {178, 283}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>{{753, 197}, {170, 63}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>{{725, 289}, {246, 23}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>{{674, 260}, {204, 183}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>{{878, 180}, {164, 173}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<string>{{286, 129}, {275, 183}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>{{23, 794}, {245, 183}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>{{452, 109}, {196, 203}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>{{145, 474}, {199, 203}}</string>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
					<string>com.apple.InterfaceBuilder.CocoaPlugin</string>
					<integer value="1"/>
				</object>
			</object>
			<object class="NSMutableDictionary" key="unlocalizedProperties">
				<bool key="EncodedWithXMLCoder">YES</bool>
				<reference key="dict.sortedKeys" ref="0"/>
				<object class="NSMutableArray" key="dict.values">
					<bool key="EncodedWithXMLCoder">YES</bool>
				</object>
			</object>
			<nil key="activeLocalization"/>
			<object class="NSMutableDictionary" key="localizations">
				<bool key="EncodedWithXMLCoder">YES</bool>
				<reference key="dict.sortedKeys" ref="0"/>
				<object class="NSMutableArray" key="dict.values">
					<bool key="EncodedWithXMLCoder">YES</bool>
				</object>
			</object>
			<nil key="sourceID"/>
			<int key="maxID">563</int>
		</object>
		<object class="IBClassDescriber" key="IBDocument.Classes">
			<object class="NSMutableArray" key="referencedPartialClassDescriptions">
				<bool key="EncodedWithXMLCoder">YES</bool>
				<object class="IBPartialClassDescription">
					<string key="className">RandomifyAppDelegate</string>
					<string key="superclassName">NSObject</string>
					<object class="NSMutableDictionary" key="actions">
						<bool key="EncodedWithXMLCoder">YES</bool>
						<object class="NSArray" key="dict.sortedKeys">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<string>loginAndPlay:</string>
							<string>playARandomSong:</string>
							<string>togglePlay:</string>
						</object>
						<object class="NSMutableArray" key="dict.values">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<string>id</string>
							<string>id</string>
							<string>id</string>
						</object>
					</object>
					<object class="NSMutableDictionary" key="outlets">
						<bool key="EncodedWithXMLCoder">YES</bool>
						<object class="NSArray" key="dict.sortedKeys">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<string>log</string>
							<string>password</string>
							<string>playButton</string>
							<string>status</string>
							<string>username</string>
							<string>window</string>
						</object>
						<object class="NSMutableArray" key="dict.values">
							<bool key="EncodedWithXMLCoder">YES</bool>
							<string>NSTextField</string>
							<string>NSTextField</string>
							<string>NSButton</string>
							<string>NSTextField</string>
							<string>NSTextField</string>
							<string>NSWindow</string>
						</object>
					</object>
					<object class="IBClassDescriptionSource" key="sourceIdentifier">
						<string key="majorKey">IBProjectSource</string>
						<string key="minorKey">RandomifyAppDelegate.h</string>
					</object>
				</object>
			</object>
		</object>
		<int key="IBDocument.localizationMode">0</int>
		<object class="NSMutableDictionary" key="IBDocument.PluginDeclaredDependencies">
			<string key="NS.key.0">com.apple.InterfaceBuilder.CocoaPlugin.macosx</string>
			<integer value="1050" key="NS.object.0"/>
		</object>
		<object class="NSMutableDictionary" key="IBDocument.PluginDeclaredDependencyDefaults">
			<string key="NS.key.0">com.apple.InterfaceBuilder.CocoaPlugin.macosx</string>
			<integer value="1060" key="NS.object.0"/>
		</object>
		<object class="NSMutableDictionary" key="IBDocument.PluginDeclaredDevelopmentDependencies">
			<string key="NS.key.0">com.apple.InterfaceBuilder.CocoaPlugin.InterfaceBuilder3</string>
			<integer value="3000" key="NS.object.0"/>
		</object>
		<bool key="IBDocument.PluginDeclaredDependenciesTrackSystemTargetVersion">YES</bool>
		<string key="IBDocument.LastKnownRelativeProjectPath">../Randomify.xcodeproj</string>
		<int key="IBDocument.defaultPropertyAccessControl">3</int>
	</data>
</archive>


================================================
FILE: libspotify/examples/Randomify/Randomify-Info.plist
================================================
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>CFBundleDevelopmentRegion</key>
	<string>English</string>
	<key>CFBundleExecutable</key>
	<string>${EXECUTABLE_NAME}</string>
	<key>CFBundleIconFile</key>
	<string></string>
	<key>CFBundleIdentifier</key>
	<string>com.spotify.randomify</string>
	<key>CFBundleInfoDictionaryVersion</key>
	<string>6.0</string>
	<key>CFBundleName</key>
	<string>${PRODUCT_NAME}</string>
	<key>CFBundlePackageType</key>
	<string>APPL</string>
	<key>CFBundleShortVersionString</key>
	<string>1.0</string>
	<key>CFBundleSignature</key>
	<string>????</string>
	<key>CFBundleVersion</key>
	<string>1</string>
	<key>LSMinimumSystemVersion</key>
	<string>${MACOSX_DEPLOYMENT_TARGET}</string>
	<key>NSMainNibFile</key>
	<string>MainMenu</string>
	<key>NSPrincipalClass</key>
	<string>NSApplication</string>
</dict>
</plist>


================================================
FILE: libspotify/examples/Randomify/Randomify.xcodeproj/project.pbxproj
================================================
// !$*UTF8*$!
{
	archiveVersion = 1;
	classes = {
	};
	objectVersion = 45;
	objects = {

/* Begin PBXBuildFile section */
		0575227B1161F3A5003FFC9D /* libspotify.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 0575227A1161F3A5003FFC9D /* libspotify.framework */; };
		057522801161F3C9003FFC9D /* libspotify.framework in Copy Frameworks */ = {isa = PBXBuildFile; fileRef = 0575227A1161F3A5003FFC9D /* libspotify.framework */; };
		057522901161F4AE003FFC9D /* appkey.c in Sources */ = {isa = PBXBuildFile; fileRef = 0575228F1161F4AE003FFC9D /* appkey.c */; };
		057522BB1161F629003FFC9D /* audio.c in Sources */ = {isa = PBXBuildFile; fileRef = 057522BA1161F629003FFC9D /* audio.c */; };
		057522C01161F6F7003FFC9D /* SpotifySession.m in Sources */ = {isa = PBXBuildFile; fileRef = 057522BF1161F6F7003FFC9D /* SpotifySession.m */; };
		05752469116225C4003FFC9D /* SpotifyPlaylist.m in Sources */ = {isa = PBXBuildFile; fileRef = 05752468116225C4003FFC9D /* SpotifyPlaylist.m */; };
		057524E11162303B003FFC9D /* SpotifyTrack.m in Sources */ = {isa = PBXBuildFile; fileRef = 057524E01162303B003FFC9D /* SpotifyTrack.m */; };
		057526DD116248B1003FFC9D /* osx-audio.c in Sources */ = {isa = PBXBuildFile; fileRef = 057526DC116248B1003FFC9D /* osx-audio.c */; };
		057526E1116248D4003FFC9D /* AudioToolbox.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 057526E0116248D4003FFC9D /* AudioToolbox.framework */; };
		1DDD58160DA1D0A300B32029 /* MainMenu.xib in Resources */ = {isa = PBXBuildFile; fileRef = 1DDD58140DA1D0A300B32029 /* MainMenu.xib */; };
		256AC3DA0F4B6AC300CF3369 /* RandomifyAppDelegate.m in Sources */ = {isa = PBXBuildFile; fileRef = 256AC3D90F4B6AC300CF3369 /* RandomifyAppDelegate.m */; };
		8D11072B0486CEB800E47090 /* InfoPlist.strings in Resources */ = {isa = PBXBuildFile; fileRef = 089C165CFE840E0CC02AAC07 /* InfoPlist.strings */; };
		8D11072D0486CEB800E47090 /* main.m in Sources */ = {isa = PBXBuildFile; fileRef = 29B97316FDCFA39411CA2CEA /* main.m */; settings = {ATTRIBUTES = (); }; };
		8D11072F0486CEB800E47090 /* Cocoa.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 1058C7A1FEA54F0111CA2CBB /* Cocoa.framework */; };
/* End PBXBuildFile section */

/* Begin PBXCopyFilesBuildPhase section */
		0575226B1161F20D003FFC9D /* Copy Frameworks */ = {
			isa = PBXCopyFilesBuildPhase;
			buildActionMask = 2147483647;
			dstPath = "";
			dstSubfolderSpec = 10;
			files = (
				057522801161F3C9003FFC9D /* libspotify.framework in Copy Frameworks */,
			);
			name = "Copy Frameworks";
			runOnlyForDeploymentPostprocessing = 0;
		};
/* End PBXCopyFilesBuildPhase section */

/* Begin PBXFileReference section */
		0575227A1161F3A5003FFC9D /* libspotify.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = libspotify.framework; path = ../../libspotify.framework; sourceTree = SOURCE_ROOT; };
		0575228F1161F4AE003FFC9D /* appkey.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; name = appkey.c; path = ../appkey.c; sourceTree = SOURCE_ROOT; };
		057522B01161F609003FFC9D /* audio.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = audio.h; path = ../jukebox/audio.h; sourceTree = SOURCE_ROOT; };
		057522B21161F609003FFC9D /* queue.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = queue.h; path = ../jukebox/queue.h; sourceTree = SOURCE_ROOT; };
		057522BA1161F629003FFC9D /* audio.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; name = audio.c; path = ../jukebox/audio.c; sourceTree = SOURCE_ROOT; };
		057522BE1161F6F7003FFC9D /* SpotifySession.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = SpotifySession.h; sourceTree = "<group>"; };
		057522BF1161F6F7003FFC9D /* SpotifySession.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = SpotifySession.m; sourceTree = "<group>"; };
		05752467116225C4003FFC9D /* SpotifyPlaylist.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = SpotifyPlaylist.h; sourceTree = "<group>"; };
		05752468116225C4003FFC9D /* SpotifyPlaylist.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = SpotifyPlaylist.m; sourceTree = "<group>"; };
		057524DF1162303B003FFC9D /* SpotifyTrack.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = SpotifyTrack.h; sourceTree = "<group>"; };
		057524E01162303B003FFC9D /* SpotifyTrack.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = SpotifyTrack.m; sourceTree = "<group>"; };
		057526DC116248B1003FFC9D /* osx-audio.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; name = "osx-audio.c"; path = "../jukebox/osx-audio.c"; sourceTree = SOURCE_ROOT; };
		057526E0116248D4003FFC9D /* AudioToolbox.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = AudioToolbox.framework; path = System/Library/Frameworks/AudioToolbox.framework; sourceTree = SDKROOT; };
		089C165DFE840E0CC02AAC07 /* English */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist.strings; name = English; path = English.lproj/InfoPlist.strings; sourceTree = "<group>"; };
		1058C7A1FEA54F0111CA2CBB /* Cocoa.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = Cocoa.framework; path = /System/Library/Frameworks/Cocoa.framework; sourceTree = "<absolute>"; };
		1DDD58150DA1D0A300B32029 /* English */ = {isa = PBXFileReference; lastKnownFileType = file.xib; name = English; path = English.lproj/MainMenu.xib; sourceTree = "<group>"; };
		256AC3D80F4B6AC300CF3369 /* RandomifyAppDelegate.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = RandomifyAppDelegate.h; sourceTree = "<group>"; };
		256AC3D90F4B6AC300CF3369 /* RandomifyAppDelegate.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = RandomifyAppDelegate.m; sourceTree = "<group>"; };
		256AC3F00F4B6AF500CF3369 /* Randomify_Prefix.pch */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = Randomify_Prefix.pch; sourceTree = "<group>"; };
		29B97316FDCFA39411CA2CEA /* main.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = main.m; sourceTree = "<group>"; };
		8D1107310486CEB800E47090 /* Randomify-Info.plist */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist.xml; path = "Randomify-Info.plist"; sourceTree = "<group>"; };
		8D1107320486CEB800E47090 /* Randomify.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = Randomify.app; sourceTree = BUILT_PRODUCTS_DIR; };
/* End PBXFileReference section */

/* Begin PBXFrameworksBuildPhase section */
		8D11072E0486CEB800E47090 /* Frameworks */ = {
			isa = PBXFrameworksBuildPhase;
			buildActionMask = 2147483647;
			files = (
				8D11072F0486CEB800E47090 /* Cocoa.framework in Frameworks */,
				0575227B1161F3A5003FFC9D /* libspotify.framework in Frameworks */,
				057526E1116248D4003FFC9D /* AudioToolbox.framework in Frameworks */,
			);
			runOnlyForDeploymentPostprocessing = 0;
		};
/* End PBXFrameworksBuildPhase section */

/* Begin PBXGroup section */
		080E96DDFE201D6D7F000001 /* Classes */ = {
			isa = PBXGroup;
			children = (
				256AC3D80F4B6AC300CF3369 /* RandomifyAppDelegate.h */,
				256AC3D90F4B6AC300CF3369 /* RandomifyAppDelegate.m */,
				057522BE1161F6F7003FFC9D /* SpotifySession.h */,
				057522BF1161F6F7003FFC9D /* SpotifySession.m */,
				05752467116225C4003FFC9D /* SpotifyPlaylist.h */,
				05752468116225C4003FFC9D /* SpotifyPlaylist.m */,
				057524DF1162303B003FFC9D /* SpotifyTrack.h */,
				057524E01162303B003FFC9D /* SpotifyTrack.m */,
			);
			name = Classes;
			sourceTree = "<group>";
		};
		19C28FACFE9D520D11CA2CBB /* Products */ = {
			isa = PBXGroup;
			children = (
				8D1107320486CEB800E47090 /* Randomify.app */,
			);
			name = Products;
			sourceTree = "<group>";
		};
		29B97314FDCFA39411CA2CEA /* Randomify */ = {
			isa = PBXGroup;
			children = (
				080E96DDFE201D6D7F000001 /* Classes */,
				29B97315FDCFA39411CA2CEA /* Other Sources */,
				29B97317FDCFA39411CA2CEA /* Resources */,
				29B97323FDCFA39411CA2CEA /* Frameworks */,
				19C28FACFE9D520D11CA2CBB /* Products */,
			);
			name = Randomify;
			sourceTree = "<group>";
		};
		29B97315FDCFA39411CA2CEA /* Other Sources */ = {
			isa = PBXGroup;
			children = (
				057522B01161F609003FFC9D /* audio.h */,
				057522B21161F609003FFC9D /* queue.h */,
				057526DC116248B1003FFC9D /* osx-audio.c */,
				0575228F1161F4AE003FFC9D /* appkey.c */,
				057522BA1161F629003FFC9D /* audio.c */,
				256AC3F00F4B6AF500CF3369 /* Randomify_Prefix.pch */,
				29B97316FDCFA39411CA2CEA /* main.m */,
			);
			name = "Other Sources";
			sourceTree = "<group>";
		};
		29B97317FDCFA39411CA2CEA /* Resources */ = {
			isa = PBXGroup;
			children = (
				8D1107310486CEB800E47090 /* Randomify-Info.plist */,
				089C165CFE840E0CC02AAC07 /* InfoPlist.strings */,
				1DDD58140DA1D0A300B32029 /* MainMenu.xib */,
			);
			name = Resources;
			sourceTree = "<group>";
		};
		29B97323FDCFA39411CA2CEA /* Frameworks */ = {
			isa = PBXGroup;
			children = (
				0575227A1161F3A5003FFC9D /* libspotify.framework */,
				1058C7A1FEA54F0111CA2CBB /* Cocoa.framework */,
				057526E0116248D4003FFC9D /* AudioToolbox.framework */,
			);
			name = Frameworks;
			sourceTree = "<group>";
		};
/* End PBXGroup section */

/* Begin PBXNativeTarget section */
		8D1107260486CEB800E47090 /* Randomify */ = {
			isa = PBXNativeTarget;
			buildConfigurationList = C01FCF4A08A954540054247B /* Build configuration list for PBXNativeTarget "Randomify" */;
			buildPhases = (
				0575226B1161F20D003FFC9D /* Copy Frameworks */,
				8D1107290486CEB800E47090 /* Resources */,
				8D11072C0486CEB800E47090 /* Sources */,
				8D11072E0486CEB800E47090 /* Frameworks */,
			);
			buildRules = (
			);
			dependencies = (
			);
			name = Randomify;
			productInstallPath = "$(HOME)/Applications";
			productName = Randomify;
			productReference = 8D1107320486CEB800E47090 /* Randomify.app */;
			productType = "com.apple.product-type.application";
		};
/* End PBXNativeTarget section */

/* Begin PBXProject section */
		29B97313FDCFA39411CA2CEA /* Project object */ = {
			isa = PBXProject;
			buildConfigurationList = C01FCF4E08A954540054247B /* Build configuration list for PBXProject "Randomify" */;
			compatibilityVersion = "Xcode 3.1";
			hasScannedForEncodings = 1;
			mainGroup = 29B97314FDCFA39411CA2CEA /* Randomify */;
			projectDirPath = "";
			projectRoot = "";
			targets = (
				8D1107260486CEB800E47090 /* Randomify */,
			);
		};
/* End PBXProject section */

/* Begin PBXResourcesBuildPhase section */
		8D1107290486CEB800E47090 /* Resources */ = {
			isa = PBXResourcesBuildPhase;
			buildActionMask = 2147483647;
			files = (
				8D11072B0486CEB800E47090 /* InfoPlist.strings in Resources */,
				1DDD58160DA1D0A300B32029 /* MainMenu.xib in Resources */,
			);
			runOnlyForDeploymentPostprocessing = 0;
		};
/* End PBXResourcesBuildPhase section */

/* Begin PBXSourcesBuildPhase section */
		8D11072C0486CEB800E47090 /* Sources */ = {
			isa = PBXSourcesBuildPhase;
			buildActionMask = 2147483647;
			files = (
				8D11072D0486CEB800E47090 /* main.m in Sources */,
				256AC3DA0F4B6AC300CF3369 /* RandomifyAppDelegate.m in Sources */,
				057522901161F4AE003FFC9D /* appkey.c in Sources */,
				057522BB1161F629003FFC9D /* audio.c in Sources */,
				057522C01161F6F7003FFC9D /* SpotifySession.m in Sources */,
				05752469116225C4003FFC9D /* SpotifyPlaylist.m in Sources */,
				057524E11162303B003FFC9D /* SpotifyTrack.m in Sources */,
				057526DD116248B1003FFC9D /* osx-audio.c in Sources */,
			);
			runOnlyForDeploymentPostprocessing = 0;
		};
/* End PBXSourcesBuildPhase section */

/* Begin PBXVariantGroup section */
		089C165CFE840E0CC02AAC07 /* InfoPlist.strings */ = {
			isa = PBXVariantGroup;
			children = (
				089C165DFE840E0CC02AAC07 /* English */,
			);
			name = InfoPlist.strings;
			sourceTree = "<group>";
		};
		1DDD58140DA1D0A300B32029 /* MainMenu.xib */ = {
			isa = PBXVariantGroup;
			children = (
				1DDD58150DA1D0A300B32029 /* English */,
			);
			name = MainMenu.xib;
			sourceTree = "<group>";
		};
/* End PBXVariantGroup section */

/* Begin XCBuildConfiguration section */
		C01FCF4B08A954540054247B /* Debug */ = {
			isa = XCBuildConfiguration;
			buildSettings = {
				ALWAYS_SEARCH_USER_PATHS = NO;
				COPY_PHASE_STRIP = NO;
				FRAMEWORK_SEARCH_PATHS = (
					"$(inherited)",
					"\"$(SRCROOT)/../..\"",
				);
				GCC_DYNAMIC_NO_PIC = NO;
				GCC_ENABLE_FIX_AND_CONTINUE = YES;
				GCC_MODEL_TUNING = G5;
				GCC_OPTIMIZATION_LEVEL = 0;
				GCC_PRECOMPILE_PREFIX_HEADER = YES;
				GCC_PREFIX_HEADER = Randomify_Prefix.pch;
				INFOPLIST_FILE = "Randomify-Info.plist";
				INSTALL_PATH = "$(HOME)/Applications";
				PRODUCT_NAME = Randomify;
			};
			name = Debug;
		};
		C01FCF4C08A954540054247B /* Release */ = {
			isa = XCBuildConfiguration;
			buildSettings = {
				ALWAYS_SEARCH_USER_PATHS = NO;
				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
				FRAMEWORK_SEARCH_PATHS = (
					"$(inherited)",
					"\"$(SRCROOT)/../..\"",
				);
				GCC_MODEL_TUNING = G5;
				GCC_PRECOMPILE_PREFIX_HEADER = YES;
				GCC_PREFIX_HEADER = Randomify_Prefix.pch;
				INFOPLIST_FILE = "Randomify-Info.plist";
				INSTALL_PATH = "$(HOME)/Applications";
				PRODUCT_NAME = Randomify;
			};
			name = Release;
		};
		C01FCF4F08A954540054247B /* Debug */ = {
			isa = XCBuildConfiguration;
			buildSettings = {
				ARCHS = "$(ARCHS_STANDARD_32_64_BIT)";
				GCC_C_LANGUAGE_STANDARD = gnu99;
				GCC_OPTIMIZATION_LEVEL = 0;
				GCC_WARN_ABOUT_RETURN_TYPE = YES;
				GCC_WARN_UNUSED_VARIABLE = YES;
				ONLY_ACTIVE_ARCH = YES;
				PREBINDING = NO;
				SDKROOT = macosx10.6;
			};
			name = Debug;
		};
		C01FCF5008A954540054247B /* Release */ = {
			isa = XCBuildConfiguration;
			buildSettings = {
				ARCHS = "$(ARCHS_STANDARD_32_64_BIT)";
				GCC_C_LANGUAGE_STANDARD = gnu99;
				GCC_WARN_ABOUT_RETURN_TYPE = YES;
				GCC_WARN_UNUSED_VARIABLE = YES;
				PREBINDING = NO;
				SDKROOT = macosx10.6;
			};
			name = Release;
		};
/* End XCBuildConfiguration section */

/* Begin XCConfigurationList section */
		C01FCF4A08A954540054247B /* Build configuration list for PBXNativeTarget "Randomify" */ = {
			isa = XCConfigurationList;
			buildConfigurations = (
				C01FCF4B08A954540054247B /* Debug */,
				C01FCF4C08A954540054247B /* Release */,
			);
			defaultConfigurationIsVisible = 0;
			defaultConfigurationName = Release;
		};
		C01FCF4E08A954540054247B /* Build configuration list for PBXProject "Randomify" */ = {
			isa = XCConfigurationList;
			buildConfigurations = (
				C01FCF4F08A954540054247B /* Debug */,
				C01FCF5008A954540054247B /* Release */,
			);
			defaultConfigurationIsVisible = 0;
			defaultConfigurationName = Release;
		};
/* End XCConfigurationList section */
	};
	rootObject = 29B97313FDCFA39411CA2CEA /* Project object */;
}


================================================
FILE: libspotify/examples/Randomify/RandomifyAppDelegate.h
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 *
 * This example application show how to use libspotify in a Mac OS X
 * application, playing randomly from your Starred playlist.
 *
 * This file is part of the libspotify examples suite.
 */

#import <Cocoa/Cocoa.h>
#import "SpotifySession.h"

@interface RandomifyAppDelegate : NSObject
	<SpotifySessionDelegate, SpotifyPlaylistDelegate>
{
    IBOutlet NSWindow *window;
	IBOutlet NSTextField *username;
	IBOutlet NSTextField *password;
	IBOutlet NSTextField *log;
	IBOutlet NSTextField *status;
	
	SpotifySession *session;
	SpotifyPlaylist *starred;
	BOOL playing;
	IBOutlet NSButton *playButton;
	
	SpotifyTrack *playingTrack;
}
-(IBAction)loginAndPlay:(id)sender;

-(IBAction)playARandomSong:(id)sender;
-(IBAction)togglePlay:(id)sender;
@end


================================================
FILE: libspotify/examples/Randomify/RandomifyAppDelegate.m
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 * This file is part of the libspotify examples suite.
 * See RandomifyAppDelegate.h for license.
 */

#import "RandomifyAppDelegate.h"
#import "SpotifySession.h"

@interface RandomifyAppDelegate ()
@property (retain) SpotifyPlaylist *starred;
@property (retain) SpotifyTrack *playingTrack;
@property BOOL playing;
@end


@implementation RandomifyAppDelegate
@synthesize starred, playingTrack;
#pragma mark Session delegates
-(void)session:(SpotifySession*)session_ logged:(NSString*)logmsg;
{
	NSString *new = [logmsg stringByAppendingString:log.stringValue];
	log.stringValue = new;
}
-(void)sessionLoggedIn:(SpotifySession*)session_ error:(NSError*)err;
{
	if(err) {
		[NSApp presentError:err];
		return;
	}
	[self session:session logged:@"Logged in!\n"];
	
	self.starred = session.starred;
	starred.delegate = self;

	[self playARandomSong:nil];
}
-(void)session:(SpotifySession*)session_ connectionError:(NSError*)error;
{
	[NSApp presentError:error];
}
-(void)session:(SpotifySession*)session_ streamingError:(NSError*)error;
{
	[NSApp presentError:error];
}

-(void)playlistEndedUpdating:(SpotifyPlaylist*)playlist;
{
	if(playlist.loaded && !playing)
		[self playARandomSong:nil];
}
-(void)playlistChangedState:(SpotifyPlaylist*)playlist;
{
	if(playlist.loaded && !playing)
		[self playARandomSong:nil];
}

-(void)sessionUpdatedMetadata:(SpotifySession *)session_;
{
	// A track we're waiting for metadata for might now have gotten it.
	if(!playing && playingTrack && playingTrack.loaded) {
		if(!playingTrack.available) {
			[self playARandomSong:nil];
			return;
		}
		[self session:session logged:[NSString stringWithFormat:@"Playing now loaded track: %@\n", playingTrack]];
		status.stringValue = playingTrack.description;
		[session loadTrack:playingTrack];
		[session play];
		self.playing = YES;
	}
}
-(void)sessionEndedPlayingTrack:(SpotifySession*)session_;
{
	self.playing = NO;
	[self session:session logged:@"Playlist is ready!\n"];
	[self playARandomSong:nil];
}
-(void)sessionLostPlayToken:(SpotifySession *)session;
{
	NSRunAlertPanel(@"Lost play token", @"Another client is playing.", @"Arrrghh", nil, nil);
	self.playing = NO;
}


#pragma mark -
- (void)applicationDidFinishLaunching:(NSNotification *)aNotification {
	srandom(time(NULL));
	self.playing = NO;

	NSError *err = nil;
	session = [[SpotifySession alloc] initError:&err];
	session.delegate = self;
	
	status.stringValue = @"Randomify";
	
	if(!session) {
		[NSApp presentError:err];
		[NSApp terminate:nil];
	}
}
-(IBAction)loginAndPlay:(id)sender;
{
	[session loginUser:username.stringValue password:password.stringValue];
}

-(IBAction)playARandomSong:(id)sender;
{
	NSUInteger count = [starred countOfTracks];

	if(!starred.loaded || !count) {
		[self session:session logged:@"Waiting for playlist to load...\n"];
		return;
	}
	
	NSUInteger randomIndex = random()%count;
	
	self.playingTrack = [starred objectInTracksAtIndex:randomIndex];
	if(!self.playingTrack.loaded) {
		[self session:session logged:@"Waiting for track to load...\n"];
		status.stringValue = @"Loading…";
		return;
	}
	
	[self session:session logged:[NSString stringWithFormat:@"Playing track: %@\n", playingTrack]];
	status.stringValue = playingTrack.description;
	
	[session loadTrack:playingTrack];
	[session play];

	self.playing = YES;
}
-(IBAction)togglePlay:(id)sender;
{
	if(playing) {
		[session pause];
		self.playing = NO;
	} else {
		[session play];
		self.playing = YES;
	}
}

-(BOOL)playing;
{
	return playing;
}
-(void)setPlaying:(BOOL)playing_;
{
	[playButton setEnabled:playingTrack != nil];
	
	playing = playing_;
	[playButton setStringValue:playing ? @"║" : @"▹"];
}
@end


================================================
FILE: libspotify/examples/Randomify/SpotifyPlaylist.h
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 * This file is part of the libspotify examples suite.
 * See RandomifyAppDelegate.h for license.
 */
 
#import <Foundation/Foundation.h>
#import <libspotify/api.h>
#import "SpotifyTrack.h"

@class SpotifyPlaylist;
@protocol SpotifyPlaylistDelegate
@optional
-(void)playlistBeganUpdating:(SpotifyPlaylist*)playlist;
-(void)playlistEndedUpdating:(SpotifyPlaylist*)playlist;
-(void)playlistChangedState:(SpotifyPlaylist*)playlist;
@end


@interface SpotifyPlaylist : NSObject {
	sp_playlist *playlist;
	sp_playlist_callbacks callbacks;
	sp_session *session;
	NSObject<SpotifyPlaylistDelegate> *delegate;
}
-(id)initWithPlaylist:(sp_playlist*)playlist_ onSession:(sp_session*)sess;
@property (assign) NSObject<SpotifyPlaylistDelegate> *delegate;
@property (readonly) BOOL loaded; // listen to playlistEndedUpdating if false

-(NSUInteger)countOfTracks;
-(SpotifyTrack*)objectInTracksAtIndex:(NSUInteger)index;
@end


================================================
FILE: libspotify/examples/Randomify/SpotifyPlaylist.m
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 * This file is part of the libspotify examples suite.
 * See RandomifyAppDelegate.h for license.
 */

#import "SpotifyPlaylist.h"
#import "SpotifyTrack.h"

#define plobj ((SpotifyPlaylist*)userdata)

static void playlist_update_in_progress(sp_playlist *pl, bool done, void *userdata)
{
	if(!done) {
		if([plobj.delegate respondsToSelector:@selector(playlistBeganUpdating:)])
			[plobj.delegate playlistBeganUpdating:plobj];
	} else {
		if([plobj.delegate respondsToSelector:@selector(playlistEndedUpdating:)])
			[plobj.delegate playlistEndedUpdating:plobj];
	}
}
static void playlist_state_changed(sp_playlist *pl, void *userdata)
{
	if([plobj.delegate respondsToSelector:@selector(playlistChangedState:)])
		[plobj.delegate playlistChangedState:plobj];	
}

// TODO: Instead of exposing playlist content changes as delegate methods,
// make tracks KVO-compliant

@implementation SpotifyPlaylist
@synthesize delegate;
-(id)initWithPlaylist:(sp_playlist*)playlist_ onSession:(sp_session*)sess;
{
	playlist = playlist_;
	
	session = sess;
	
	callbacks = (sp_playlist_callbacks) {
		.playlist_update_in_progress = playlist_update_in_progress,
	};
	
	sp_playlist_add_ref(playlist);
	sp_playlist_add_callbacks(playlist, &callbacks, self);
	
	
	return self;
}
-(void)dealloc;
{
	sp_playlist_remove_callbacks(playlist, &callbacks, self);
	sp_playlist_release(playlist);
	[super dealloc];
}

-(BOOL)loaded;
{
	return sp_playlist_is_loaded(playlist);
}
-(NSUInteger)countOfTracks;
{
	return sp_playlist_num_tracks(playlist);
}
-(SpotifyTrack*)objectInTracksAtIndex:(NSUInteger)index;
{
	return [[[SpotifyTrack alloc] initWithTrack:sp_playlist_track(playlist, index) onSession:session] autorelease];
}
@end


================================================
FILE: libspotify/examples/Randomify/SpotifySession.h
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 * This file is part of the libspotify examples suite.
 * See RandomifyAppDelegate.h for license.
 */

#import <Foundation/Foundation.h>
#import <libspotify/api.h>
#import "audio.h"
#import "SpotifyPlaylist.h"

@class SpotifySession;
@protocol SpotifySessionDelegate
@optional
-(void)sessionLoggedIn:(SpotifySession*)session error:(NSError*)err;
-(void)sessionLoggedOut:(SpotifySession*)session;
-(void)sessionUpdatedMetadata:(SpotifySession*)session;
-(void)session:(SpotifySession*)session connectionError:(NSError*)error;
-(void)session:(SpotifySession*)session hasMessageToUser:(NSString*)message;
-(void)sessionLostPlayToken:(SpotifySession*)session;
-(void)session:(SpotifySession*)session logged:(NSString*)logmsg;
-(void)sessionEndedPlayingTrack:(SpotifySession*)session;
-(void)session:(SpotifySession*)session streamingError:(NSError*)error;
-(void)sessionUpdatedUserinfo:(SpotifySession*)session;
@end


@interface SpotifySession : NSObject {
	sp_session_config config;
	sp_session_callbacks callbacks;
	NSString *cachesDir, *supportDir;
	audio_fifo_t audiofifo;
	sp_session *session;
	NSObject<SpotifySessionDelegate> *delegate;
}
@property (assign) NSObject<SpotifySessionDelegate> *delegate;
-(id)initError:(NSError**)err;
-(void)loginUser:(NSString*)user password:(NSString*)passwd;
-(void)logout;

@property (readonly) SpotifyPlaylist *starred;

// Should be its own class: SpotifyPlayer
-(void)loadTrack:(SpotifyTrack*)track;
-(void)pause;
-(void)play;


// Stops processing events. If you only release this object,
// the runtime will still own it.
-(void)shutdown;
@end


================================================
FILE: libspotify/examples/Randomify/SpotifySession.m
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 * This file is part of the libspotify examples suite.
 * See RandomifyAppDelegate.h for license.
 */

#import "SpotifySession.h"

/// The application key is specific to each project, and allows Spotify
/// to produce statistics on how our service is used.
extern const uint8_t g_appkey[];
/// The size of the application key.
extern const size_t g_appkey_size;

NSError *makeError(sp_error code) {
	NSError *err = [NSError errorWithDomain:@"com.spotify" code:code userInfo:[NSDictionary dictionaryWithObjectsAndKeys:
		[NSString stringWithUTF8String:sp_error_message(code)], NSLocalizedDescriptionKey,
		nil
	]];
	return err;
}

@interface SpotifySession ()
-(void)processEvents;
@property (readonly) audio_fifo_t *audiofifo;

-(void)tellDelegateThatSessionLogged:(NSString*)msg;

@end

#pragma mark 
#pragma mark Callbacks
#pragma mark -

static SpotifySession *sessobj(sp_session *session) {
	return (SpotifySession*)sp_session_userdata(session);
}

static void logged_in(sp_session *session, sp_error error)
{
	NSObject<SpotifySessionDelegate> *delegate = sessobj(session).delegate;
	NSError *err = SP_ERROR_OK == error ? nil : makeError(error);
	if([delegate respondsToSelector:@selector(sessionLoggedIn:error:)])
		[delegate sessionLoggedIn:sessobj(session) error:err];
}

static void logged_out(sp_session *session)
{
	NSObject<SpotifySessionDelegate> *delegate = sessobj(session).delegate;
	if([delegate respondsToSelector:@selector(sessionLoggedOut:)])
		[delegate sessionLoggedOut:sessobj(session)];
}

static void metadata_updated(sp_session *session)
{
	NSObject<SpotifySessionDelegate> *delegate = sessobj(session).delegate;
	if([delegate respondsToSelector:@selector(sessionUpdatedMetadata:)])
		[delegate sessionUpdatedMetadata:sessobj(session)];
}

static void connection_error(sp_session *session, sp_error error)
{
	NSObject<SpotifySessionDelegate> *delegate = sessobj(session).delegate;
	NSError *err = SP_ERROR_OK == error ? nil : makeError(error);
	if([delegate respondsToSelector:@selector(session:connectionError:)])
		[delegate session:sessobj(session) connectionError:err];
}

static void message_to_user(sp_session *session, const char *message)
{
	NSObject<SpotifySessionDelegate> *delegate = sessobj(session).delegate;
	NSString *msg = [NSString stringWithUTF8String:message];
	if([delegate respondsToSelector:@selector(session:hasMessageToUser:)])
		[delegate session:sessobj(session) hasMessageToUser:msg];
}

static void notify_main_thread(sp_session *session)
{
	[sessobj(session) performSelectorOnMainThread:@selector(processEvents) withObject:nil waitUntilDone:NO];
}

static int music_delivery(sp_session *sess, const sp_audioformat *format,
                          const void *frames, int num_frames)
{
	audio_fifo_t *af = sessobj(sess).audiofifo;
	audio_fifo_data_t *afd = NULL;
	size_t s;

	if (num_frames == 0)
		return 0; // Audio discontinuity, do nothing

	pthread_mutex_lock(&af->mutex);

	/* Buffer one second of audio */
	if (af->qlen > format->sample_rate) {
		pthread_mutex_unlock(&af->mutex);

		return 0;
	}

	s = num_frames * sizeof(int16_t) * format->channels;

	afd = malloc(sizeof(audio_fifo_data_t) + s);
	memcpy(afd->samples, frames, s);

	afd->nsamples = num_frames;

	afd->rate = format->sample_rate;
	afd->channels = format->channels;

	TAILQ_INSERT_TAIL(&af->q, afd, link);
	af->qlen += num_frames;

	pthread_cond_signal(&af->cond);
	pthread_mutex_unlock(&af->mutex);

	return num_frames;
}

static void play_token_lost(sp_session *session)
{
	NSObject<SpotifySessionDelegate> *delegate = sessobj(session).delegate;
	if([delegate respondsToSelector:@selector(sessionLostPlayToken:)])
		[delegate sessionLostPlayToken:sessobj(session)];
}

static void log_message(sp_session *session, const char *message)
{
	NSObject<SpotifySessionDelegate> *delegate = sessobj(session).delegate;
	NSString *msg = [[NSString alloc] initWithUTF8String:message];
	if([delegate respondsToSelector:@selector(session:logged:)])
		[sessobj(session) performSelectorOnMainThread:@selector(tellDelegateThatSessionLogged:)
										   withObject:msg 
										waitUntilDone:NO];
	
}

static void end_of_track(sp_session *session)
{
	NSObject<SpotifySessionDelegate> *delegate = sessobj(session).delegate;
	if([delegate respondsToSelector:@selector(sessionEndedPlayingTrack:)])
		[delegate performSelectorOnMainThread:@selector(sessionEndedPlayingTrack:)
								   withObject:sessobj(session)
								waitUntilDone:NO];
}

static void streaming_error(sp_session *session, sp_error error)
{
	NSObject<SpotifySessionDelegate> *delegate = sessobj(session).delegate;
	NSError *err = SP_ERROR_OK == error ? nil : makeError(error);
	if([delegate respondsToSelector:@selector(session:streamingError:)])
		[delegate session:sessobj(session) streamingError:err];
}

static void userinfo_updated(sp_session *session)
{
	NSObject<SpotifySessionDelegate> *delegate = sessobj(session).delegate;
	if([delegate respondsToSelector:@selector(sessionUpdatedUserinfo:)])
		[delegate sessionUpdatedUserinfo:sessobj(session)];
}




#pragma mark  
@implementation SpotifySession
#pragma mark -
@synthesize delegate;

-(id)initError:(NSError**)error;
{
	audio_init(&audiofifo);
	
	NSArray *cachesDirs = NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES);
	NSArray *supportDirs = NSSearchPathForDirectoriesInDomains(NSApplicationSupportDirectory, NSUserDomainMask, YES);
	cachesDir = [[cachesDirs objectAtIndex:0] retain];
	supportDir = [[supportDirs objectAtIndex:0] retain];
	
	callbacks = (sp_session_callbacks){
		.logged_in = logged_in,
		.logged_out = logged_out,
		.metadata_updated = metadata_updated,
		.connection_error = connection_error,
		.message_to_user = message_to_user,
		.notify_main_thread = notify_main_thread,
		.music_delivery = music_delivery,
		.play_token_lost = play_token_lost,
		.log_message = log_message,
		.end_of_track = end_of_track,
		.streaming_error = streaming_error,
		.userinfo_updated = userinfo_updated,
	};
	
	config = (sp_session_config){
		.api_version = SPOTIFY_API_VERSION,
		.cache_location = [cachesDir UTF8String],
		.settings_location = [supportDir UTF8String],
		.application_key = g_appkey,
		.application_key_size = g_appkey_size,
		.user_agent = [[[NSProcessInfo processInfo] processName] UTF8String],
		.callbacks = &callbacks,
		.userdata = self,
	};
	
	sp_error sperror = sp_session_create(&config, &session);
	
	if (SP_ERROR_OK != sperror) {
		if(error) *error = makeError(sperror);
		[self release];
		return nil;
	}
	
	[self processEvents];

	
	return self;
}
-(void)dealloc;
{
	// todo: shutdown audiofifo
	[cachesDir release];
	[supportDir release];
	[super dealloc];
}
-(void)shutdown;
{
	[NSObject cancelPreviousPerformRequestsWithTarget:self]; // Cancel any pending processEvents
}

-(void)loginUser:(NSString*)user password:(NSString*)passwd;
{
	sp_session_login(session, [user UTF8String], [passwd UTF8String], 0, NULL);
}
-(void)logout;
{
	sp_session_logout(session);
}

-(SpotifyPlaylist*)starred;
{
	sp_playlist *pl = sp_session_starred_create(session);
	SpotifyPlaylist *playlist = [[[SpotifyPlaylist alloc] initWithPlaylist:pl onSession:session] autorelease];
	sp_playlist_release(pl);
	return playlist;
}

-(void)loadTrack:(SpotifyTrack *)track;
{
	sp_session_player_load(session, track.track);
}
-(void)pause;
{
	audio_fifo_flush(&audiofifo);
	sp_session_player_play(session, FALSE);
}
-(void)play;
{
	audio_fifo_flush(&audiofifo);
	sp_session_player_play(session, TRUE);
}

#pragma mark 
#pragma mark Private
#pragma mark -
-(void)processEvents;
{
	[NSObject cancelPreviousPerformRequestsWithTarget:self selector:_cmd object:nil];
	int msTilNext = 0;
	while(msTilNext == 0)
		sp_session_process_events(session, &msTilNext);
	
	
	NSTimeInterval secsTilNext = msTilNext/1000.;
	[self performSelector:_cmd withObject:nil afterDelay:secsTilNext];
}

-(audio_fifo_t*)audiofifo;
{
	return &audiofifo;
}

-(void)tellDelegateThatSessionLogged:(NSString*)msg;
{
	[delegate session:self logged:msg];
	[msg release];
}

@end


================================================
FILE: libspotify/examples/Randomify/SpotifyTrack.h
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 * This file is part of the libspotify examples suite.
 * See RandomifyAppDelegate.h for license.
 */

#import <Foundation/Foundation.h>
#import <libspotify/api.h>

@interface SpotifyTrack : NSObject {
	sp_track *track;
	sp_session *session;
}
-(id)initWithTrack:(sp_track*)track_ onSession:(sp_session*)sess;

@property (readonly) NSString *name;
@property (readonly) NSString *artistName;
@property (readonly) BOOL loaded;
@property (readonly) BOOL available;

// Private
@property (readonly) sp_track *track;
@end


================================================
FILE: libspotify/examples/Randomify/SpotifyTrack.m
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 * This file is part of the libspotify examples suite.
 * See RandomifyAppDelegate.h for license.
 */

#import "SpotifyTrack.h"


@implementation SpotifyTrack
@synthesize track;
-(id)initWithTrack:(sp_track*)track_ onSession:(sp_session*)sess;
{
	track = track_;
	session = sess;
	sp_track_add_ref(track);
	return self;
}
-(void)dealloc;
{
	sp_track_release(track);
	[super dealloc];
}

-(NSString*)name;
{
	const char *name = sp_track_name(track);
	if(!name || !sp_track_is_loaded(track)) return @"[loading]";
	return [NSString stringWithUTF8String:sp_track_name(track)];
}
-(NSString*)artistName;
{
	sp_artist *artist = sp_track_artist(track, 0);
	const char *artistName = artist ? sp_artist_name(artist) : "[loading]";
	return [NSString stringWithUTF8String:artistName];
}
-(BOOL)loaded;
{
	return sp_track_is_loaded(track);
}
-(BOOL)available;
{
	return sp_track_get_availability(session, track) == SP_TRACK_AVAILABILITY_AVAILABLE;
}

-(NSString*)description;
{
	return [NSString stringWithFormat:@"<%@ by %@>",
		self.name,
		self.artistName
	];
}

@end


================================================
FILE: libspotify/examples/Randomify/main.m
================================================
//
//  main.m
//  Randomify
//
//  Created by Joachim Bengtsson on 2010-03-30.
//  Copyright 2010 Spotify. All rights reserved.
//

#import <Cocoa/Cocoa.h>

int main(int argc, char *argv[])
{
    return NSApplicationMain(argc,  (const char **) argv);
}


================================================
FILE: libspotify/examples/appkey.c
================================================
#error
#error "You need to replace this file with a libspotify API key provided by Spotify. Please see https://developer.spotify.com/en/libspotify/application-key/"
#error


================================================
FILE: libspotify/examples/common.mk
================================================
# Copyright (c) 2010 Spotify Ltd

all:	check-libspotify $(TARGET)

#
# Direct path to libspotify
#
ifdef LIBSPOTIFY_PATH

P=$(shell cd "$(LIBSPOTIFY_PATH)" && pwd)

check-libspotify:
	@test -f $(P)/lib/libspotify.so || (echo "Failed to find libspotify.so in $(P)/lib" >&2 ; exit 1)
	@test -f $(P)/include/libspotify/api.h || (echo "Failed to find libspotify/api.h in $(P)/include" >&2 ; exit 1)

CFLAGS  += -I$(P)/include
LDFLAGS += -Wl,-rpath,$(P)/lib -L$(P)/lib
LDLIBS  += -lspotify

ifeq ($(shell uname),Darwin)
CPUARCH   ?= $(shell uname -m)
CFLAGS    += -D__APPLE__ -arch $(CPUARCH)
LDFLAGS   += -arch $(CPUARCH)
endif

#
# Use pkg-config(1)
#
else

check-libspotify:
	@pkg-config --exists libspotify || (echo "Failed to find libspotify using pkg-config(1)" >&2 ; exit 1)

CFLAGS  += $(shell PKG_CONFIG_PATH=$(PKG_CONFIG_PATH) pkg-config --cflags libspotify)
LDFLAGS += $(shell PKG_CONFIG_PATH=$(PKG_CONFIG_PATH) pkg-config --libs-only-L libspotify)
LDLIBS  += $(shell PKG_CONFIG_PATH=$(PKG_CONFIG_PATH) pkg-config --libs-only-l --libs-only-other libspotify)

endif

ifdef DEBUG
CFLAGS += -g3 -O0
endif

CFLAGS += -Wall

.PHONY: all check-libspotify clean

vpath %.c ../

clean:
	rm -f *.o *~ $(TARGET)


================================================
FILE: libspotify/examples/jukebox/Makefile
================================================
ifeq ($(shell uname),Darwin)
ifdef USE_AUDIOQUEUE
AUDIO_DRIVER ?= osx
LDFLAGS += -framework AudioToolbox
else
AUDIO_DRIVER ?= openal
LDFLAGS += -framework OpenAL
endif
else
CFLAGS  = $(shell PKG_CONFIG_PATH=$(PKG_CONFIG_PATH) pkg-config --cflags alsa)
LDFLAGS = $(shell PKG_CONFIG_PATH=$(PKG_CONFIG_PATH) pkg-config --libs-only-L alsa)
LDLIBS  = $(shell PKG_CONFIG_PATH=$(PKG_CONFIG_PATH) pkg-config --libs-only-l --libs-only-other alsa)
AUDIO_DRIVER ?= alsa
endif

TARGET = jukebox
## TARGET = playtrack
OBJS = $(TARGET).o appkey.o $(AUDIO_DRIVER)-audio.o audio.o

$(TARGET): $(OBJS)
	$(CC) $(CFLAGS) $(LDFLAGS) $^ -o $@ $(LDLIBS)
ifdef DEBUG
ifeq ($(shell uname),Darwin)
	install_name_tool -change @loader_path/../Frameworks/libspotify.framework/libspotify @rpath/libspotify.so $@
endif
endif

include ../common.mk



audio.o: audio.c audio.h
alsa-audio.o: alsa-audio.c audio.h
dummy-audio.o: dummy-audio.c audio.h
osx-audio.o: osx-audio.c audio.h
openal-audio.o: openal-audio.c audio.h
jukebox.o: jukebox.c audio.h
playtrack.o: playtrack.c audio.h


================================================
FILE: libspotify/examples/jukebox/alsa-audio.c
================================================
/*
 * Copyright (c) 2006-2009 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 *
 * ALSA audio output driver.
 *
 * This file is part of the libspotify examples suite.
 */

#include <asoundlib.h>
#include <errno.h>
#include <math.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <sys/time.h>

#include "audio.h"


static snd_pcm_t *alsa_open(char *dev, int rate, int channels)
{
	snd_pcm_hw_params_t *hwp;
	snd_pcm_sw_params_t *swp;
	snd_pcm_t *h;
	int r;
	int dir;
	snd_pcm_uframes_t period_size_min;
	snd_pcm_uframes_t period_size_max;
	snd_pcm_uframes_t buffer_size_min;
	snd_pcm_uframes_t buffer_size_max;
	snd_pcm_uframes_t period_size;
	snd_pcm_uframes_t buffer_size;

	if ((r = snd_pcm_open(&h, dev, SND_PCM_STREAM_PLAYBACK, 0) < 0))
		return NULL;

	hwp = alloca(snd_pcm_hw_params_sizeof());
	memset(hwp, 0, snd_pcm_hw_params_sizeof());
	snd_pcm_hw_params_any(h, hwp);

	snd_pcm_hw_params_set_access(h, hwp, SND_PCM_ACCESS_RW_INTERLEAVED);
	snd_pcm_hw_params_set_format(h, hwp, SND_PCM_FORMAT_S16_LE);
	snd_pcm_hw_params_set_rate(h, hwp, rate, 0);
	snd_pcm_hw_params_set_channels(h, hwp, channels);

	/* Configurue period */

	dir = 0;
	snd_pcm_hw_params_get_period_size_min(hwp, &period_size_min, &dir);
	dir = 0;
	snd_pcm_hw_params_get_period_size_max(hwp, &period_size_max, &dir);

	period_size = 1024;

	dir = 0;
	r = snd_pcm_hw_params_set_period_size_near(h, hwp, &period_size, &dir);

	if (r < 0) {
		fprintf(stderr, "audio: Unable to set period size %lu (%s)\n",
		        period_size, snd_strerror(r));
		snd_pcm_close(h);
		return NULL;
	}

	dir = 0;
	r = snd_pcm_hw_params_get_period_size(hwp, &period_size, &dir);

	if (r < 0) {
		fprintf(stderr, "audio: Unable to get period size (%s)\n",
		        snd_strerror(r));
		snd_pcm_close(h);
		return NULL;
	}

	/* Configurue buffer size */

	snd_pcm_hw_params_get_buffer_size_min(hwp, &buffer_size_min);
	snd_pcm_hw_params_get_buffer_size_max(hwp, &buffer_size_max);
	buffer_size = period_size * 4;

	dir = 0;
	r = snd_pcm_hw_params_set_buffer_size_near(h, hwp, &buffer_size);

	if (r < 0) {
		fprintf(stderr, "audio: Unable to set buffer size %lu (%s)\n",
		        buffer_size, snd_strerror(r));
		snd_pcm_close(h);
		return NULL;
	}

	r = snd_pcm_hw_params_get_buffer_size(hwp, &buffer_size);

	if (r < 0) {
		fprintf(stderr, "audio: Unable to get buffer size (%s)\n",
		        snd_strerror(r));
		snd_pcm_close(h);
		return NULL;
	}

	/* write the hw params */
	r = snd_pcm_hw_params(h, hwp);

	if (r < 0) {
		fprintf(stderr, "audio: Unable to configure hardware parameters (%s)\n",
		        snd_strerror(r));
		snd_pcm_close(h);
		return NULL;
	}

	/*
	 * Software parameters
	 */

	swp = alloca(snd_pcm_sw_params_sizeof());
	memset(hwp, 0, snd_pcm_sw_params_sizeof());
	snd_pcm_sw_params_current(h, swp);

	r = snd_pcm_sw_params_set_avail_min(h, swp, period_size);

	if (r < 0) {
		fprintf(stderr, "audio: Unable to configure wakeup threshold (%s)\n",
		        snd_strerror(r));
		snd_pcm_close(h);
		return NULL;
	}

	snd_pcm_sw_params_set_start_threshold(h, swp, 0);

	if (r < 0) {
		fprintf(stderr, "audio: Unable to configure start threshold (%s)\n",
		        snd_strerror(r));
		snd_pcm_close(h);
		return NULL;
	}

	r = snd_pcm_sw_params(h, swp);

	if (r < 0) {
		fprintf(stderr, "audio: Cannot set soft parameters (%s)\n",
		snd_strerror(r));
		snd_pcm_close(h);
		return NULL;
	}

	r = snd_pcm_prepare(h);
	if (r < 0) {
		fprintf(stderr, "audio: Cannot prepare audio for playback (%s)\n",
		snd_strerror(r));
		snd_pcm_close(h);
		return NULL;
	}

	return h;
}

static void* alsa_audio_start(void *aux)
{
	audio_fifo_t *af = aux;
	snd_pcm_t *h = NULL;
	int c;
	int cur_channels = 0;
	int cur_rate = 0;

	audio_fifo_data_t *afd;

	for (;;) {
		afd = audio_get(af);

		if (!h || cur_rate != afd->rate || cur_channels != afd->channels) {
			if (h) snd_pcm_close(h);

			cur_rate = afd->rate;
			cur_channels = afd->channels;

			h = alsa_open("default", cur_rate, cur_channels);

			if (!h) {
				fprintf(stderr, "Unable to open ALSA device (%d channels, %d Hz), dying\n",
				        cur_channels, cur_rate);
				exit(1);
			}
		}

		c = snd_pcm_wait(h, 1000);

		if (c >= 0)
			c = snd_pcm_avail_update(h);

		if (c == -EPIPE)
			snd_pcm_prepare(h);

		snd_pcm_writei(h, afd->samples, afd->nsamples);
		free(afd);
	}
}

void audio_init(audio_fifo_t *af)
{
	pthread_t tid;

	TAILQ_INIT(&af->q);
	af->qlen = 0;

	pthread_mutex_init(&af->mutex, NULL);
	pthread_cond_init(&af->cond, NULL);

	pthread_create(&tid, NULL, alsa_audio_start, af);
}



================================================
FILE: libspotify/examples/jukebox/audio.c
================================================
/*
 * Copyright (c) 2010 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 *
 * Audio helper functions.
 *
 * This file is part of the libspotify examples suite.
 */

#include "audio.h"
#include <stdlib.h>

audio_fifo_data_t* audio_get(audio_fifo_t *af)
{
    audio_fifo_data_t *afd;
    pthread_mutex_lock(&af->mutex);
  
    while (!(afd = TAILQ_FIRST(&af->q)))
	pthread_cond_wait(&af->cond, &af->mutex);
  
    TAILQ_REMOVE(&af->q, afd, link);
    af->qlen -= afd->nsamples;
  
    pthread_mutex_unlock(&af->mutex);
    return afd;
}

void audio_fifo_flush(audio_fifo_t *af)
{
    audio_fifo_data_t *afd;


    pthread_mutex_lock(&af->mutex);

    while((afd = TAILQ_FIRST(&af->q))) {
	TAILQ_REMOVE(&af->q, afd, link);
	free(afd);
    }

    af->qlen = 0;
    pthread_mutex_unlock(&af->mutex);
}


================================================
FILE: libspotify/examples/jukebox/audio.h
================================================
/*
 * Copyright (c) 2006-2009 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 *
 * Audio output driver.
 *
 * This file is part of the libspotify examples suite.
 */
#ifndef _JUKEBOX_AUDIO_H_
#define _JUKEBOX_AUDIO_H_

#include <pthread.h>
#include <stdint.h>
#include "queue.h"


/* --- Types --- */
typedef struct audio_fifo_data {
	TAILQ_ENTRY(audio_fifo_data) link;
	int channels;
	int rate;
	int nsamples;
	int16_t samples[0];
} audio_fifo_data_t;

typedef struct audio_fifo {
	TAILQ_HEAD(, audio_fifo_data) q;
	int qlen;
	pthread_mutex_t mutex;
	pthread_cond_t cond;
} audio_fifo_t;


/* --- Functions --- */
extern void audio_init(audio_fifo_t *af);
extern void audio_fifo_flush(audio_fifo_t *af);
audio_fifo_data_t* audio_get(audio_fifo_t *af);

#endif /* _JUKEBOX_AUDIO_H_ */


================================================
FILE: libspotify/examples/jukebox/dummy-audio.c
================================================
/*
 * Copyright (c) 2006-2009 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 *
 * ALSA audio output driver.
 *
 * This file is part of the libspotify examples suite.
 */

#include <asoundlib.h>
#include <errno.h>
#include <math.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <sys/time.h>

#include "audio.h"

static void* alsa_audio_start(void *aux)
{
	audio_fifo_t *af = aux;

	while(1)
		free(audio_get(af));
	return NULL;
}

void audio_init(audio_fifo_t *af)
{
	pthread_t tid;

	TAILQ_INIT(&af->q);
	af->qlen = 0;

	pthread_mutex_init(&af->mutex, NULL);
	pthread_cond_init(&af->cond, NULL);

	pthread_create(&tid, NULL, alsa_audio_start, af);
}




================================================
FILE: libspotify/examples/jukebox/jukebox.c
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 *
 * This example application shows parts of the playlist and player submodules.
 * It also shows another way of doing synchronization between callbacks and
 * the main thread.
 *
 * This file is part of the libspotify examples suite.
 */

#include <errno.h>
#include <libgen.h>
#include <pthread.h>
#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <sys/time.h>

#include <libspotify/api.h>

#include "audio.h"


/* --- Data --- */
/// The application key is specific to each project, and allows Spotify
/// to produce statistics on how our service is used.
extern const uint8_t g_appkey[];
/// The size of the application key.
extern const size_t g_appkey_size;

/// The output queue for audo data
static audio_fifo_t g_audiofifo;
/// Synchronization mutex for the main thread
static pthread_mutex_t g_notify_mutex;
/// Synchronization condition variable for the main thread
static pthread_cond_t g_notify_cond;
/// Synchronization variable telling the main thread to process events
static int g_notify_do;
/// Non-zero when a track has ended and the jukebox has not yet started a new one
static int g_playback_done;
/// The global session handle
static sp_session *g_sess;
/// Handle to the playlist currently being played
static sp_playlist *g_jukeboxlist;
/// Name of the playlist currently being played
const char *g_listname;
/// Remove tracks flag
static int g_remove_tracks = 0;
/// Handle to the curren track
static sp_track *g_currenttrack;
/// Index to the next track
static int g_track_index;


/**
 * Called on various events to start playback if it hasn't been started already.
 *
 * The function simply starts playing the first track of the playlist.
 */
static void try_jukebox_start(void)
{
	sp_track *t;

	if (!g_jukeboxlist)
		return;

	if (!sp_playlist_num_tracks(g_jukeboxlist)) {
		fprintf(stderr, "jukebox: No tracks in playlist. Waiting\n");
		return;
	}

	if (sp_playlist_num_tracks(g_jukeboxlist) < g_track_index) {
		fprintf(stderr, "jukebox: No more tracks in playlist. Waiting\n");
		return;
	}

	t = sp_playlist_track(g_jukeboxlist, g_track_index);

	if (g_currenttrack && t != g_currenttrack) {
		/* Someone changed the current track */
		audio_fifo_flush(&g_audiofifo);
		sp_session_player_unload(g_sess);
		g_currenttrack = NULL;
	}

	if (!t)
		return;

	if (sp_track_error(t) != SP_ERROR_OK)
		return;

	if (g_currenttrack == t)
		return;

	g_currenttrack = t;

	printf("jukebox: Now playing \"%s\"...\n", sp_track_name(t));
	fflush(stdout);

	sp_session_player_load(g_sess, t);
	sp_session_player_play(g_sess, 1);
}

/* --------------------------  PLAYLIST CALLBACKS  ------------------------- */
/**
 * Callback from libspotify, saying that a track has been added to a playlist.
 *
 * @param  pl          The playlist handle
 * @param  tracks      An array of track handles
 * @param  num_tracks  The number of tracks in the \c tracks array
 * @param  position    Where the tracks were inserted
 * @param  userdata    The opaque pointer
 */
static void tracks_added(sp_playlist *pl, sp_track * const *tracks,
                         int num_tracks, int position, void *userdata)
{
	if (pl != g_jukeboxlist)
		return;

	printf("jukebox: %d tracks were added\n", num_tracks);
	fflush(stdout);
	try_jukebox_start();
}

/**
 * Callback from libspotify, saying that a track has been added to a playlist.
 *
 * @param  pl          The playlist handle
 * @param  tracks      An array of track indices
 * @param  num_tracks  The number of tracks in the \c tracks array
 * @param  userdata    The opaque pointer
 */
static void tracks_removed(sp_playlist *pl, const int *tracks,
                           int num_tracks, void *userdata)
{
	int i, k = 0;

	if (pl != g_jukeboxlist)
		return;

	for (i = 0; i < num_tracks; ++i)
		if (tracks[i] < g_track_index)
			++k;

	g_track_index -= k;

	printf("jukebox: %d tracks were removed\n", num_tracks);
	fflush(stdout);
	try_jukebox_start();
}

/**
 * Callback from libspotify, telling when tracks have been moved around in a playlist.
 *
 * @param  pl            The playlist handle
 * @param  tracks        An array of track indices
 * @param  num_tracks    The number of tracks in the \c tracks array
 * @param  new_position  To where the tracks were moved
 * @param  userdata      The opaque pointer
 */
static void tracks_moved(sp_playlist *pl, const int *tracks,
                         int num_tracks, int new_position, void *userdata)
{
	if (pl != g_jukeboxlist)
		return;

	printf("jukebox: %d tracks were moved around\n", num_tracks);
	fflush(stdout);
	try_jukebox_start();
}

/**
 * Callback from libspotify. Something renamed the playlist.
 *
 * @param  pl            The playlist handle
 * @param  userdata      The opaque pointer
 */
static void playlist_renamed(sp_playlist *pl, void *userdata)
{
	const char *name = sp_playlist_name(pl);

	if (!strcasecmp(name, g_listname)) {
		g_jukeboxlist = pl;
		g_track_index = 0;
		try_jukebox_start();
	} else if (g_jukeboxlist == pl) {
		printf("jukebox: current playlist renamed to \"%s\".\n", name);
		g_jukeboxlist = NULL;
		g_currenttrack = NULL;
		sp_session_player_unload(g_sess);
	}
}

/**
 * The callbacks we are interested in for individual playlists.
 */
static sp_playlist_callbacks pl_callbacks = {
	.tracks_added = &tracks_added,
	.tracks_removed = &tracks_removed,
	.tracks_moved = &tracks_moved,
	.playlist_renamed = &playlist_renamed,
};


/* --------------------  PLAYLIST CONTAINER CALLBACKS  --------------------- */
/**
 * Callback from libspotify, telling us a playlist was added to the playlist container.
 *
 * We add our playlist callbacks to the newly added playlist.
 *
 * @param  pc            The playlist container handle
 * @param  pl            The playlist handle
 * @param  position      Index of the added playlist
 * @param  userdata      The opaque pointer
 */
static void playlist_added(sp_playlistcontainer *pc, sp_playlist *pl,
                           int position, void *userdata)
{
	sp_playlist_add_callbacks(pl, &pl_callbacks, NULL);

	if (!strcasecmp(sp_playlist_name(pl), g_listname)) {
		g_jukeboxlist = pl;
		try_jukebox_start();
	}
}

/**
 * Callback from libspotify, telling us a playlist was removed from the playlist container.
 *
 * This is the place to remove our playlist callbacks.
 *
 * @param  pc            The playlist container handle
 * @param  pl            The playlist handle
 * @param  position      Index of the removed playlist
 * @param  userdata      The opaque pointer
 */
static void playlist_removed(sp_playlistcontainer *pc, sp_playlist *pl,
                             int position, void *userdata)
{
	sp_playlist_remove_callbacks(pl, &pl_callbacks, NULL);
}


/**
 * Callback from libspotify, telling us the rootlist is fully synchronized
 * We just print an informational message
 *
 * @param  pc            The playlist container handle
 * @param  userdata      The opaque pointer
 */
static void container_loaded(sp_playlistcontainer *pc, void *userdata)
{
	fprintf(stderr, "jukebox: Rootlist synchronized (%d playlists)\n",
	    sp_playlistcontainer_num_playlists(pc));
}


/**
 * The playlist container callbacks
 */
static sp_playlistcontainer_callbacks pc_callbacks = {
	.playlist_added = &playlist_added,
	.playlist_removed = &playlist_removed,
	.container_loaded = &container_loaded,
};


/* ---------------------------  SESSION CALLBACKS  ------------------------- */
/**
 * This callback is called when an attempt to login has succeeded or failed.
 *
 * @sa sp_session_callbacks#logged_in
 */
static void logged_in(sp_session *sess, sp_error error)
{
	sp_playlistcontainer *pc = sp_session_playlistcontainer(sess);
	int i;

	if (SP_ERROR_OK != error) {
		fprintf(stderr, "jukebox: Login failed: %s\n",
			sp_error_message(error));
		exit(2);
	}

	sp_playlistcontainer_add_callbacks(
		pc,
		&pc_callbacks,
		NULL);

	printf("jukebox: Looking at %d playlists\n", sp_playlistcontainer_num_playlists(pc));

	for (i = 0; i < sp_playlistcontainer_num_playlists(pc); ++i) {
		sp_playlist *pl = sp_playlistcontainer_playlist(pc, i);

		sp_playlist_add_callbacks(pl, &pl_callbacks, NULL);

		if (!strcasecmp(sp_playlist_name(pl), g_listname)) {
			g_jukeboxlist = pl;
			try_jukebox_start();
		}
	}

	if (!g_jukeboxlist) {
		printf("jukebox: No such playlist. Waiting for one to pop up...\n");
		fflush(stdout);
	}
}

/**
 * This callback is called from an internal libspotify thread to ask us to
 * reiterate the main loop.
 *
 * We notify the main thread using a condition variable and a protected variable.
 *
 * @sa sp_session_callbacks#notify_main_thread
 */
static void notify_main_thread(sp_session *sess)
{
	pthread_mutex_lock(&g_notify_mutex);
	g_notify_do = 1;
	pthread_cond_signal(&g_notify_cond);
	pthread_mutex_unlock(&g_notify_mutex);
}

/**
 * This callback is used from libspotify whenever there is PCM data available.
 *
 * @sa sp_session_callbacks#music_delivery
 */
static int music_delivery(sp_session *sess, const sp_audioformat *format,
                          const void *frames, int num_frames)
{
	audio_fifo_t *af = &g_audiofifo;
	audio_fifo_data_t *afd;
	size_t s;

	if (num_frames == 0)
		return 0; // Audio discontinuity, do nothing

	pthread_mutex_lock(&af->mutex);

	/* Buffer one second of audio */
	if (af->qlen > format->sample_rate) {
		pthread_mutex_unlock(&af->mutex);

		return 0;
	}

	s = num_frames * sizeof(int16_t) * format->channels;

	afd = malloc(sizeof(*afd) + s);
	memcpy(afd->samples, frames, s);

	afd->nsamples = num_frames;

	afd->rate = format->sample_rate;
	afd->channels = format->channels;

	TAILQ_INSERT_TAIL(&af->q, afd, link);
	af->qlen += num_frames;

	pthread_cond_signal(&af->cond);
	pthread_mutex_unlock(&af->mutex);

	return num_frames;
}


/**
 * This callback is used from libspotify when the current track has ended
 *
 * @sa sp_session_callbacks#end_of_track
 */
static void end_of_track(sp_session *sess)
{
	pthread_mutex_lock(&g_notify_mutex);
	g_playback_done = 1;
	g_notify_do = 1;
	pthread_cond_signal(&g_notify_cond);
	pthread_mutex_unlock(&g_notify_mutex);
}


/**
 * Callback called when libspotify has new metadata available
 *
 * Not used in this example (but available to be able to reuse the session.c file
 * for other examples.)
 *
 * @sa sp_session_callbacks#metadata_updated
 */
static void metadata_updated(sp_session *sess)
{
	try_jukebox_start();
}

/**
 * Notification that some other connection has started playing on this account.
 * Playback has been stopped.
 *
 * @sa sp_session_callbacks#play_token_lost
 */
static void play_token_lost(sp_session *sess)
{
	audio_fifo_flush(&g_audiofifo);

	if (g_currenttrack != NULL) {
		sp_session_player_unload(g_sess);
		g_currenttrack = NULL;
	}
}

/**
 * The session callbacks
 */
static sp_session_callbacks session_callbacks = {
	.logged_in = &logged_in,
	.notify_main_thread = &notify_main_thread,
	.music_delivery = &music_delivery,
	.metadata_updated = &metadata_updated,
	.play_token_lost = &play_token_lost,
	.log_message = NULL,
	.end_of_track = &end_of_track,
};

/**
 * The session configuration. Note that application_key_size is an external, so
 * we set it in main() instead.
 */
static sp_session_config spconfig = {
	.api_version = SPOTIFY_API_VERSION,
	.cache_location = "tmp",
	.settings_location = "tmp",
	.application_key = g_appkey,
	.application_key_size = 0, // Set in main()
	.user_agent = "spotify-jukebox-example",
	.callbacks = &session_callbacks,
	NULL,
};
/* -------------------------  END SESSION CALLBACKS  ----------------------- */


/**
 * A track has ended. Remove it from the playlist.
 *
 * Called from the main loop when the music_delivery() callback has set g_playback_done.
 */
static void track_ended(void)
{
	int tracks = 0;

	if (g_currenttrack) {
		g_currenttrack = NULL;
		sp_session_player_unload(g_sess);
		if (g_remove_tracks) {
			sp_playlist_remove_tracks(g_jukeboxlist, &tracks, 1);
		} else {
			++g_track_index;
			try_jukebox_start();
		}
	}
}

/**
 * Show usage information
 *
 * @param  progname  The program name
 */
static void usage(const char *progname)
{
	fprintf(stderr, "usage: %s -u <username> -p <password> -l <listname> [-d]\n", progname);
	fprintf(stderr, "warning: -d will delete the tracks played from the list!\n");
}

int main(int argc, char **argv)
{
	sp_session *sp;
	sp_error err;
	int next_timeout = 0;
	const char *username = NULL;
	const char *password = NULL;
	int opt;

	while ((opt = getopt(argc, argv, "u:p:l:d")) != EOF) {
		switch (opt) {
		case 'u':
			username = optarg;
			break;

		case 'p':
			password = optarg;
			break;

		case 'l':
			g_listname = optarg;
			break;

		case 'd':
			g_remove_tracks = 1;
			break;

		default:
			exit(1);
		}
	}

	if (!username || !password || !g_listname) {
		usage(basename(argv[0]));
		exit(1);
	}

	audio_init(&g_audiofifo);

	/* Create session */
	spconfig.application_key_size = g_appkey_size;

	err = sp_session_create(&spconfig, &sp);

	if (SP_ERROR_OK != err) {
		fprintf(stderr, "Unable to create session: %s\n",
			sp_error_message(err));
		exit(1);
	}

	g_sess = sp;

	pthread_mutex_init(&g_notify_mutex, NULL);
	pthread_cond_init(&g_notify_cond, NULL);

	sp_session_login(sp, username, password, 0, NULL);
	pthread_mutex_lock(&g_notify_mutex);

	for (;;) {
		if (next_timeout == 0) {
			while(!g_notify_do)
				pthread_cond_wait(&g_notify_cond, &g_notify_mutex);
		} else {
			struct timespec ts;

#if _POSIX_TIMERS > 0
			clock_gettime(CLOCK_REALTIME, &ts);
#else
			struct timeval tv;
			gettimeofday(&tv, NULL);
			TIMEVAL_TO_TIMESPEC(&tv, &ts);
#endif
			ts.tv_sec += next_timeout / 1000;
			ts.tv_nsec += (next_timeout % 1000) * 1000000;

			pthread_cond_timedwait(&g_notify_cond, &g_notify_mutex, &ts);
		}

		g_notify_do = 0;
		pthread_mutex_unlock(&g_notify_mutex);

		if (g_playback_done) {
			track_ended();
			g_playback_done = 0;
		}

		do {
			sp_session_process_events(sp, &next_timeout);
		} while (next_timeout == 0);

		pthread_mutex_lock(&g_notify_mutex);
	}

	return 0;
}


================================================
FILE: libspotify/examples/jukebox/openal-audio.c
================================================
/*
 * Copyright (c) 2010 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 *
 * OpenAL audio output driver.
 *
 * This file is part of the libspotify examples suite.
 */

#include <OpenAL/al.h>
#include <OpenAL/alc.h>
#include <errno.h>
#include <math.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <sys/time.h>

#include "audio.h"

#define NUM_BUFFERS 3

static void error_exit(const char *msg)
{
    puts(msg);
    exit(1);
}

static int queue_buffer(ALuint source, audio_fifo_t *af, ALuint buffer)
{
    audio_fifo_data_t *afd = audio_get(af);
    alBufferData(buffer, 
		 afd->channels == 1 ? AL_FORMAT_MONO16 : AL_FORMAT_STEREO16, 
		 afd->samples, 
		 afd->nsamples * afd->channels * sizeof(short), 
		 afd->rate);
    alSourceQueueBuffers(source, 1, &buffer);
	free(afd);
	return 1;
}

static void* audio_start(void *aux)
{
	audio_fifo_t *af = aux;
    audio_fifo_data_t *afd;
	unsigned int frame = 0;
	ALCdevice *device = NULL;
	ALCcontext *context = NULL;
	ALuint buffers[NUM_BUFFERS];
	ALuint source;
	ALint processed;
	ALenum error;
	ALint rate;
	ALint channels;
	device = alcOpenDevice(NULL); /* Use the default device */
	if (!device) error_exit("failed to open device");
	context = alcCreateContext(device, NULL);
	alcMakeContextCurrent(context);
	alListenerf(AL_GAIN, 1.0f);
	alDistanceModel(AL_NONE);
	alGenBuffers((ALsizei)NUM_BUFFERS, buffers);
	alGenSources(1, &source);

	/* First prebuffer some audio */
	queue_buffer(source, af, buffers[0]);
	queue_buffer(source, af, buffers[1]);
	queue_buffer(source, af, buffers[2]);
	for (;;) {
      
		alSourcePlay(source);
		for (;;) {
			/* Wait for some audio to play */
			do {
				alGetSourcei(source, AL_BUFFERS_PROCESSED, &processed);
				usleep(100);
			} while (!processed);
			
			/* Remove old audio from the queue.. */
			alSourceUnqueueBuffers(source, 1, &buffers[frame % 3]);
			
			/* and queue some more audio */
			afd = audio_get(af);
			alGetBufferi(buffers[frame % 3], AL_FREQUENCY, &rate);
			alGetBufferi(buffers[frame % 3], AL_CHANNELS, &channels);
			if (afd->rate != rate || afd->channels != channels) {
				printf("rate or channel count changed, resetting\n");
                                free(afd);
				break;
			}
			alBufferData(buffers[frame % 3], 
						 afd->channels == 1 ? AL_FORMAT_MONO16 : AL_FORMAT_STEREO16, 
						 afd->samples, 
						 afd->nsamples * afd->channels * sizeof(short), 
						 afd->rate);
                        free(afd);
			alSourceQueueBuffers(source, 1, &buffers[frame % 3]);
			
			if ((error = alcGetError(device)) != AL_NO_ERROR) {
				printf("openal al error: %d\n", error);
				exit(1);
			}
			frame++;
		}
		/* Format or rate changed, so we need to reset all buffers */
		alSourcei(source, AL_BUFFER, 0);
		alSourceStop(source);

		/* Make sure we don't lose the audio packet that caused the change */
		alBufferData(buffers[0], 
					 afd->channels == 1 ? AL_FORMAT_MONO16 : AL_FORMAT_STEREO16, 
					 afd->samples, 
					 afd->nsamples * afd->channels * sizeof(short), 
					 afd->rate);

		alSourceQueueBuffers(source, 1, &buffers[0]);
		queue_buffer(source, af, buffers[1]);
		queue_buffer(source, af, buffers[2]);
		frame = 0;
	}
}

void audio_init(audio_fifo_t *af)
{
    pthread_t tid;

    TAILQ_INIT(&af->q);
    af->qlen = 0;

    pthread_mutex_init(&af->mutex, NULL);
    pthread_cond_init(&af->cond, NULL);

    pthread_create(&tid, NULL, audio_start, af);
}




================================================
FILE: libspotify/examples/jukebox/osx/jukebox.xcodeproj/project.pbxproj
================================================
// !$*UTF8*$!
{
	archiveVersion = 1;
	classes = {
	};
	objectVersion = 45;
	objects = {

/* Begin PBXBuildFile section */
		CF61ED9F115B641D00443233 /* appkey.c in Sources */ = {isa = PBXBuildFile; fileRef = CF61ED99115B641D00443233 /* appkey.c */; };
		CF61EDA0115B641D00443233 /* audio.c in Sources */ = {isa = PBXBuildFile; fileRef = CF61ED9A115B641D00443233 /* audio.c */; };
		CF61EDA1115B641D00443233 /* jukebox.c in Sources */ = {isa = PBXBuildFile; fileRef = CF61ED9C115B641D00443233 /* jukebox.c */; };
		CF61EDA2115B641D00443233 /* openal-audio.c in Sources */ = {isa = PBXBuildFile; fileRef = CF61ED9D115B641D00443233 /* openal-audio.c */; };
		CF61EDA6115B644A00443233 /* libspotify.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = CF61EDA5115B644A00443233 /* libspotify.framework */; };
		CF61EDB0115B647B00443233 /* OpenAL.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = CF61EDAF115B647B00443233 /* OpenAL.framework */; };
/* End PBXBuildFile section */

/* Begin PBXFileReference section */
		8DD76FB20486AB0100D96B5E /* jukebox */ = {isa = PBXFileReference; explicitFileType = "compiled.mach-o.executable"; includeInIndex = 0; path = jukebox; sourceTree = BUILT_PRODUCTS_DIR; };
		CF61ED99115B641D00443233 /* appkey.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; name = appkey.c; path = ../../appkey.c; sourceTree = SOURCE_ROOT; };
		CF61ED9A115B641D00443233 /* audio.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; name = audio.c; path = ../audio.c; sourceTree = SOURCE_ROOT; };
		CF61ED9B115B641D00443233 /* audio.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = audio.h; path = ../audio.h; sourceTree = SOURCE_ROOT; };
		CF61ED9C115B641D00443233 /* jukebox.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; name = jukebox.c; path = ../jukebox.c; sourceTree = SOURCE_ROOT; };
		CF61ED9D115B641D00443233 /* openal-audio.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; name = "openal-audio.c"; path = "../openal-audio.c"; sourceTree = SOURCE_ROOT; };
		CF61ED9E115B641D00443233 /* queue.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = queue.h; path = ../queue.h; sourceTree = SOURCE_ROOT; };
		CF61EDA5115B644A00443233 /* libspotify.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = libspotify.framework; path = /Library/Frameworks/libspotify.framework; sourceTree = "<absolute>"; };
		CF61EDAF115B647B00443233 /* OpenAL.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = OpenAL.framework; path = System/Library/Frameworks/OpenAL.framework; sourceTree = SDKROOT; };
/* End PBXFileReference section */

/* Begin PBXFrameworksBuildPhase section */
		8DD76FAD0486AB0100D96B5E /* Frameworks */ = {
			isa = PBXFrameworksBuildPhase;
			buildActionMask = 2147483647;
			files = (
				CF61EDA6115B644A00443233 /* libspotify.framework in Frameworks */,
				CF61EDB0115B647B00443233 /* OpenAL.framework in Frameworks */,
			);
			runOnlyForDeploymentPostprocessing = 0;
		};
/* End PBXFrameworksBuildPhase section */

/* Begin PBXGroup section */
		08FB7794FE84155DC02AAC07 /* jukebox */ = {
			isa = PBXGroup;
			children = (
				08FB7795FE84155DC02AAC07 /* Source */,
				1AB674ADFE9D54B511CA2CBB /* Products */,
				CF61EDA5115B644A00443233 /* libspotify.framework */,
				CF61EDAF115B647B00443233 /* OpenAL.framework */,
			);
			name = jukebox;
			sourceTree = "<group>";
		};
		08FB7795FE84155DC02AAC07 /* Source */ = {
			isa = PBXGroup;
			children = (
				CF61ED99115B641D00443233 /* appkey.c */,
				CF61ED9A115B641D00443233 /* audio.c */,
				CF61ED9B115B641D00443233 /* audio.h */,
				CF61ED9C115B641D00443233 /* jukebox.c */,
				CF61ED9D115B641D00443233 /* openal-audio.c */,
				CF61ED9E115B641D00443233 /* queue.h */,
			);
			name = Source;
			sourceTree = "<group>";
		};
		1AB674ADFE9D54B511CA2CBB /* Products */ = {
			isa = PBXGroup;
			children = (
				8DD76FB20486AB0100D96B5E /* jukebox */,
			);
			name = Products;
			sourceTree = "<group>";
		};
/* End PBXGroup section */

/* Begin PBXNativeTarget section */
		8DD76FA90486AB0100D96B5E /* jukebox */ = {
			isa = PBXNativeTarget;
			buildConfigurationList = 1DEB928508733DD80010E9CD /* Build configuration list for PBXNativeTarget "jukebox" */;
			buildPhases = (
				057527F21163423F003FFC9D /* ShellScript */,
				8DD76FAB0486AB0100D96B5E /* Sources */,
				8DD76FAD0486AB0100D96B5E /* Frameworks */,
				0575280B11634840003FFC9D /* ShellScript */,
			);
			buildRules = (
			);
			dependencies = (
			);
			name = jukebox;
			productInstallPath = "$(HOME)/bin";
			productName = jukebox;
			productReference = 8DD76FB20486AB0100D96B5E /* jukebox */;
			productType = "com.apple.product-type.tool";
		};
/* End PBXNativeTarget section */

/* Begin PBXProject section */
		08FB7793FE84155DC02AAC07 /* Project object */ = {
			isa = PBXProject;
			buildConfigurationList = 1DEB928908733DD80010E9CD /* Build configuration list for PBXProject "jukebox" */;
			compatibilityVersion = "Xcode 3.1";
			hasScannedForEncodings = 1;
			mainGroup = 08FB7794FE84155DC02AAC07 /* jukebox */;
			projectDirPath = "";
			projectRoot = "";
			targets = (
				8DD76FA90486AB0100D96B5E /* jukebox */,
			);
		};
/* End PBXProject section */

/* Begin PBXShellScriptBuildPhase section */
		057527F21163423F003FFC9D /* ShellScript */ = {
			isa = PBXShellScriptBuildPhase;
			buildActionMask = 2147483647;
			files = (
			);
			inputPaths = (
			);
			outputPaths = (
			);
			runOnlyForDeploymentPostprocessing = 0;
			shellPath = /bin/bash;
			shellScript = "if [ ! -e /Library/Frameworks/libspotify.framework ]; then\n  echo \"You must install libspotify.framework to /Library/Frameworks.\" >&2\n  exit 1\nfi\n\nexit 0";
		};
		0575280B11634840003FFC9D /* ShellScript */ = {
			isa = PBXShellScriptBuildPhase;
			buildActionMask = 2147483647;
			files = (
			);
			inputPaths = (
			);
			outputPaths = (
			);
			runOnlyForDeploymentPostprocessing = 0;
			shellPath = /bin/sh;
			shellScript = "install_name_tool -change @loader_path/../Frameworks/libspotify.framework/libspotify /Library/Frameworks/libspotify.framework/libspotify $CONFIGURATION_BUILD_DIR/$EXECUTABLE_PATH";
			showEnvVarsInLog = 0;
		};
/* End PBXShellScriptBuildPhase section */

/* Begin PBXSourcesBuildPhase section */
		8DD76FAB0486AB0100D96B5E /* Sources */ = {
			isa = PBXSourcesBuildPhase;
			buildActionMask = 2147483647;
			files = (
				CF61ED9F115B641D00443233 /* appkey.c in Sources */,
				CF61EDA0115B641D00443233 /* audio.c in Sources */,
				CF61EDA1115B641D00443233 /* jukebox.c in Sources */,
				CF61EDA2115B641D00443233 /* openal-audio.c in Sources */,
			);
			runOnlyForDeploymentPostprocessing = 0;
		};
/* End PBXSourcesBuildPhase section */

/* Begin XCBuildConfiguration section */
		1DEB928608733DD80010E9CD /* Debug */ = {
			isa = XCBuildConfiguration;
			buildSettings = {
				ALWAYS_SEARCH_USER_PATHS = NO;
				COPY_PHASE_STRIP = NO;
				FRAMEWORK_SEARCH_PATHS = (
					"$(inherited)",
					"\"$(SRCROOT)/../../../..\"",
				);
				GCC_DYNAMIC_NO_PIC = NO;
				GCC_ENABLE_FIX_AND_CONTINUE = YES;
				GCC_MODEL_TUNING = G5;
				GCC_OPTIMIZATION_LEVEL = 0;
				INSTALL_PATH = /usr/local/bin;
				PRODUCT_NAME = jukebox;
			};
			name = Debug;
		};
		1DEB928708733DD80010E9CD /* Release */ = {
			isa = XCBuildConfiguration;
			buildSettings = {
				ALWAYS_SEARCH_USER_PATHS = NO;
				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
				FRAMEWORK_SEARCH_PATHS = (
					"$(inherited)",
					"\"$(SRCROOT)/../../..\"",
				);
				GCC_MODEL_TUNING = G5;
				INSTALL_PATH = /usr/local/bin;
				PRODUCT_NAME = jukebox;
			};
			name = Release;
		};
		1DEB928A08733DD80010E9CD /* Debug */ = {
			isa = XCBuildConfiguration;
			buildSettings = {
				ARCHS = "$(ARCHS_STANDARD_32_64_BIT)";
				GCC_C_LANGUAGE_STANDARD = gnu99;
				GCC_OPTIMIZATION_LEVEL = 0;
				GCC_WARN_ABOUT_RETURN_TYPE = YES;
				GCC_WARN_UNUSED_VARIABLE = YES;
				ONLY_ACTIVE_ARCH = YES;
				PREBINDING = NO;
				SDKROOT = macosx10.6;
			};
			name = Debug;
		};
		1DEB928B08733DD80010E9CD /* Release */ = {
			isa = XCBuildConfiguration;
			buildSettings = {
				ARCHS = "$(ARCHS_STANDARD_32_64_BIT)";
				GCC_C_LANGUAGE_STANDARD = gnu99;
				GCC_WARN_ABOUT_RETURN_TYPE = YES;
				GCC_WARN_UNUSED_VARIABLE = YES;
				PREBINDING = NO;
				SDKROOT = macosx10.6;
			};
			name = Release;
		};
/* End XCBuildConfiguration section */

/* Begin XCConfigurationList section */
		1DEB928508733DD80010E9CD /* Build configuration list for PBXNativeTarget "jukebox" */ = {
			isa = XCConfigurationList;
			buildConfigurations = (
				1DEB928608733DD80010E9CD /* Debug */,
				1DEB928708733DD80010E9CD /* Release */,
			);
			defaultConfigurationIsVisible = 0;
			defaultConfigurationName = Release;
		};
		1DEB928908733DD80010E9CD /* Build configuration list for PBXProject "jukebox" */ = {
			isa = XCConfigurationList;
			buildConfigurations = (
				1DEB928A08733DD80010E9CD /* Debug */,
				1DEB928B08733DD80010E9CD /* Release */,
			);
			defaultConfigurationIsVisible = 0;
			defaultConfigurationName = Release;
		};
/* End XCConfigurationList section */
	};
	rootObject = 08FB7793FE84155DC02AAC07 /* Project object */;
}


================================================
FILE: libspotify/examples/jukebox/osx-audio.c
================================================
/*
 * Copyright (c) 2010 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 *
 * OSX AudioQueue output driver.
 *
 * This file is part of the libspotify examples suite.
 */

#include <AudioToolbox/AudioQueue.h>
#include "audio.h"

#define BUFFER_COUNT 7
static struct AQPlayerState {
    AudioStreamBasicDescription   desc;
    AudioQueueRef                 queue;
    AudioQueueBufferRef           buffers[BUFFER_COUNT];
    unsigned buffer_size;
} state;

static void audio_callback (void *aux, AudioQueueRef aq, AudioQueueBufferRef bufout)
{
    audio_fifo_t *af = aux;
    audio_fifo_data_t *afd = audio_get(af);

    bufout->mAudioDataByteSize = afd->nsamples * sizeof(short) * afd->channels;

    assert(bufout->mAudioDataByteSize <= state.buffer_size);
    memcpy(bufout->mAudioData, afd->samples, bufout->mAudioDataByteSize);

    AudioQueueEnqueueBuffer(state.queue, bufout, 0, NULL);
    free(afd);
}

static const int kSampleCountPerBuffer = 2048;

void audio_init(audio_fifo_t *af)
{
    int i;
    TAILQ_INIT(&af->q);
    af->qlen = 0;

    pthread_mutex_init(&af->mutex, NULL);
    pthread_cond_init(&af->cond, NULL);

    bzero(&state, sizeof(state));

    state.desc.mFormatID = kAudioFormatLinearPCM;
    state.desc.mFormatFlags = kAudioFormatFlagIsSignedInteger	| kAudioFormatFlagIsPacked;
    state.desc.mSampleRate = 44100;
    state.desc.mChannelsPerFrame = 2;
    state.desc.mFramesPerPacket = 1;
    state.desc.mBytesPerFrame = sizeof(short) * state.desc.mChannelsPerFrame;
    state.desc.mBytesPerPacket = state.desc.mBytesPerFrame;
    state.desc.mBitsPerChannel = (state.desc.mBytesPerFrame*8)/state.desc.mChannelsPerFrame;
    state.desc.mReserved = 0;

    state.buffer_size = state.desc.mBytesPerFrame * kSampleCountPerBuffer;

    if (noErr != AudioQueueNewOutput(&state.desc, audio_callback, af, NULL, NULL, 0, &state.queue)) {
	printf("audioqueue error\n");
	return;
    }

    // Start some empty playback so we'll get the callbacks that fill in the actual audio.
    for (i = 0; i < BUFFER_COUNT; ++i) {
		AudioQueueAllocateBuffer(state.queue, state.buffer_size, &state.buffers[i]);
		state.buffers[i]->mAudioDataByteSize = state.buffer_size;
		AudioQueueEnqueueBuffer(state.queue, state.buffers[i], 0, NULL);
    }
    if (noErr != AudioQueueStart(state.queue, NULL)) puts("AudioQueueStart failed");
}



================================================
FILE: libspotify/examples/jukebox/playtrack.c
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 *
 * This example application is the most minimal way to just play a spotify URI.
 *
 * This file is part of the libspotify examples suite.
 */

#include <errno.h>
#include <libgen.h>
#include <pthread.h>
#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <sys/time.h>

#include <libspotify/api.h>

#include "audio.h"


/* --- Data --- */
/// The application key is specific to each project, and allows Spotify
/// to produce statistics on how our service is used.
extern const uint8_t g_appkey[];
/// The size of the application key.
extern const size_t g_appkey_size;

/// The output queue for audo data
static audio_fifo_t g_audiofifo;
/// Synchronization mutex for the main thread
static pthread_mutex_t g_notify_mutex;
/// Synchronization condition variable for the main thread
static pthread_cond_t g_notify_cond;
/// Synchronization variable telling the main thread to process events
static int g_notify_do;
/// Non-zero when a track has ended and the jukebox has not yet started a new one
static int g_playback_done;
/// The global session handle
static sp_session *g_sess;
/// Handle to the curren track
static sp_track *g_currenttrack;

/* ---------------------------  SESSION CALLBACKS  ------------------------- */
/**
 * This callback is called when an attempt to login has succeeded or failed.
 *
 * @sa sp_session_callbacks#logged_in
 */
static void logged_in(sp_session *sess, sp_error error)
{
	sp_link *link;

	if (SP_ERROR_OK != error) {
		fprintf(stderr, "Login failed: %s\n",
			sp_error_message(error));
		exit(2);
	}

	printf("Loading track\n");
	link = sp_link_create_from_string("spotify:track:5W3cjX2J3tjhG8zb6u0qHn");
        sp_track_add_ref(g_currenttrack = sp_link_as_track(link));
	sp_link_release(link);

	if (sp_track_error(g_currenttrack) == SP_ERROR_OK) {
		printf("Now playing \"%s\"...\n", sp_track_name(g_currenttrack));
		fflush(stdout);
		
		sp_session_player_load(g_sess, g_currenttrack);
		sp_session_player_play(g_sess, 1);
        }

	/* Track not loaded? Then we need to wait for the metadata to
           load before we can start playback (see below) */
}

/**
 * Callback called when libspotify has new metadata available
 *
 * @sa sp_session_callbacks#metadata_updated
 */
static void metadata_updated(sp_session *sess)
{
	puts("Metadata updated, trying to start playback");

	if (sp_track_error(g_currenttrack) != SP_ERROR_OK)
		return;

	printf("Now playing \"%s\"...\n", sp_track_name(g_currenttrack));
	fflush(stdout);

	sp_session_player_load(g_sess, g_currenttrack);
	sp_session_player_play(g_sess, 1);
}

/**
 * This callback is called from an internal libspotify thread to ask
 * us to reiterate the main loop.
 *
 * We notify the main thread using a condition variable and a protected variable.
 *
 * @sa sp_session_callbacks#notify_main_thread
 */
static void notify_main_thread(sp_session *sess)
{
	pthread_mutex_lock(&g_notify_mutex);
	g_notify_do = 1;
	pthread_cond_signal(&g_notify_cond);
	pthread_mutex_unlock(&g_notify_mutex);
}

/**
 * This callback is used from libspotify whenever there is PCM data available.
 *
 * @sa sp_session_callbacks#music_delivery
 */
static int music_delivery(sp_session *sess, const sp_audioformat *format,
                          const void *frames, int num_frames)
{
	audio_fifo_t *af = &g_audiofifo;
	audio_fifo_data_t *afd;
	size_t s;

	if (num_frames == 0)
		return 0; // Audio discontinuity, do nothing

	pthread_mutex_lock(&af->mutex);

	/* Buffer one second of audio */
	if (af->qlen > format->sample_rate) {
		pthread_mutex_unlock(&af->mutex);

		return 0;
	}

	s = num_frames * sizeof(int16_t) * format->channels;

	afd = malloc(sizeof(audio_fifo_data_t) + s);
	memcpy(afd->samples, frames, s);

	afd->nsamples = num_frames;

	afd->rate = format->sample_rate;
	afd->channels = format->channels;

	TAILQ_INSERT_TAIL(&af->q, afd, link);
	af->qlen += num_frames;

	pthread_cond_signal(&af->cond);
	pthread_mutex_unlock(&af->mutex);

	return num_frames;
}


/**
 * This callback is used from libspotify when the current track has ended
 *
 * @sa sp_session_callbacks#end_of_track
 */
static void end_of_track(sp_session *sess)
{
	pthread_mutex_lock(&g_notify_mutex);
	g_playback_done = 1;
	pthread_cond_signal(&g_notify_cond);
	pthread_mutex_unlock(&g_notify_mutex);
}

/**
 * Notification that some other connection has started playing on this account.
 * Playback has been stopped.
 *
 * @sa sp_session_callbacks#play_token_lost
 */
static void play_token_lost(sp_session *sess)
{
	audio_fifo_flush(&g_audiofifo);

	if (g_currenttrack != NULL) {
		sp_session_player_unload(g_sess);
		g_currenttrack = NULL;
	}
}

static void log_message(sp_session *session, const char *msg)
{
	puts(msg);
}

/**
 * The session callbacks
 */
static sp_session_callbacks session_callbacks = {
	.logged_in = &logged_in,
	.notify_main_thread = &notify_main_thread,
	.music_delivery = &music_delivery,
	.metadata_updated = &metadata_updated,
	.play_token_lost = &play_token_lost,
	.log_message = &log_message,
	.end_of_track = &end_of_track,
};

/**
 * The session configuration. Note that application_key_size is an
 * external, so we set it in main() instead.
 */
static sp_session_config spconfig = {
	.api_version = SPOTIFY_API_VERSION,
	.cache_location = "tmp",
	.settings_location = "tmp",
	.application_key = g_appkey,
	.application_key_size = 0, // Set in main()
	.user_agent = "spotify-playtrack-example",
	.callbacks = &session_callbacks,
	NULL,
};
/* -------------------------  END SESSION CALLBACKS  ----------------------- */


/**
 * A track has ended. Remove it from the playlist.
 *
 * Called from the main loop when the music_delivery() callback has set g_playback_done.
 */
static void track_ended(void)
{
	if (g_currenttrack) {
		sp_track_release(g_currenttrack);
		g_currenttrack = NULL;
		sp_session_player_unload(g_sess);
		exit(0);
	}
}

/**
 * Show usage information
 *
 * @param  progname  The program name
 */
static void usage(const char *progname)
{
	fprintf(stderr, "usage: %s -u <username> -p <password>\n", progname);
}

int main(int argc, char **argv)
{
	sp_session *sp;
	sp_error err;
	int next_timeout = 0;
	const char *username = NULL;
	const char *password = NULL;
	int opt;

	while ((opt = getopt(argc, argv, "u:p:")) != EOF) {
		switch (opt) {
		case 'u':
			username = optarg;
			break;
		case 'p':
			password = optarg;
			break;
		default:
			exit(1);
		}
	}

	if (!username || !password) {
		usage(basename(argv[0]));
		exit(1);
	}

	audio_init(&g_audiofifo);

	/* Create session */
	spconfig.application_key_size = g_appkey_size;

	err = sp_session_create(&spconfig, &sp);

	if (SP_ERROR_OK != err) {
		fprintf(stderr, "Unable to create session: %s\n",
			sp_error_message(err));
		exit(1);
	}

	g_sess = sp;

	pthread_mutex_init(&g_notify_mutex, NULL);
	pthread_cond_init(&g_notify_cond, NULL);

	sp_session_login(sp, username, password, 0, NULL);
	pthread_mutex_lock(&g_notify_mutex);

	for (;;) {
		if (next_timeout == 0) {
			while(!g_notify_do && !g_playback_done)
				pthread_cond_wait(&g_notify_cond, &g_notify_mutex);
		} else {
			struct timespec ts;

#if _POSIX_TIMERS > 0
			clock_gettime(CLOCK_REALTIME, &ts);
#else
			struct timeval tv;
			gettimeofday(&tv, NULL);
			TIMEVAL_TO_TIMESPEC(&tv, &ts);
#endif
			ts.tv_sec += next_timeout / 1000;
			ts.tv_nsec += (next_timeout % 1000) * 1000000;

			pthread_cond_timedwait(&g_notify_cond, &g_notify_mutex, &ts);
		}

		g_notify_do = 0;
		pthread_mutex_unlock(&g_notify_mutex);

		if (g_playback_done) {
			track_ended();
			g_playback_done = 0;
		}

		do {
			sp_session_process_events(sp, &next_timeout);
		} while (next_timeout == 0);

		pthread_mutex_lock(&g_notify_mutex);
	}

	return 0;
}


================================================
FILE: libspotify/examples/jukebox/queue.h
================================================
/*
 * Copyright (c) 1991, 1993
 *	The Regents of the University of California.  All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 3. Neither the name of the University nor the names of its contributors
 *    may be used to endorse or promote products derived from this software
 *    without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 *
 *	@(#)queue.h	8.5 (Berkeley) 8/20/94
 */

#ifndef	_SYS_QUEUE_H_
#define	_SYS_QUEUE_H_

/*
 * This file defines five types of data structures: singly-linked lists,
 * lists, simple queues, tail queues, and circular queues.
 *
 * A singly-linked list is headed by a single forward pointer. The
 * elements are singly linked for minimum space and pointer manipulation
 * overhead at the expense of O(n) removal for arbitrary elements. New
 * elements can be added to the list after an existing element or at the
 * head of the list.  Elements being removed from the head of the list
 * should use the explicit macro for this purpose for optimum
 * efficiency. A singly-linked list may only be traversed in the forward
 * direction.  Singly-linked lists are ideal for applications with large
 * datasets and few or no removals or for implementing a LIFO queue.
 *
 * A list is headed by a single forward pointer (or an array of forward
 * pointers for a hash table header). The elements are doubly linked
 * so that an arbitrary element can be removed without a need to
 * traverse the list. New elements can be added to the list before
 * or after an existing element or at the head of the list. A list
 * may only be traversed in the forward direction.
 *
 * A simple queue is headed by a pair of pointers, one the head of the
 * list and the other to the tail of the list. The elements are singly
 * linked to save space, so elements can only be removed from the
 * head of the list. New elements can be added to the list after
 * an existing element, at the head of the list, or at the end of the
 * list. A simple queue may only be traversed in the forward direction.
 *
 * A tail queue is headed by a pair of pointers, one to the head of the
 * list and the other to the tail of the list. The elements are doubly
 * linked so that an arbitrary element can be removed without a need to
 * traverse the list. New elements can be added to the list before or
 * after an existing element, at the head of the list, or at the end of
 * the list. A tail queue may be traversed in either direction.
 *
 * A circle queue is headed by a pair of pointers, one to the head of the
 * list and the other to the tail of the list. The elements are doubly
 * linked so that an arbitrary element can be removed without a need to
 * traverse the list. New elements can be added to the list before or after
 * an existing element, at the head of the list, or at the end of the list.
 * A circle queue may be traversed in either direction, but has a more
 * complex end of list detection.
 *
 * For details on the use of these macros, see the queue(3) manual page.
 */

/*
 * List definitions.
 */
#define	LIST_HEAD(name, type)						\
struct name {								\
	struct type *lh_first;	/* first element */			\
}

#define	LIST_HEAD_INITIALIZER(head)					\
	{ NULL }

#define	LIST_ENTRY(type)						\
struct {								\
	struct type *le_next;	/* next element */			\
	struct type **le_prev;	/* address of previous next element */	\
}

/*
 * List functions.
 */
#define	LIST_INIT(head) do {						\
	(head)->lh_first = NULL;					\
} while (/*CONSTCOND*/0)

#define	LIST_INSERT_AFTER(listelm, elm, field) do {			\
	if (((elm)->field.le_next = (listelm)->field.le_next) != NULL)	\
		(listelm)->field.le_next->field.le_prev =		\
		    &(elm)->field.le_next;				\
	(listelm)->field.le_next = (elm);				\
	(elm)->field.le_prev = &(listelm)->field.le_next;		\
} while (/*CONSTCOND*/0)

#define	LIST_INSERT_BEFORE(listelm, elm, field) do {			\
	(elm)->field.le_prev = (listelm)->field.le_prev;		\
	(elm)->field.le_next = (listelm);				\
	*(listelm)->field.le_prev = (elm);				\
	(listelm)->field.le_prev = &(elm)->field.le_next;		\
} while (/*CONSTCOND*/0)

#define	LIST_INSERT_HEAD(head, elm, field) do {				\
	if (((elm)->field.le_next = (head)->lh_first) != NULL)		\
		(head)->lh_first->field.le_prev = &(elm)->field.le_next;\
	(head)->lh_first = (elm);					\
	(elm)->field.le_prev = &(head)->lh_first;			\
} while (/*CONSTCOND*/0)

#define	LIST_REMOVE(elm, field) do {					\
	if ((elm)->field.le_next != NULL)				\
		(elm)->field.le_next->field.le_prev = 			\
		    (elm)->field.le_prev;				\
	*(elm)->field.le_prev = (elm)->field.le_next;			\
} while (/*CONSTCOND*/0)

#define	LIST_FOREACH(var, head, field)					\
	for ((var) = ((head)->lh_first);				\
		(var);							\
		(var) = ((var)->field.le_next))

/*
 * List access methods.
 */
#define	LIST_EMPTY(head)		((head)->lh_first == NULL)
#define	LIST_FIRST(head)		((head)->lh_first)
#define	LIST_NEXT(elm, field)		((elm)->field.le_next)


/*
 * Singly-linked List definitions.
 */
#define	SLIST_HEAD(name, type)						\
struct name {								\
	struct type *slh_first;	/* first element */			\
}

#define	SLIST_HEAD_INITIALIZER(head)					\
	{ NULL }

#define	SLIST_ENTRY(type)						\
struct {								\
	struct type *sle_next;	/* next element */			\
}

/*
 * Singly-linked List functions.
 */
#define	SLIST_INIT(head) do {						\
	(head)->slh_first = NULL;					\
} while (/*CONSTCOND*/0)

#define	SLIST_INSERT_AFTER(slistelm, elm, field) do {			\
	(elm)->field.sle_next = (slistelm)->field.sle_next;		\
	(slistelm)->field.sle_next = (elm);				\
} while (/*CONSTCOND*/0)

#define	SLIST_INSERT_HEAD(head, elm, field) do {			\
	(elm)->field.sle_next = (head)->slh_first;			\
	(head)->slh_first = (elm);					\
} while (/*CONSTCOND*/0)

#define	SLIST_REMOVE_HEAD(head, field) do {				\
	(head)->slh_first = (head)->slh_first->field.sle_next;		\
} while (/*CONSTCOND*/0)

#define	SLIST_REMOVE(head, elm, type, field) do {			\
	if ((head)->slh_first == (elm)) {				\
		SLIST_REMOVE_HEAD((head), field);			\
	}								\
	else {								\
		struct type *curelm = (head)->slh_first;		\
		while(curelm->field.sle_next != (elm))			\
			curelm = curelm->field.sle_next;		\
		curelm->field.sle_next =				\
		    curelm->field.sle_next->field.sle_next;		\
	}								\
} while (/*CONSTCOND*/0)

#define	SLIST_FOREACH(var, head, field)					\
	for((var) = (head)->slh_first; (var); (var) = (var)->field.sle_next)

/*
 * Singly-linked List access methods.
 */
#define	SLIST_EMPTY(head)	((head)->slh_first == NULL)
#define	SLIST_FIRST(head)	((head)->slh_first)
#define	SLIST_NEXT(elm, field)	((elm)->field.sle_next)


/*
 * Singly-linked Tail queue declarations.
 */
#define	STAILQ_HEAD(name, type)					\
struct name {								\
	struct type *stqh_first;	/* first element */			\
	struct type **stqh_last;	/* addr of last next element */		\
}

#define	STAILQ_HEAD_INITIALIZER(head)					\
	{ NULL, &(head).stqh_first }

#define	STAILQ_ENTRY(type)						\
struct {								\
	struct type *stqe_next;	/* next element */			\
}

/*
 * Singly-linked Tail queue functions.
 */
#define	STAILQ_INIT(head) do {						\
	(head)->stqh_first = NULL;					\
	(head)->stqh_last = &(head)->stqh_first;				\
} while (/*CONSTCOND*/0)

#define	STAILQ_INSERT_HEAD(head, elm, field) do {			\
	if (((elm)->field.stqe_next = (head)->stqh_first) == NULL)	\
		(head)->stqh_last = &(elm)->field.stqe_next;		\
	(head)->stqh_first = (elm);					\
} while (/*CONSTCOND*/0)

#define	STAILQ_INSERT_TAIL(head, elm, field) do {			\
	(elm)->field.stqe_next = NULL;					\
	*(head)->stqh_last = (elm);					\
	(head)->stqh_last = &(elm)->field.stqe_next;			\
} while (/*CONSTCOND*/0)

#define	STAILQ_INSERT_AFTER(head, listelm, elm, field) do {		\
	if (((elm)->field.stqe_next = (listelm)->field.stqe_next) == NULL)\
		(head)->stqh_last = &(elm)->field.stqe_next;		\
	(listelm)->field.stqe_next = (elm);				\
} while (/*CONSTCOND*/0)

#define	STAILQ_REMOVE_HEAD(head, field) do {				\
	if (((head)->stqh_first = (head)->stqh_first->field.stqe_next) == NULL) \
		(head)->stqh_last = &(head)->stqh_first;			\
} while (/*CONSTCOND*/0)

#define	STAILQ_REMOVE(head, elm, type, field) do {			\
	if ((head)->stqh_first == (elm)) {				\
		STAILQ_REMOVE_HEAD((head), field);			\
	} else {							\
		struct type *curelm = (head)->stqh_first;		\
		while (curelm->field.stqe_next != (elm))			\
			curelm = curelm->field.stqe_next;		\
		if ((curelm->field.stqe_next =				\
			curelm->field.stqe_next->field.stqe_next) == NULL) \
			    (head)->stqh_last = &(curelm)->field.stqe_next; \
	}								\
} while (/*CONSTCOND*/0)

#define	STAILQ_FOREACH(var, head, field)				\
	for ((var) = ((head)->stqh_first);				\
		(var);							\
		(var) = ((var)->field.stqe_next))

/*
 * Singly-linked Tail queue access methods.
 */
#define	STAILQ_EMPTY(head)	((head)->stqh_first == NULL)
#define	STAILQ_FIRST(head)	((head)->stqh_first)
#define	STAILQ_NEXT(elm, field)	((elm)->field.stqe_next)


/*
 * Simple queue definitions.
 */
#define	SIMPLEQ_HEAD(name, type)					\
struct name {								\
	struct type *sqh_first;	/* first element */			\
	struct type **sqh_last;	/* addr of last next element */		\
}

#define	SIMPLEQ_HEAD_INITIALIZER(head)					\
	{ NULL, &(head).sqh_first }

#define	SIMPLEQ_ENTRY(type)						\
struct {								\
	struct type *sqe_next;	/* next element */			\
}

/*
 * Simple queue functions.
 */
#define	SIMPLEQ_INIT(head) do {						\
	(head)->sqh_first = NULL;					\
	(head)->sqh_last = &(head)->sqh_first;				\
} while (/*CONSTCOND*/0)

#define	SIMPLEQ_INSERT_HEAD(head, elm, field) do {			\
	if (((elm)->field.sqe_next = (head)->sqh_first) == NULL)	\
		(head)->sqh_last = &(elm)->field.sqe_next;		\
	(head)->sqh_first = (elm);					\
} while (/*CONSTCOND*/0)

#define	SIMPLEQ_INSERT_TAIL(head, elm, field) do {			\
	(elm)->field.sqe_next = NULL;					\
	*(head)->sqh_last = (elm);					\
	(head)->sqh_last = &(elm)->field.sqe_next;			\
} while (/*CONSTCOND*/0)

#define	SIMPLEQ_INSERT_AFTER(head, listelm, elm, field) do {		\
	if (((elm)->field.sqe_next = (listelm)->field.sqe_next) == NULL)\
		(head)->sqh_last = &(elm)->field.sqe_next;		\
	(listelm)->field.sqe_next = (elm);				\
} while (/*CONSTCOND*/0)

#define	SIMPLEQ_REMOVE_HEAD(head, field) do {				\
	if (((head)->sqh_first = (head)->sqh_first->field.sqe_next) == NULL) \
		(head)->sqh_last = &(head)->sqh_first;			\
} while (/*CONSTCOND*/0)

#define	SIMPLEQ_REMOVE(head, elm, type, field) do {			\
	if ((head)->sqh_first == (elm)) {				\
		SIMPLEQ_REMOVE_HEAD((head), field);			\
	} else {							\
		struct type *curelm = (head)->sqh_first;		\
		while (curelm->field.sqe_next != (elm))			\
			curelm = curelm->field.sqe_next;		\
		if ((curelm->field.sqe_next =				\
			curelm->field.sqe_next->field.sqe_next) == NULL) \
			    (head)->sqh_last = &(curelm)->field.sqe_next; \
	}								\
} while (/*CONSTCOND*/0)

#define	SIMPLEQ_FOREACH(var, head, field)				\
	for ((var) = ((head)->sqh_first);				\
		(var);							\
		(var) = ((var)->field.sqe_next))

/*
 * Simple queue access methods.
 */
#define	SIMPLEQ_EMPTY(head)		((head)->sqh_first == NULL)
#define	SIMPLEQ_FIRST(head)		((head)->sqh_first)
#define	SIMPLEQ_NEXT(elm, field)	((elm)->field.sqe_next)


/*
 * Tail queue definitions.
 */
#define	_TAILQ_HEAD(name, type, qual)					\
struct name {								\
	qual type *tqh_first;		/* first element */		\
	qual type *qual *tqh_last;	/* addr of last next element */	\
}
#define TAILQ_HEAD(name, type)	_TAILQ_HEAD(name, struct type,)

#define	TAILQ_HEAD_INITIALIZER(head)					\
	{ NULL, &(head).tqh_first }

#define	_TAILQ_ENTRY(type, qual)					\
struct {								\
	qual type *tqe_next;		/* next element */		\
	qual type *qual *tqe_prev;	/* address of previous next element */\
}
#define TAILQ_ENTRY(type)	_TAILQ_ENTRY(struct type,)

/*
 * Tail queue functions.
 */
#define	TAILQ_INIT(head) do {						\
	(head)->tqh_first = NULL;					\
	(head)->tqh_last = &(head)->tqh_first;				\
} while (/*CONSTCOND*/0)

#define	TAILQ_INSERT_HEAD(head, elm, field) do {			\
	if (((elm)->field.tqe_next = (head)->tqh_first) != NULL)	\
		(head)->tqh_first->field.tqe_prev =			\
		    &(elm)->field.tqe_next;				\
	else								\
		(head)->tqh_last = &(elm)->field.tqe_next;		\
	(head)->tqh_first = (elm);					\
	(elm)->field.tqe_prev = &(head)->tqh_first;			\
} while (/*CONSTCOND*/0)

#define	TAILQ_INSERT_TAIL(head, elm, field) do {			\
	(elm)->field.tqe_next = NULL;					\
	(elm)->field.tqe_prev = (head)->tqh_last;			\
	*(head)->tqh_last = (elm);					\
	(head)->tqh_last = &(elm)->field.tqe_next;			\
} while (/*CONSTCOND*/0)

#define	TAILQ_INSERT_AFTER(head, listelm, elm, field) do {		\
	if (((elm)->field.tqe_next = (listelm)->field.tqe_next) != NULL)\
		(elm)->field.tqe_next->field.tqe_prev = 		\
		    &(elm)->field.tqe_next;				\
	else								\
		(head)->tqh_last = &(elm)->field.tqe_next;		\
	(listelm)->field.tqe_next = (elm);				\
	(elm)->field.tqe_prev = &(listelm)->field.tqe_next;		\
} while (/*CONSTCOND*/0)

#define	TAILQ_INSERT_BEFORE(listelm, elm, field) do {			\
	(elm)->field.tqe_prev = (listelm)->field.tqe_prev;		\
	(elm)->field.tqe_next = (listelm);				\
	*(listelm)->field.tqe_prev = (elm);				\
	(listelm)->field.tqe_prev = &(elm)->field.tqe_next;		\
} while (/*CONSTCOND*/0)

#define	TAILQ_REMOVE(head, elm, field) do {				\
	if (((elm)->field.tqe_next) != NULL)				\
		(elm)->field.tqe_next->field.tqe_prev = 		\
		    (elm)->field.tqe_prev;				\
	else								\
		(head)->tqh_last = (elm)->field.tqe_prev;		\
	*(elm)->field.tqe_prev = (elm)->field.tqe_next;			\
} while (/*CONSTCOND*/0)

#define	TAILQ_FOREACH(var, head, field)					\
	for ((var) = ((head)->tqh_first);				\
		(var);							\
		(var) = ((var)->field.tqe_next))

#define	TAILQ_FOREACH_REVERSE(var, head, headname, field)		\
	for ((var) = (*(((struct headname *)((head)->tqh_last))->tqh_last));	\
		(var);							\
		(var) = (*(((struct headname *)((var)->field.tqe_prev))->tqh_last)))

/*
 * Tail queue access methods.
 */
#define	TAILQ_EMPTY(head)		((head)->tqh_first == NULL)
#define	TAILQ_FIRST(head)		((head)->tqh_first)
#define	TAILQ_NEXT(elm, field)		((elm)->field.tqe_next)

#define	TAILQ_LAST(head, headname) \
	(*(((struct headname *)((head)->tqh_last))->tqh_last))
#define	TAILQ_PREV(elm, headname, field) \
	(*(((struct headname *)((elm)->field.tqe_prev))->tqh_last))


/*
 * Circular queue definitions.
 */
#define	CIRCLEQ_HEAD(name, type)					\
struct name {								\
	struct type *cqh_first;		/* first element */		\
	struct type *cqh_last;		/* last element */		\
}

#define	CIRCLEQ_HEAD_INITIALIZER(head)					\
	{ (void *)&head, (void *)&head }

#define	CIRCLEQ_ENTRY(type)						\
struct {								\
	struct type *cqe_next;		/* next element */		\
	struct type *cqe_prev;		/* previous element */		\
}

/*
 * Circular queue functions.
 */
#define	CIRCLEQ_INIT(head) do {						\
	(head)->cqh_first = (void *)(head);				\
	(head)->cqh_last = (void *)(head);				\
} while (/*CONSTCOND*/0)

#define	CIRCLEQ_INSERT_AFTER(head, listelm, elm, field) do {		\
	(elm)->field.cqe_next = (listelm)->field.cqe_next;		\
	(elm)->field.cqe_prev = (listelm);				\
	if ((listelm)->field.cqe_next == (void *)(head))		\
		(head)->cqh_last = (elm);				\
	else								\
		(listelm)->field.cqe_next->field.cqe_prev = (elm);	\
	(listelm)->field.cqe_next = (elm);				\
} while (/*CONSTCOND*/0)

#define	CIRCLEQ_INSERT_BEFORE(head, listelm, elm, field) do {		\
	(elm)->field.cqe_next = (listelm);				\
	(elm)->field.cqe_prev = (listelm)->field.cqe_prev;		\
	if ((listelm)->field.cqe_prev == (void *)(head))		\
		(head)->cqh_first = (elm);				\
	else								\
		(listelm)->field.cqe_prev->field.cqe_next = (elm);	\
	(listelm)->field.cqe_prev = (elm);				\
} while (/*CONSTCOND*/0)

#define	CIRCLEQ_INSERT_HEAD(head, elm, field) do {			\
	(elm)->field.cqe_next = (head)->cqh_first;			\
	(elm)->field.cqe_prev = (void *)(head);				\
	if ((head)->cqh_last == (void *)(head))				\
		(head)->cqh_last = (elm);				\
	else								\
		(head)->cqh_first->field.cqe_prev = (elm);		\
	(head)->cqh_first = (elm);					\
} while (/*CONSTCOND*/0)

#define	CIRCLEQ_INSERT_TAIL(head, elm, field) do {			\
	(elm)->field.cqe_next = (void *)(head);				\
	(elm)->field.cqe_prev = (head)->cqh_last;			\
	if ((head)->cqh_first == (void *)(head))			\
		(head)->cqh_first = (elm);				\
	else								\
		(head)->cqh_last->field.cqe_next = (elm);		\
	(head)->cqh_last = (elm);					\
} while (/*CONSTCOND*/0)

#define	CIRCLEQ_REMOVE(head, elm, field) do {				\
	if ((elm)->field.cqe_next == (void *)(head))			\
		(head)->cqh_last = (elm)->field.cqe_prev;		\
	else								\
		(elm)->field.cqe_next->field.cqe_prev =			\
		    (elm)->field.cqe_prev;				\
	if ((elm)->field.cqe_prev == (void *)(head))			\
		(head)->cqh_first = (elm)->field.cqe_next;		\
	else								\
		(elm)->field.cqe_prev->field.cqe_next =			\
		    (elm)->field.cqe_next;				\
} while (/*CONSTCOND*/0)

#define	CIRCLEQ_FOREACH(var, head, field)				\
	for ((var) = ((head)->cqh_first);				\
		(var) != (const void *)(head);				\
		(var) = ((var)->field.cqe_next))

#define	CIRCLEQ_FOREACH_REVERSE(var, head, field)			\
	for ((var) = ((head)->cqh_last);				\
		(var) != (const void *)(head);				\
		(var) = ((var)->field.cqe_prev))

/*
 * Circular queue access methods.
 */
#define	CIRCLEQ_EMPTY(head)		((head)->cqh_first == (void *)(head))
#define	CIRCLEQ_FIRST(head)		((head)->cqh_first)
#define	CIRCLEQ_LAST(head)		((head)->cqh_last)
#define	CIRCLEQ_NEXT(elm, field)	((elm)->field.cqe_next)
#define	CIRCLEQ_PREV(elm, field)	((elm)->field.cqe_prev)

#define CIRCLEQ_LOOP_NEXT(head, elm, field)				\
	(((elm)->field.cqe_next == (void *)(head))			\
	    ? ((head)->cqh_first)					\
	    : (elm->field.cqe_next))
#define CIRCLEQ_LOOP_PREV(head, elm, field)				\
	(((elm)->field.cqe_prev == (void *)(head))			\
	    ? ((head)->cqh_last)					\
	    : (elm->field.cqe_prev))

#endif	/* sys/queue.h */


================================================
FILE: libspotify/examples/localfiles/Makefile
================================================
TARGET=posix_stu
CFLAGs += -Werror

include ../common.mk

$(TARGET): main.o appkey.o
	$(CC) $(CFLAGS) $(LDFLAGS) $^ -o $@ $(LDLIBS)

ifdef DEBUG
ifeq ($(shell uname),Darwin)
	install_name_tool -change @loader_path/../Frameworks/libspotify.framework/libspotify @rpath/libspotify.so $@
endif
endif


================================================
FILE: libspotify/examples/localfiles/main.c
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 */

#define USER_AGENT "testlocal"
/* A simple stub that logs in and out */

#include "main.h"
#include <pthread.h>
#include <stdlib.h>
#include <stdio.h>
#include <unistd.h>
#include <sys/time.h>
sp_session *g_session;

static int notify_events;
static pthread_mutex_t notify_mutex;
static pthread_cond_t notify_cond;


static void connection_error(sp_session *session, sp_error error)
{
	
}

static void logged_in(sp_session *session, sp_error error)
{
	//add your testcode here
        if (error != SP_ERROR_OK) {
		fprintf(stderr, "failed to login: %s\n",
		                sp_error_message(error));
                exit(1);
        }

	sp_track *track = sp_localtrack_create("Turboweekend","Something Or Nothing - Acid Washed Remix","",-1);
	sp_playlistcontainer *pc = sp_session_playlistcontainer(session);
	sp_playlist *pl = sp_playlistcontainer_add_new_playlist(pc,"localtest");
	sp_playlist_add_tracks(pl,&track,1,0,session);
	//sp_session_logout(session);
}

static void logged_out(sp_session *session)
{
	exit(0);
}


/**
 * This callback is called for log messages.
 *
 * @sa sp_session_callbacks#log_message
 */
static void log_message(sp_session *session, const char *data)
{
	fprintf(stderr,"%s",data);
}

void notify_main_thread(sp_session *session)
{
	pthread_mutex_lock(&notify_mutex);
	notify_events = 1;
	pthread_cond_signal(&notify_cond);
	pthread_mutex_unlock(&notify_mutex);
}

static sp_session_callbacks callbacks = {
	&logged_in,
	&logged_out,
	NULL,
	&connection_error,
	NULL,
	&notify_main_thread,
	NULL,
	NULL,
	&log_message
};

int spotify_init(const char *username,const char *password)
{
	sp_session_config config;
	sp_error error;
	sp_session *session;
	
	/// The application key is specific to each project, and allows Spotify
	/// to produce statistics on how our service is used.
	extern const char g_appkey[];
	/// The size of the application key.
	extern const size_t g_appkey_size;

	// Always do this. It allows libspotify to check for
	// header/library inconsistencies.
	config.api_version = SPOTIFY_API_VERSION;

	// The path of the directory to store the cache. This must be specified.
	// Please read the documentation on preferred values.
	config.cache_location = "tmp";

	// The path of the directory to store the settings. 
	// This must be specified.
	// Please read the documentation on preferred values.
	config.settings_location = "tmp";

	// The key of the application. They are generated by Spotify,
	// and are specific to each application using libspotify.
	config.application_key = g_appkey;
	config.application_key_size = g_appkey_size;

	// This identifies the application using some
	// free-text string [1, 255] characters.
	config.user_agent = USER_AGENT;

	// Register the callbacks.
	config.callbacks = &callbacks;

	error = sp_session_create(&config, &session);
	if (SP_ERROR_OK != error) {
		fprintf(stderr, "failed to create session: %s\n",
		                sp_error_message(error));
		return 2;
	}

	// Login using the credentials given on the command line.
	sp_session_login(session, username, password, 0, NULL);

	if (SP_ERROR_OK != error) {
		fprintf(stderr, "failed to login: %s\n",
		                sp_error_message(error));
		return 3;
	}

	g_session = session;
	return 0;
}

int main(int argc, char **argv)
{
	int next_timeout = 0;
	if(argc < 3) {
		fprintf(stderr,"Usage: %s <username> <password>\n",argv[0]);
		return -1;
	}
	pthread_mutex_init(&notify_mutex, NULL);
	pthread_cond_init(&notify_cond, NULL);

	if(spotify_init(argv[1],argv[2]) != 0) {
		fprintf(stderr,"Spotify failed to initialize\n");
		exit(-1);
	}
	pthread_mutex_lock(&notify_mutex);
	for (;;) {
		if (next_timeout == 0) {
			while(!notify_events)
				pthread_cond_wait(&notify_cond, &notify_mutex);
		} else {
			struct timespec ts;

	#if _POSIX_TIMERS > 0
			clock_gettime(CLOCK_REALTIME, &ts);
	#else
			struct timeval tv;
			gettimeofday(&tv, NULL);
			TIMEVAL_TO_TIMESPEC(&tv, &ts);
	#endif

			ts.tv_sec += next_timeout / 1000;
			ts.tv_nsec += (next_timeout % 1000) * 1000000;

			while(!notify_events) {
				if(pthread_cond_timedwait(&notify_cond, &notify_mutex, &ts))
					break;
			}
		}

		// Process libspotify events
		notify_events = 0;
		pthread_mutex_unlock(&notify_mutex);

		do {
			sp_session_process_events(g_session, &next_timeout);
		} while (next_timeout == 0);

		pthread_mutex_lock(&notify_mutex);
	}
	return 0;
}


================================================
FILE: libspotify/examples/localfiles/main.h
================================================
#ifndef __MAIN_H__
#define __MAIN_H__
#include <libspotify/api.h>
#endif


================================================
FILE: libspotify/examples/spshell/Makefile
================================================
TARGET=spshell
LDLIBS += -lreadline


ifdef SP_LIBSPOTIFY_WITH_SCROBBLING
CFLAGS += -DSP_LIBSPOTIFY_WITH_SCROBBLING=1
OBJS += scrobbling.o
endif

include ../common.mk

OBJS += spshell.o spshell_posix.o appkey.o cmd.o browse.o search.o toplist.o inbox.o star.o playlist.o test.o



$(TARGET): $(OBJS)
	$(CC) $(CFLAGS) $(LDFLAGS) $^ $(LDLIBS) -o $@
ifdef DEBUG
ifeq ($(shell uname),Darwin)
	install_name_tool -change @loader_path/../Frameworks/libspotify.framework/libspotify @rpath/libspotify.so $@
endif
endif


================================================
FILE: libspotify/examples/spshell/browse.c
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 */

#include "spshell.h"
#include "cmd.h"

static sp_track *track_browse;
static sp_playlist *playlist_browse;
static sp_playlist_callbacks pl_callbacks;

/**
 * Print the given track title together with some trivial metadata
 *
 * @param  track   The track object
 */
void print_track(sp_track *track)
{
	int duration = sp_track_duration(track);
	char url[256];
	sp_link *l;
	int i;

#if WIN32
	printf(" %s ", sp_track_is_starred(g_session,track) ? "*" : " ");
#else
	printf(" %s ", sp_track_is_starred(g_session,track) ? "★" : "☆");
#endif
	printf("Track %s [%d:%02d] has %d artist(s), %d%% popularity",
	       sp_track_name(track),
	       duration / 60000,
	       (duration / 1000) % 60,
	       sp_track_num_artists(track),
	       sp_track_popularity(track));
	
	if(sp_track_disc(track)) 
		printf(", %d on disc %d",
		       sp_track_index(track),
		       sp_track_disc(track));
	printf("\n");

	for (i = 0; i < sp_track_num_artists(track); i++) {
		sp_artist *art = sp_track_artist(track, i);
		printf("\tArtist %d: %s\n", i + 1, sp_artist_name(art));
	}
	l = sp_link_create_from_track(track, 0);
	sp_link_as_string(l, url, sizeof(url));
	printf("\t\t%s\n", url);
	sp_link_release(l);
}

/**
 * Print the given album browse result and as much information as possible
 *
 * @param  browse  The browse result
 */
static void print_albumbrowse(sp_albumbrowse *browse)
{
	int i;

	printf("Album browse of \"%s\" (%d)\n", 
	       sp_album_name(sp_albumbrowse_album(browse)), 
	       sp_album_year(sp_albumbrowse_album(browse)));

	for (i = 0; i < sp_albumbrowse_num_copyrights(browse); ++i)
		printf("  Copyright: %s\n", sp_albumbrowse_copyright(browse, i));

	printf("  Tracks: %d\n", sp_albumbrowse_num_tracks(browse));
	printf("  Review: %.60s...\n", sp_albumbrowse_review(browse));
	puts("");

	for (i = 0; i < sp_albumbrowse_num_tracks(browse); ++i)
		print_track(sp_albumbrowse_track(browse, i));

	puts("");
}

/**
 * Print the given artist browse result and as much information as possible
 *
 * @param  browse  The browse result
 */
static void print_artistbrowse(sp_artistbrowse *browse)
{
	int i;

	printf("Artist browse of \"%s\"\n", sp_artist_name(sp_artistbrowse_artist(browse)));

	for (i = 0; i < sp_artistbrowse_num_similar_artists(browse); ++i)
		printf("  Similar artist: %s\n", sp_artist_name(sp_artistbrowse_similar_artist(browse, i)));

	printf("  Portraits: %d\n", sp_artistbrowse_num_portraits(browse));
	printf("  Tracks   : %d\n", sp_artistbrowse_num_tracks(browse));
	printf("  Biography: %.60s...\n", sp_artistbrowse_biography(browse));
	puts("");

	for (i = 0; i < sp_artistbrowse_num_tracks(browse); ++i)
		print_track(sp_artistbrowse_track(browse, i));

	puts("");
}



/**
 * Callback for libspotify
 *
 * @param browse    The browse result object that is now done
 * @param userdata  The opaque pointer given to sp_albumbrowse_create()
 */
static void SP_CALLCONV browse_album_callback(sp_albumbrowse *browse, void *userdata)
{
	if (sp_albumbrowse_error(browse) == SP_ERROR_OK)
		print_albumbrowse(browse);
	else
		fprintf(stderr, "Failed to browse album: %s\n",
		        sp_error_message(sp_albumbrowse_error(browse)));

	sp_albumbrowse_release(browse);
	cmd_done();
}


/**
 * Callback for libspotify
 *
 * @param browse    The browse result object that is now done
 * @param userdata  The opaque pointer given to sp_artistbrowse_create()
 */
static void SP_CALLCONV browse_artist_callback(sp_artistbrowse *browse, void *userdata)
{
	if (sp_artistbrowse_error(browse) == SP_ERROR_OK)
		print_artistbrowse(browse);
	else
		fprintf(stderr, "Failed to browse artist: %s\n",
		        sp_error_message(sp_artistbrowse_error(browse)));

	sp_artistbrowse_release(browse);
	cmd_done();
}



/**
 *
 */
static void track_browse_try(void)
{
	switch (sp_track_error(track_browse)) {
	case SP_ERROR_OK:
		print_track(track_browse);
		break;

	case SP_ERROR_IS_LOADING:
		return; // Still pending

	default:
		fprintf(stderr, "Unable to resolve track: %s\n", sp_error_message(sp_track_error(track_browse)));
		break;
	}
	
	metadata_updated_fn = NULL;
	cmd_done();
	sp_track_release(track_browse);
}



/**
 *
 */
static void playlist_browse_try(void)
{
	int i, tracks;

	metadata_updated_fn = playlist_browse_try;
	if(!sp_playlist_is_loaded(playlist_browse)) {
		printf("\tPlaylist not loaded\n");
		return;
	}

	tracks = sp_playlist_num_tracks(playlist_browse);
	for(i = 0; i < tracks; i++) {
		sp_track *t = sp_playlist_track(playlist_browse, i);
		if (!sp_track_is_loaded(t))
			return;
	}

	printf("\tPlaylist and metadata loaded\n");

	for(i = 0; i < tracks; i++) {
		sp_track *t = sp_playlist_track(playlist_browse, i);
		
		printf(" %5d: ", i + 1);
		print_track(t);
	}
	sp_playlist_remove_callbacks(playlist_browse, &pl_callbacks, NULL);

	sp_playlist_release(playlist_browse);
	playlist_browse = NULL;
	metadata_updated_fn = NULL;
	cmd_done();
}

/**
 *
 */
static void SP_CALLCONV pl_tracks_added(sp_playlist *pl, sp_track * const * tracks,
			    int num_tracks, int position, void *userdata)
{
	printf("\t%d tracks added\n", num_tracks);
}

/**
 *
 */
static void SP_CALLCONV pl_tracks_removed(sp_playlist *pl, const int *tracks,
			      int num_tracks, void *userdata)
{
	printf("\t%d tracks removed\n", num_tracks);
}

/**
 *
 */
static void SP_CALLCONV pl_tracks_moved(sp_playlist *pl, const int *tracks,
			    int num_tracks, int new_position, void *userdata)
{
	printf("\t%d tracks moved\n", num_tracks);
}

/**
 *
 */
static void SP_CALLCONV pl_renamed(sp_playlist *pl, void *userdata)
{
	printf("\tList name: %s\n",  sp_playlist_name(pl));
}

/**
 *
 */
static void SP_CALLCONV pl_state_change(sp_playlist *pl, void *userdata)
{
	playlist_browse_try();
}

static sp_playlist_callbacks pl_callbacks = {
	pl_tracks_added,
	pl_tracks_removed,
	pl_tracks_moved,
	pl_renamed,
	pl_state_change,
};


void browse_playlist(sp_playlist *pl)
{
	playlist_browse = pl;
	sp_playlist_add_callbacks(playlist_browse, &pl_callbacks, NULL);
	playlist_browse_try();
}

/**
 *
 */
static void browse_usage(void)
{
	fprintf(stderr, "Usage: browse <spotify-uri>\n");
}


/**
 *
 */
int cmd_browse(int argc, char **argv)
{
	sp_link *link;

	if (argc != 2) {
		browse_usage();
		return -1;
	}

	
	link = sp_link_create_from_string(argv[1]);
	
	if (!link) {
		fprintf(stderr, "Not a spotify link\n");
		return -1;
	}

	switch(sp_link_type(link)) {
	default:
		fprintf(stderr, "Can not handle link");
		sp_link_release(link);
		return -1;

	case SP_LINKTYPE_ALBUM:
		sp_albumbrowse_create(g_session, sp_link_as_album(link), browse_album_callback, NULL);
		break;

	case SP_LINKTYPE_ARTIST:
		sp_artistbrowse_create(g_session, sp_link_as_artist(link), SP_ARTISTBROWSE_FULL, browse_artist_callback, NULL);
		break;

	case SP_LINKTYPE_LOCALTRACK:
	case SP_LINKTYPE_TRACK:
		track_browse = sp_link_as_track(link);
		metadata_updated_fn = track_browse_try;
		sp_track_add_ref(track_browse);
		track_browse_try();
		break;

	case SP_LINKTYPE_PLAYLIST:
		browse_playlist(sp_playlist_create(g_session, link));
		break;
	}

	sp_link_release(link);
	return 0;
}


================================================
FILE: libspotify/examples/spshell/cmd.c
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 */

#include <string.h>

#include "spshell.h"
#include "cmd.h"

static int cmd_help(int argc, char **argv);

/**
 *
 */
struct {
	const char *name;
	int (*fn)(int argc, char **argv);
	const char *help;
} commands[] = {
	{ "log",        cmd_log,        "Enable/Disable logging to console (default off)" },
	{ "logout",     cmd_logout,     "Logout and exit app" },
	{ "exit",       cmd_logout,     "Logout and exit app" },
	{ "quit",       cmd_logout,     "Logout and exit app" },
	{ "browse",     cmd_browse,     "Browse a Spotify URI" },
	{ "search",     cmd_search,     "Search" },
	{ "whatsnew",   cmd_whatsnew,   "List new albums" },
	{ "toplist",    cmd_toplist,    "Browse toplists" },
	{ "post",       cmd_post,       "Post track to a user's inbox" },
	{ "inbox",      cmd_inbox,      "View inbox" },
	{ "help",       cmd_help,       "This help" },
	{ "star",       cmd_star,       "Star a track" },
	{ "unstar",     cmd_unstar,     "Unstar a track" },
	{ "starred",    cmd_starred,    "List all starred tracks" },
#if SP_LIBSPOTIFY_WITH_SCROBBLING
	{ "facebook_scrobbling", cmd_facebook_scrobbling,  "Enable/Disable facebook scrobbling" },
	{ "is_facebook_scrobbling", cmd_is_facebook_scrobbling,  "Returns facebook scrobbling status" },
	{ "spotify_social", cmd_spotify_social,  "Enable/Disable posting to Spotify Social" },
	{ "is_spotify_social", cmd_is_spotify_social,  "Returns Spotify Social status" },
	{ "lastfm_scrobbling_credentials", cmd_set_lastfm_scrobbling_credentials, "Sets the lastfm scrobbling credentials" },
	{ "lastfm_scrobbling", cmd_lastfm_scrobbling, "Enable/Disable lastfm scrobbling" },
	{ "is_lastfm_scrobbling", cmd_is_lastfm_scrobbling, "Returns lastfm scrobbling status"},
	{ "private_session", cmd_private_session, "Enable/Disable private session" },
	{ "is_private_session", cmd_is_private_session, "Returns private session mode"},
#endif
	{ "playlists",  cmd_playlists,  "List playlists" },
	{ "playlist",   cmd_playlist,   "List playlist contents" },
	{ "set_autolink", cmd_set_autolink, "Set autolinking state" },
	{ "add_folder", cmd_add_folder, "Add playlist folder"},
	{ "update_subscriptions", cmd_update_subscriptions, "Update playlist subscription info"},
	{ "add", cmd_playlist_add_track, "Add track to playlist"},
	{ "offline", cmd_playlist_offline, "Set offline mode for a playlist"},
#if WITH_TEST_COMMAND
	{ "test", cmd_test, "Run tests"},
#endif
};


/**
 *
 */
static int tokenize(char *buf, char **vec, int vsize)
{
	int n = 0;
	while(1) {
		while(*buf > 0 && *buf < 33)
			buf++;
		if(!*buf)
			break;
		vec[n++] = buf;
		if(n == vsize)
			break;
		while(*buf > 32)
			buf++;
		if(*buf == 0)
			break;
		*buf = 0;
		buf++;
	}
	return n;
}


/**
 *
 */
void cmd_exec_unparsed(char *l)
{
	char *vec[32];
	int c = tokenize(l, vec, 32);
	cmd_dispatch(c, vec);
}


/**
 *
 */
void cmd_dispatch(int argc, char **argv)
{
	int i;

	if(argc < 1) {
		cmd_done();
		return;
	}

	for(i = 0; i < sizeof(commands) / sizeof(commands[0]); i++) {
		if(!strcmp(commands[i].name, argv[0])) {
			if(commands[i].fn(argc, argv))
				cmd_done();
			return;
		}
	}
	printf("No such command\n");
	cmd_done();
}

/**
 *
 */
static int cmd_help(int argc, char **argv)
{
	int i;
	for(i = 0; i < sizeof(commands) / sizeof(commands[0]); i++)
		printf("  %-20s %s\n", commands[i].name, commands[i].help);
	return -1;
}


================================================
FILE: libspotify/examples/spshell/cmd.h
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 */

#ifndef CMD_H__
#define CMD_H__

extern void cmd_exec_unparsed(char *l);

extern void cmd_dispatch(int argc, char **argv);

extern void cmd_done(void);


extern int cmd_log(int argc, char **argv);
extern int cmd_logout(int argc, char **argv);
extern int cmd_browse(int argc, char **argv);
extern int cmd_search(int argc, char **argv);
extern int cmd_whatsnew(int argc, char **argv);
extern int cmd_toplist(int argc, char **argv);
extern int cmd_post(int argc, char **argv);
extern int cmd_star(int argc, char **argv);
extern int cmd_unstar(int argc, char **argv);
extern int cmd_starred(int argc, char **argv);
extern int cmd_inbox(int argc, char **argv);
extern int cmd_friends(int argc, char **argv);
extern int cmd_facebook_scrobbling(int argc, char **argv);
extern int cmd_is_facebook_scrobbling(int argc, char **argv);
extern int cmd_spotify_social(int argc, char **argv);
extern int cmd_is_spotify_social(int argc, char **argv);
extern int cmd_set_lastfm_scrobbling_credentials(int argc, char** argv);
extern int cmd_lastfm_scrobbling(int argc, char** argv);
extern int cmd_is_lastfm_scrobbling(int argc, char** argv);
extern int cmd_private_session(int argc, char** argv);
extern int cmd_is_private_session(int argc, char** argv);

extern int cmd_playlists(int argc, char **argv);
extern int cmd_playlist(int argc, char **argv);
extern int cmd_set_autolink(int argc, char **argv);

extern int cmd_published_playlists(int argc, char **argv);
extern int cmd_get_published_playlist (int argc, char **argv);

extern int cmd_social_enable(int argc, char **argv);
extern int cmd_playlists_enable(int argc, char **argv);
extern int cmd_add_folder(int argc, char **argv);
extern int cmd_update_subscriptions(int argc, char **argv);
extern int cmd_playlist_add_track(int argc, char **argv);
extern int cmd_playlist_offline(int argc, char **argv);

#if WITH_TEST_COMMAND
extern int cmd_test(int argc, char **argv);
#endif

/* Shared functions */
void browse_playlist(sp_playlist *pl);
void print_track(sp_track *track);

#endif // CMD_H__


================================================
FILE: libspotify/examples/spshell/inbox.c
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 */

#include <string.h>

#include "spshell.h"
#include "cmd.h"

/**
 *
 */
static void post_usage(void)
{
	fprintf(stderr, "Usage: post <recipient> <message> [<track-uri> ...]\n");
}


/**
 * Callback for libspotify
 *
 * @param result    The inbox result object that is now done
 * @param userdata  The opaque pointer given to sp_inbox_post_tracks()
 */
static void SP_CALLCONV inbox_post_completed(sp_inbox *result, void *userdata)
{
	fprintf(stderr, "Inbox post result: %s\n", sp_error_message(sp_inbox_error(result)));
	cmd_done();

}

/**
 *
 */
int cmd_post(int argc, char **argv)
{
	int num_tracks, i;
	sp_track **tracks;
	sp_link *link;
	sp_inbox *req;

	if (argc < 3) {
		post_usage();
		return -1;
	}

	if (argc == 3) {
		// No arguments, rickroll recipient
		tracks = malloc(sizeof(sp_track *));
		link = sp_link_create_from_string("spotify:track:6JEK0CvvjDjjMUBFoXShNZ");
		sp_track_add_ref(tracks[0] = sp_link_as_track(link));
		sp_link_release(link);
		num_tracks = 1;
	} else {
		tracks = malloc(sizeof(sp_track *) * (argc - 3));
		num_tracks = 0;
		for(i = 3; i < argc; i++) {
			link = sp_link_create_from_string(argv[i]);
			if(link == NULL || !(sp_link_type(link) == SP_LINKTYPE_TRACK || sp_link_type(link) == SP_LINKTYPE_LOCALTRACK))
				continue;
			sp_track_add_ref(tracks[num_tracks++] = sp_link_as_track(link));
			sp_link_release(link);
		}
	}

	if(num_tracks == 0) {
		fprintf(stderr, "No valid tracks?\n");
		return -1;
	}

	req = sp_inbox_post_tracks(g_session, argv[1], tracks, num_tracks,  argv[2], inbox_post_completed, NULL);

	for(i = 0; i < num_tracks; i++)
		sp_track_release(tracks[i]);
	free(tracks);

	if(req == NULL) {
		fprintf(stderr, "inbox post failed\n");
		return -1;
	}

	return 0;
}



/**
 *
 */
int cmd_inbox(int argc, char **argv)
{
	sp_playlist *inbox;
	inbox = sp_session_inbox_create(g_session);
	if (!inbox) {
		printf("Inbox not loaded\n");
		return -1;
	}
	browse_playlist(inbox);
	return 0;
}


================================================
FILE: libspotify/examples/spshell/osx/spshell.xcodeproj/project.pbxproj
================================================
// !$*UTF8*$!
{
	archiveVersion = 1;
	classes = {
	};
	objectVersion = 45;
	objects = {

/* Begin PBXBuildFile section */
		0575285911634BB7003FFC9D /* star.c in Sources */ = {isa = PBXBuildFile; fileRef = 0575285811634BB7003FFC9D /* star.c */; };
		0575285D11634BC4003FFC9D /* social.c in Sources */ = {isa = PBXBuildFile; fileRef = 0575285C11634BC4003FFC9D /* social.c */; };
		CF513AC8115B722500662A82 /* appkey.c in Sources */ = {isa = PBXBuildFile; fileRef = CF513ABE115B722500662A82 /* appkey.c */; };
		CF513AC9115B722500662A82 /* browse.c in Sources */ = {isa = PBXBuildFile; fileRef = CF513ABF115B722500662A82 /* browse.c */; };
		CF513ACA115B722500662A82 /* cmd.c in Sources */ = {isa = PBXBuildFile; fileRef = CF513AC0115B722500662A82 /* cmd.c */; };
		CF513ACB115B722500662A82 /* inbox.c in Sources */ = {isa = PBXBuildFile; fileRef = CF513AC2115B722500662A82 /* inbox.c */; };
		CF513ACC115B722500662A82 /* search.c in Sources */ = {isa = PBXBuildFile; fileRef = CF513AC3115B722500662A82 /* search.c */; };
		CF513ACD115B722500662A82 /* spshell_posix.c in Sources */ = {isa = PBXBuildFile; fileRef = CF513AC4115B722500662A82 /* spshell_posix.c */; };
		CF513ACE115B722500662A82 /* spshell.c in Sources */ = {isa = PBXBuildFile; fileRef = CF513AC5115B722500662A82 /* spshell.c */; };
		CF513ACF115B722500662A82 /* toplist.c in Sources */ = {isa = PBXBuildFile; fileRef = CF513AC7115B722500662A82 /* toplist.c */; };
		CF513AD1115B722E00662A82 /* libspotify.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = CF513AD0115B722E00662A82 /* libspotify.framework */; };
		CF513AF2115B73B900662A82 /* libreadline.dylib in Frameworks */ = {isa = PBXBuildFile; fileRef = CF513AF1115B73B900662A82 /* libreadline.dylib */; };
/* End PBXBuildFile section */

/* Begin PBXCopyFilesBuildPhase section */
		8DD76FAF0486AB0100D96B5E /* CopyFiles */ = {
			isa = PBXCopyFilesBuildPhase;
			buildActionMask = 8;
			dstPath = /usr/share/man/man1/;
			dstSubfolderSpec = 0;
			files = (
			);
			runOnlyForDeploymentPostprocessing = 1;
		};
/* End PBXCopyFilesBuildPhase section */

/* Begin PBXFileReference section */
		0575285811634BB7003FFC9D /* star.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; name = star.c; path = ../star.c; sourceTree = SOURCE_ROOT; };
		0575285C11634BC4003FFC9D /* social.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; name = social.c; path = ../social.c; sourceTree = SOURCE_ROOT; };
		8DD76FB20486AB0100D96B5E /* spshell */ = {isa = PBXFileReference; explicitFileType = "compiled.mach-o.executable"; includeInIndex = 0; path = spshell; sourceTree = BUILT_PRODUCTS_DIR; };
		CF513ABE115B722500662A82 /* appkey.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; name = appkey.c; path = ../../appkey.c; sourceTree = SOURCE_ROOT; };
		CF513ABF115B722500662A82 /* browse.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; name = browse.c; path = ../browse.c; sourceTree = SOURCE_ROOT; };
		CF513AC0115B722500662A82 /* cmd.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; name = cmd.c; path = ../cmd.c; sourceTree = SOURCE_ROOT; };
		CF513AC1115B722500662A82 /* cmd.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = cmd.h; path = ../cmd.h; sourceTree = SOURCE_ROOT; };
		CF513AC2115B722500662A82 /* inbox.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; name = inbox.c; path = ../inbox.c; sourceTree = SOURCE_ROOT; };
		CF513AC3115B722500662A82 /* search.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; name = search.c; path = ../search.c; sourceTree = SOURCE_ROOT; };
		CF513AC4115B722500662A82 /* spshell_posix.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; name = spshell_posix.c; path = ../spshell_posix.c; sourceTree = SOURCE_ROOT; };
		CF513AC5115B722500662A82 /* spshell.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; name = spshell.c; path = ../spshell.c; sourceTree = SOURCE_ROOT; };
		CF513AC6115B722500662A82 /* spshell.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; name = spshell.h; path = ../spshell.h; sourceTree = SOURCE_ROOT; };
		CF513AC7115B722500662A82 /* toplist.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; name = toplist.c; path = ../toplist.c; sourceTree = SOURCE_ROOT; };
		CF513AD0115B722E00662A82 /* libspotify.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = libspotify.framework; path = /Library/Frameworks/libspotify.framework; sourceTree = "<absolute>"; };
		CF513AF1115B73B900662A82 /* libreadline.dylib */ = {isa = PBXFileReference; lastKnownFileType = "compiled.mach-o.dylib"; name = libreadline.dylib; path = usr/lib/libreadline.dylib; sourceTree = SDKROOT; };
/* End PBXFileReference section */

/* Begin PBXFrameworksBuildPhase section */
		8DD76FAD0486AB0100D96B5E /* Frameworks */ = {
			isa = PBXFrameworksBuildPhase;
			buildActionMask = 2147483647;
			files = (
				CF513AD1115B722E00662A82 /* libspotify.framework in Frameworks */,
				CF513AF2115B73B900662A82 /* libreadline.dylib in Frameworks */,
			);
			runOnlyForDeploymentPostprocessing = 0;
		};
/* End PBXFrameworksBuildPhase section */

/* Begin PBXGroup section */
		08FB7794FE84155DC02AAC07 /* spshell */ = {
			isa = PBXGroup;
			children = (
				08FB7795FE84155DC02AAC07 /* Source */,
				1AB674ADFE9D54B511CA2CBB /* Products */,
			);
			name = spshell;
			sourceTree = "<group>";
		};
		08FB7795FE84155DC02AAC07 /* Source */ = {
			isa = PBXGroup;
			children = (
				CF513ABE115B722500662A82 /* appkey.c */,
				CF513ABF115B722500662A82 /* browse.c */,
				CF513AC0115B722500662A82 /* cmd.c */,
				CF513AC1115B722500662A82 /* cmd.h */,
				CF513AC2115B722500662A82 /* inbox.c */,
				CF513AC3115B722500662A82 /* search.c */,
				CF513AC4115B722500662A82 /* spshell_posix.c */,
				CF513AC5115B722500662A82 /* spshell.c */,
				CF513AC6115B722500662A82 /* spshell.h */,
				CF513AC7115B722500662A82 /* toplist.c */,
				0575285811634BB7003FFC9D /* star.c */,
				0575285C11634BC4003FFC9D /* social.c */,
			);
			name = Source;
			sourceTree = "<group>";
		};
		1AB674ADFE9D54B511CA2CBB /* Products */ = {
			isa = PBXGroup;
			children = (
				CF513AF1115B73B900662A82 /* libreadline.dylib */,
				CF513AD0115B722E00662A82 /* libspotify.framework */,
				8DD76FB20486AB0100D96B5E /* spshell */,
			);
			name = Products;
			sourceTree = "<group>";
		};
/* End PBXGroup section */

/* Begin PBXNativeTarget section */
		8DD76FA90486AB0100D96B5E /* spshell */ = {
			isa = PBXNativeTarget;
			buildConfigurationList = 1DEB928508733DD80010E9CD /* Build configuration list for PBXNativeTarget "spshell" */;
			buildPhases = (
				0575281D116348DB003FFC9D /* Ensure framework installation */,
				8DD76FAB0486AB0100D96B5E /* Sources */,
				8DD76FAD0486AB0100D96B5E /* Frameworks */,
				8DD76FAF0486AB0100D96B5E /* CopyFiles */,
				0575281F116348FB003FFC9D /* Change install name of libspotify */,
			);
			buildRules = (
			);
			dependencies = (
			);
			name = spshell;
			productInstallPath = "$(HOME)/bin";
			productName = spshell;
			productReference = 8DD76FB20486AB0100D96B5E /* spshell */;
			productType = "com.apple.product-type.tool";
		};
/* End PBXNativeTarget section */

/* Begin PBXProject section */
		08FB7793FE84155DC02AAC07 /* Project object */ = {
			isa = PBXProject;
			buildConfigurationList = 1DEB928908733DD80010E9CD /* Build configuration list for PBXProject "spshell" */;
			compatibilityVersion = "Xcode 3.1";
			hasScannedForEncodings = 1;
			mainGroup = 08FB7794FE84155DC02AAC07 /* spshell */;
			projectDirPath = "";
			projectRoot = "";
			targets = (
				8DD76FA90486AB0100D96B5E /* spshell */,
			);
		};
/* End PBXProject section */

/* Begin PBXShellScriptBuildPhase section */
		0575281D116348DB003FFC9D /* Ensure framework installation */ = {
			isa = PBXShellScriptBuildPhase;
			buildActionMask = 2147483647;
			files = (
			);
			inputPaths = (
			);
			name = "Ensure framework installation";
			outputPaths = (
			);
			runOnlyForDeploymentPostprocessing = 0;
			shellPath = /bin/sh;
			shellScript = "if [ ! -e /Library/Frameworks/libspotify.framework ]; then\n  echo \"You must install libspotify.framework to /Library/Frameworks.\" >&2\n  exit 1\nfi\n\nexit 0";
		};
		0575281F116348FB003FFC9D /* Change install name of libspotify */ = {
			isa = PBXShellScriptBuildPhase;
			buildActionMask = 2147483647;
			files = (
			);
			inputPaths = (
			);
			name = "Change install name of libspotify";
			outputPaths = (
			);
			runOnlyForDeploymentPostprocessing = 0;
			shellPath = /bin/sh;
			shellScript = "install_name_tool -change @loader_path/../Frameworks/libspotify.framework/libspotify /Library/Frameworks/libspotify.framework/libspotify $CONFIGURATION_BUILD_DIR/$EXECUTABLE_PATH";
		};
/* End PBXShellScriptBuildPhase section */

/* Begin PBXSourcesBuildPhase section */
		8DD76FAB0486AB0100D96B5E /* Sources */ = {
			isa = PBXSourcesBuildPhase;
			buildActionMask = 2147483647;
			files = (
				CF513AC8115B722500662A82 /* appkey.c in Sources */,
				CF513AC9115B722500662A82 /* browse.c in Sources */,
				CF513ACA115B722500662A82 /* cmd.c in Sources */,
				CF513ACB115B722500662A82 /* inbox.c in Sources */,
				CF513ACC115B722500662A82 /* search.c in Sources */,
				CF513ACD115B722500662A82 /* spshell_posix.c in Sources */,
				CF513ACE115B722500662A82 /* spshell.c in Sources */,
				CF513ACF115B722500662A82 /* toplist.c in Sources */,
				0575285911634BB7003FFC9D /* star.c in Sources */,
				0575285D11634BC4003FFC9D /* social.c in Sources */,
			);
			runOnlyForDeploymentPostprocessing = 0;
		};
/* End PBXSourcesBuildPhase section */

/* Begin XCBuildConfiguration section */
		1DEB928608733DD80010E9CD /* Debug */ = {
			isa = XCBuildConfiguration;
			buildSettings = {
				ALWAYS_SEARCH_USER_PATHS = NO;
				COPY_PHASE_STRIP = NO;
				GCC_DYNAMIC_NO_PIC = NO;
				GCC_ENABLE_FIX_AND_CONTINUE = YES;
				GCC_MODEL_TUNING = G5;
				GCC_OPTIMIZATION_LEVEL = 0;
				INSTALL_PATH = /usr/local/bin;
				PRODUCT_NAME = spshell;
			};
			name = Debug;
		};
		1DEB928708733DD80010E9CD /* Release */ = {
			isa = XCBuildConfiguration;
			buildSettings = {
				ALWAYS_SEARCH_USER_PATHS = NO;
				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
				FRAMEWORK_SEARCH_PATHS = (
					"$(inherited)",
					"\"$(SRCROOT)/../../../..\"",
				);
				GCC_MODEL_TUNING = G5;
				INSTALL_PATH = /usr/local/bin;
				PRODUCT_NAME = spshell;
			};
			name = Release;
		};
		1DEB928A08733DD80010E9CD /* Debug */ = {
			isa = XCBuildConfiguration;
			buildSettings = {
				ARCHS = "$(ARCHS_STANDARD_32_64_BIT)";
				GCC_C_LANGUAGE_STANDARD = gnu99;
				GCC_OPTIMIZATION_LEVEL = 0;
				GCC_WARN_ABOUT_RETURN_TYPE = YES;
				GCC_WARN_UNUSED_VARIABLE = YES;
				ONLY_ACTIVE_ARCH = YES;
				PREBINDING = NO;
				SDKROOT = macosx10.6;
			};
			name = Debug;
		};
		1DEB928B08733DD80010E9CD /* Release */ = {
			isa = XCBuildConfiguration;
			buildSettings = {
				ARCHS = "$(ARCHS_STANDARD_32_64_BIT)";
				GCC_C_LANGUAGE_STANDARD = gnu99;
				GCC_WARN_ABOUT_RETURN_TYPE = YES;
				GCC_WARN_UNUSED_VARIABLE = YES;
				PREBINDING = NO;
				SDKROOT = macosx10.6;
			};
			name = Release;
		};
/* End XCBuildConfiguration section */

/* Begin XCConfigurationList section */
		1DEB928508733DD80010E9CD /* Build configuration list for PBXNativeTarget "spshell" */ = {
			isa = XCConfigurationList;
			buildConfigurations = (
				1DEB928608733DD80010E9CD /* Debug */,
				1DEB928708733DD80010E9CD /* Release */,
			);
			defaultConfigurationIsVisible = 0;
			defaultConfigurationName = Release;
		};
		1DEB928908733DD80010E9CD /* Build configuration list for PBXProject "spshell" */ = {
			isa = XCConfigurationList;
			buildConfigurations = (
				1DEB928A08733DD80010E9CD /* Debug */,
				1DEB928B08733DD80010E9CD /* Release */,
			);
			defaultConfigurationIsVisible = 0;
			defaultConfigurationName = Release;
		};
/* End XCConfigurationList section */
	};
	rootObject = 08FB7793FE84155DC02AAC07 /* Project object */;
}


================================================
FILE: libspotify/examples/spshell/playlist.c
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 */

#include <string.h>

#include "spshell.h"
#include "cmd.h"

#ifdef WIN32
#define alloca _alloca
#else
#include <alloca.h>
#endif

static int subscriptions_updated;

/**
 *
 */
int cmd_update_subscriptions(int argc, char **argv)
{
	int i;
	sp_playlistcontainer *pc = sp_session_playlistcontainer(g_session);
	sp_playlist *pl;
	subscriptions_updated = 1;
	for (i = 0; i < sp_playlistcontainer_num_playlists(pc); ++i) {
		switch (sp_playlistcontainer_playlist_type(pc, i)) {
		case SP_PLAYLIST_TYPE_PLAYLIST:
			pl = sp_playlistcontainer_playlist(pc, i);
			sp_playlist_update_subscribers(g_session, pl);
			break;
		default:
			break;
		}
	}
	return 1;
}



/**
 *
 */
int cmd_playlists(int argc, char **argv)
{
	sp_playlistcontainer *pc = sp_session_playlistcontainer(g_session);
	int i, j, level = 0;
	sp_playlist *pl;
	char name[200];
	int new = 0;

	printf("%d entries in the container\n", sp_playlistcontainer_num_playlists(pc));

	for (i = 0; i < sp_playlistcontainer_num_playlists(pc); ++i) {
		switch (sp_playlistcontainer_playlist_type(pc, i)) {
			case SP_PLAYLIST_TYPE_PLAYLIST:
				printf("%d. ", i);
				for (j = level; j; --j) printf("\t");
				pl = sp_playlistcontainer_playlist(pc, i);
				printf("%s", sp_playlist_name(pl));
				if(subscriptions_updated)
					printf(" (%d subscribers)", sp_playlist_num_subscribers(pl));

				new = sp_playlistcontainer_get_unseen_tracks(pc, pl, NULL, 0);
				if (new)
					printf(" (%d new)", new);

				printf("\n");
				break;
			case SP_PLAYLIST_TYPE_START_FOLDER:
				printf("%d. ", i);
				for (j = level; j; --j) printf("\t");
				sp_playlistcontainer_playlist_folder_name(pc, i, name, sizeof(name));
				printf("Folder: %s with id %llu\n", name,
					   sp_playlistcontainer_playlist_folder_id(pc, i));
				level++;
				break;
			case SP_PLAYLIST_TYPE_END_FOLDER:
				level--;
 				printf("%d. ", i);
				for (j = level; j; --j) printf("\t");
				printf("End folder with id %llu\n",	sp_playlistcontainer_playlist_folder_id(pc, i));
				break;
			case SP_PLAYLIST_TYPE_PLACEHOLDER:
				printf("%d. Placeholder", i);
				break;
		}
	}
	return 1;
}

/**
 *
 */
static void print_track2(sp_track *track, int i)
{

	printf("%d. %c %s%s %s\n", i,
	       sp_track_is_starred(g_session, track) ? '*' : ' ',
	       sp_track_is_local(g_session, track) ? "local" : "     ",
	       sp_track_is_autolinked(g_session, track) ? "autolinked" : "          ",
	       sp_track_name(track));
}


/**
 *
 */
int cmd_playlist(int argc, char **argv)
{
	int index, i, nnew;
	sp_playlist *playlist;
	sp_playlistcontainer *pc = sp_session_playlistcontainer(g_session);

	if (argc < 1) {
		printf("playlist [playlist index]\n");
		return 0;
	}

	index = atoi(argv[1]);
	if (index < 0 || index > sp_playlistcontainer_num_playlists(pc)) {
		printf("invalid index\n");
		return 0;
	}

	playlist = sp_playlistcontainer_playlist(pc, index);

	nnew = sp_playlistcontainer_get_unseen_tracks(pc, playlist, 0, 0);

	printf("Playlist %s by %s%s%s, %d new tracks\n",
		   sp_playlist_name(playlist),
		   sp_user_display_name(sp_playlist_owner(playlist)),
		   sp_playlist_is_collaborative(playlist) ? " (collaborative)" : "",
	           sp_playlist_has_pending_changes(playlist) ? " with pending changes" : "",
	           nnew
		   );

	if (argc == 3) {
		if (!strcmp(argv[2], "new")) {
			sp_track **tracks;

			if (nnew < 0)
				return 1;

			tracks = alloca(nnew * sizeof(*tracks));
			sp_playlistcontainer_get_unseen_tracks(pc, playlist, tracks, nnew);

			for (i = 0; i < nnew; i++) {
				print_track2(tracks[i], i);
			}
			return 1;

		} else if (!strcmp(argv[2], "clear-unseen"))
			sp_playlistcontainer_clear_unseen_tracks(pc, playlist);

	}
	for (i = 0; i < sp_playlist_num_tracks(playlist); ++i) {
		sp_track *track = sp_playlist_track(playlist, i);

		print_track2(track, i);
	}
	return 1;
}

/**
 *
 */
int cmd_set_autolink(int argc, char **argv)
{
	int index; 
	bool autolink;
	sp_playlist *playlist;
	sp_playlistcontainer *pc = sp_session_playlistcontainer(g_session);

	if (argc < 2) {
		printf("set autolink [playlist index] [0/1]\n");
		return 0;
	}

	index = atoi(argv[1]);
	autolink = atoi(argv[2]);
	if (index < 0 || index > sp_playlistcontainer_num_playlists(pc)) {
		printf("invalid index\n");
		return 0;
	}
	playlist = sp_playlistcontainer_playlist(pc, index);
	sp_playlist_set_autolink_tracks(playlist, !!autolink);
	printf("Set autolinking to %s on playlist %s\n", autolink ? "true": "false", sp_playlist_name(playlist));
	return 1;
}



/**
 *
 */
int cmd_add_folder(int argc, char **argv)
{
	int index; 
	const char *name;
	sp_playlistcontainer *pc = sp_session_playlistcontainer(g_session);

	if (argc < 2) {
		printf("addfolder [playlist index] [name]\n");
		return 0;
	}

	index = atoi(argv[1]);
	name = argv[2];

	if (index < 0 || index > sp_playlistcontainer_num_playlists(pc)) {
		printf("invalid index\n");
		return 0;
	}
	sp_playlistcontainer_add_folder(pc, index, name);
	return 1;
}


static sp_playlist_callbacks pl_update_callbacks;

/**
 *
 */
struct pl_update_work {
	int position;
	int num_tracks;
	sp_track **tracks;
};

static int apply_changes(sp_playlist *pl, struct pl_update_work *puw)
{
	sp_link *l;
	sp_error err;

	if(!sp_playlist_is_loaded(pl))
		return 1;


	l = sp_link_create_from_playlist(pl);
	if(l == NULL)
		return 1;
	sp_link_release(l);

	fprintf(stderr, "Playlist loaded, applying changes ... ");

	err = sp_playlist_add_tracks(pl, puw->tracks,
	    puw->num_tracks, puw->position, g_session);

	switch(err) {
	case SP_ERROR_OK:
		fprintf(stderr, "OK\n");
		break;
	case SP_ERROR_INVALID_INDATA:
		fprintf(stderr, "Invalid position\n");
		break;

	case SP_ERROR_PERMISSION_DENIED:
		fprintf(stderr, "Access denied\n");
		break;
	default:
		fprintf(stderr, "Other error (should not happen)\n");
		break;
	}
	return 0;
}

static void SP_CALLCONV pl_state_change(sp_playlist *pl, void *userdata)
{
	struct pl_update_work *puw = userdata;
	if(apply_changes(pl, puw))
		return;

	sp_playlist_remove_callbacks(pl, &pl_update_callbacks, puw);
	sp_playlist_release(pl);
	cmd_done();
}

static sp_playlist_callbacks pl_update_callbacks = {
	NULL,
	NULL,
	NULL,
	NULL,
	pl_state_change,
};


/**
 *
 */
int cmd_playlist_add_track(int argc, char **argv)
{
	sp_link *plink, *tlink;
	sp_track *t;
	sp_playlist *pl;
	int i;
	struct pl_update_work *puw;

	if(argc < 4) {
		printf("add [playlist uri] [position] [track uri] <[track uri]>...\n");
		return 1;
	}

	plink = sp_link_create_from_string(argv[1]);
	if (!plink) {
		fprintf(stderr, "%s is not a spotify link\n", argv[1]);
		return -1;
	}

	if(sp_link_type(plink) != SP_LINKTYPE_PLAYLIST) {
		fprintf(stderr, "%s is not a playlist link\n", argv[1]);
		sp_link_release(plink);
		return -1;
	}

	puw = malloc(sizeof(struct pl_update_work));
	puw->position = atoi(argv[2]);
	puw->tracks = malloc(sizeof(sp_track *) * argc - 3);
	puw->num_tracks = 0;
	for(i = 0; i < argc - 3; i++) {
		tlink = sp_link_create_from_string(argv[i + 3]);
		if(tlink == NULL) {
			fprintf(stderr, "%s is not a spotify link, skipping\n", argv[i + 3]);
			continue;
		}
		if(sp_link_type(tlink) != SP_LINKTYPE_TRACK) {
			fprintf(stderr, "%s is not a track link, skipping\n", argv[i + 3]);
			continue;
		}
		t = sp_link_as_track(tlink);
		sp_track_add_ref(t);
		puw->tracks[puw->num_tracks++] = t;
		sp_link_release(tlink);
	}

	pl = sp_playlist_create(g_session, plink);
	if(!apply_changes(pl, puw)) {
		// Changes applied directly, we're done
		sp_playlist_release(pl);
		sp_link_release(plink);
		return 1;
	}

	fprintf(stderr, "Playlist not yet loaded, waiting...\n");
	sp_playlist_add_callbacks(pl, &pl_update_callbacks, puw);
	sp_link_release(plink);
	return 0;
}

static const char *offlinestatus[] = {
	"None",         // SP_PLAYLIST_OFFLINE_STATUS_NO
	"Synchronized", // SP_PLAYLIST_OFFLINE_STATUS_YES
	"Downloading",  // SP_PLAYLIST_OFFLINE_STATUS_DOWNLOADING
	"Waiting",      // SP_PLAYLIST_OFFLINE_STATUS_WAITING
};


int cmd_playlist_offline(int argc, char **argv)
{
	sp_link *plink;
	sp_playlist *pl;
	int on;

	if (argc == 2 && !strcmp(argv[1], "status")) {
		printf("Offline status\n");
		printf("  %d tracks to sync\n",
		    sp_offline_tracks_to_sync(g_session));
		printf("  %d offline playlists in total\n",
		    sp_offline_num_playlists(g_session));
		return 1;
	}


	if (argc != 3) {
		printf("offline status | <playlist uri> <on|off>\n");
		return 1;
	}


	plink = sp_link_create_from_string(argv[1]);
	if (!plink) {
		fprintf(stderr, "%s is not a spotify link\n", argv[1]);
		return -1;
	}

	if (sp_link_type(plink) != SP_LINKTYPE_PLAYLIST) {
		fprintf(stderr, "%s is not a playlist link\n", argv[1]);
		sp_link_release(plink);
		return -1;
	}


	pl = sp_playlist_create(g_session, plink);

	if (argc == 3) {

		if (!strcasecmp(argv[2], "on"))
			on = 1;
		else if (!strcasecmp(argv[2], "off"))
			on = 0;
		else {
			fprintf(stderr, "Invalid mode: %s\n", argv[2]);
			return -1;
		}

		sp_playlist_set_offline_mode(g_session, pl, on);

	} else {

		sp_playlist_offline_status s;
		s = sp_playlist_get_offline_status(g_session, pl);

		printf("Offline status for %s (%s)\n",
		    argv[1], sp_playlist_name(pl));

		printf("  Status: %s\n", offlinestatus[s]);
		if (s == SP_PLAYLIST_OFFLINE_STATUS_DOWNLOADING)
			printf("    %d%% Complete\n",
			    sp_playlist_get_offline_download_completed(g_session, pl));
	}

	sp_playlist_release(pl);
	sp_link_release(plink);
	return 1;
}


================================================
FILE: libspotify/examples/spshell/scrobbling.c
================================================
/**
 * Copyright (c) 2006-2012 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 */

#include "spshell.h"
#include <string.h>

void print_scrobbling_state(sp_scrobbling_state state) {
	if (state == SP_SCROBBLING_STATE_LOCAL_ENABLED)
		printf("locally overridden, enabled");
	else if (state == SP_SCROBBLING_STATE_LOCAL_DISABLED)
		printf("locally overridden, disabled");
	else if (state == SP_SCROBBLING_STATE_GLOBAL_ENABLED)
		printf("globally set, enabled");
	else if (state == SP_SCROBBLING_STATE_GLOBAL_DISABLED)
		printf("globally set, disabled");
	else
		printf("<unknown>");
}


int cmd_facebook_scrobbling(int argc, char **argv)
{
	if(argc != 2) {
		fprintf(stderr, "facebook scrobbling local override enable|disable|unset\n");
		return -1;
	}

	sp_scrobbling_state state = SP_SCROBBLING_STATE_USE_GLOBAL_SETTING;
	if (strcmp(argv[1], "unset")) {
		// not "unset"
		bool enable = !strcmp(argv[1], "enable");
		state = enable ? SP_SCROBBLING_STATE_LOCAL_ENABLED : SP_SCROBBLING_STATE_LOCAL_DISABLED;
	}
	sp_session_set_scrobbling(g_session, SP_SOCIAL_PROVIDER_FACEBOOK, state);

	return 1;
}

int cmd_is_facebook_scrobbling(int argc, char **argv)
{
	printf("facebook scrobbling state is ");
	sp_scrobbling_state state;
	sp_session_is_scrobbling(g_session, SP_SOCIAL_PROVIDER_FACEBOOK, &state);
	print_scrobbling_state(state);
	printf("\n");
	return 1;
}

int cmd_spotify_social(int argc, char **argv)
{
	if(argc != 2) {
		fprintf(stderr, "spotify social local override enable|disable|unset\n");
		return -1;
	}

	sp_scrobbling_state state = SP_SCROBBLING_STATE_USE_GLOBAL_SETTING;
	if (strcmp(argv[1], "unset")) {
		// not "unset"
		bool enable = !strcmp(argv[1], "enable");
		state = enable ? SP_SCROBBLING_STATE_LOCAL_ENABLED : SP_SCROBBLING_STATE_LOCAL_DISABLED;
	}
	sp_session_set_scrobbling(g_session, SP_SOCIAL_PROVIDER_SPOTIFY, state);

	return 1;
}

int cmd_is_spotify_social(int argc, char **argv)
{
	printf("spotify social scrobbling state is ");
	sp_scrobbling_state state;
	sp_session_is_scrobbling(g_session, SP_SOCIAL_PROVIDER_SPOTIFY, &state);
	print_scrobbling_state(state);
	printf("\n");
	return 1;
}

int cmd_set_lastfm_scrobbling_credentials(int argc, char **argv)
{
	if(argc != 3) {
		fprintf(stderr, "lastfm_scrobbling_credentials username password\n");
		return -1;
	}

	sp_session_set_social_credentials(g_session, SP_SOCIAL_PROVIDER_LASTFM, argv[1], argv[2]);
	return 1;
}

int cmd_lastfm_scrobbling(int argc, char **argv)
{
	if(argc != 2) {
		fprintf(stderr, "lastfm_scrobbling enable|disable\n");
		return -1;
	}

	bool enable = !strcmp(argv[1], "enable");
	sp_scrobbling_state state = enable ? SP_SCROBBLING_STATE_LOCAL_ENABLED : SP_SCROBBLING_STATE_LOCAL_DISABLED;

	sp_session_set_scrobbling(g_session, SP_SOCIAL_PROVIDER_LASTFM, state);
	return 1;
}

int cmd_is_lastfm_scrobbling(int argc, char **argv)
{
	printf("lastfm scrobbling state is ");
	sp_scrobbling_state state;
	sp_session_is_scrobbling(g_session, SP_SOCIAL_PROVIDER_LASTFM, &state);

	if (state == SP_SCROBBLING_STATE_LOCAL_ENABLED)
		printf("enabled");
	else if (state == SP_SCROBBLING_STATE_LOCAL_DISABLED)
		printf("disabled");
	else
		printf("<unknown>");

	printf("\n");
	return 1;
}

extern int cmd_private_session(int argc, char** argv)
{
	if(argc != 2) {
		fprintf(stderr, "private_session enable|disable\n");
		return -1;
	}

	sp_session_set_private_session(g_session, !strcmp(argv[1], "enable"));
	return 1;
}

extern int cmd_is_private_session(int argc, char** argv)
{
	printf("private_session is ");
	printf( sp_session_is_private_session(g_session) ? "enabled" : "disabled");
	printf("\n");
	return 1;
}



================================================
FILE: libspotify/examples/spshell/search.c
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 */

#include <string.h>

#include "spshell.h"
#include "cmd.h"


/**
 * Print the given album metadata
 *
 * @param  album  The album object
 */
static void print_album(sp_album *album)
{
	printf("  Album \"%s\" (%d)\n",
	       sp_album_name(album),
	       sp_album_year(album));
}

/**
 * Print the given artist metadata
 *
 * @param  artist  The artist object
 */
static void print_artist(sp_artist *artist)
{
	printf("  Artist \"%s\"\n", sp_artist_name(artist));
}

/**
 * Print the given search result with as much information as possible
 *
 * @param  search   The search result
 */
static void print_search(sp_search *search)
{
	int i;

	printf("Query          : %s\n", sp_search_query(search));
	printf("Did you mean   : %s\n", sp_search_did_you_mean(search));
	printf("Tracks in total: %d\n", sp_search_total_tracks(search));
	puts("");

	for (i = 0; i < sp_search_num_tracks(search); ++i)
		print_track(sp_search_track(search, i));

	puts("");

	for (i = 0; i < sp_search_num_albums(search); ++i)
		print_album(sp_search_album(search, i));

	puts("");

	for (i = 0; i < sp_search_num_artists(search); ++i)
		print_artist(sp_search_artist(search, i));

	puts("");

	for (i = 0; i < sp_search_num_playlists(search); ++i) {
		// print some readily available metadata, the rest will
		// be available from the sp_playlist object loaded through
		// sp_search_playlist().
		printf("  Playlist \"%s\"\n", sp_search_playlist_name(search, i));
	}
}

/**
 * Callback for libspotify
 *
 * @param browse    The browse result object that is now done
 * @param userdata  The opaque pointer given to sp_artistbrowse_create()
 */
static void SP_CALLCONV search_complete(sp_search *search, void *userdata)
{
	if (sp_search_error(search) == SP_ERROR_OK)
		print_search(search);
	else
		fprintf(stderr, "Failed to search: %s\n",
		        sp_error_message(sp_search_error(search)));

	sp_search_release(search);
	cmd_done();
}



/**
 *
 */
static void search_usage(void)
{
	fprintf(stderr, "Usage: search <query>\n");
}


/**
 *
 */
int cmd_search(int argc, char **argv)
{
	char query[1024];
	int i;

	if (argc < 2) {
		search_usage();
		return -1;
	}

	query[0] = 0;
	for(i = 1; i < argc; i++)
		snprintf(query + strlen(query), sizeof(query) - strlen(query), "%s%s",
			 i == 1 ? "" : " ", argv[i]);

	sp_search_create(g_session, query, 0, 100, 0, 100, 0, 100, 0, 100, SP_SEARCH_STANDARD, &search_complete, NULL);
	return 0;
}


/**
 *
 */
int cmd_whatsnew(int argc, char **argv)
{
	sp_search_create(g_session, "tag:new", 0, 0, 0, 250, 0, 0, 0, 0, SP_SEARCH_STANDARD, &search_complete, NULL);
	return 0;
}


================================================
FILE: libspotify/examples/spshell/spshell.c
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 */

#include <string.h>

#include "spshell.h"
#include "cmd.h"

sp_session *g_session;
void (*metadata_updated_fn)(void);
int is_logged_out;
int log_to_stderr;
int g_selftest;


/**
 * This callback is called when the user was logged in, but the connection to
 * Spotify was dropped for some reason.
 *
 * @sa sp_session_callbacks#connection_error
 */
static void SP_CALLCONV connection_error(sp_session *session, sp_error error)
{
	fprintf(stderr, "Connection to Spotify failed: %s\n",
	                sp_error_message(error));
}

/**
 * This callback is called when an attempt to login has succeeded or failed.
 *
 * @sa sp_session_callbacks#logged_in
 */
static void SP_CALLCONV logged_in(sp_session *session, sp_error error)
{
	sp_user *me;
	const char *display_name, *username;
	int cc;

	if (SP_ERROR_OK != error) {
		fprintf(stderr, "failed to log in to Spotify: %s\n",
		                sp_error_message(error));
		sp_session_release(session);
		exit(4);
	}

	// Let us print the nice message...
	me = sp_session_user(session);
	display_name = (sp_user_is_loaded(me) ? sp_user_display_name(me) : sp_user_canonical_name(me));
	username = sp_session_user_name (session);
	cc = sp_session_user_country(session);
	fprintf(stderr, "Logged in to Spotify as user %s [%s] (registered in country: %c%c)\n", username, display_name, cc >> 8, cc & 0xff);

#if WITH_TEST_COMMAND
	if(g_selftest)
		cmd_test(0, NULL);
	else
#endif
		start_prompt();
}

/**
 * This callback is called when the session has logged out of Spotify.
 *
 * @sa sp_session_callbacks#logged_out
 */
static void SP_CALLCONV logged_out(sp_session *session)
{
	is_logged_out = 1;  // Will exit mainloop
}

#ifdef SP_LIBSPOTIFY_WITH_SCROBBLING
/**
 * This callback is called when there is a scrobble error.
 *
 * @sa sp_session_callbacks#scrobble_error
 */
static void SP_CALLCONV scrobble_error(sp_session* session, sp_error error) {
	fprintf(stderr, "Scrobble failure: %d\n", error);
}

/**
 * Called when there is a change in the private session mode
 *
 * @param[in]  session    Session
 * @param[in]  isPrivate  True if in private session, false otherwhise
 */
static void SP_CALLCONV private_session_mode_changed(sp_session *session, bool is_private) {
	printf("private session mode changed: %d\n", is_private);
}
#endif

/**
 * This callback is called when the session have recieved a credential
 * that could be stored safely on disk
 *
 * @sa sp_session_callbacks#credentials_blob_updated
 */
static void SP_CALLCONV credentials_blob_updated(sp_session *session, const char *blob)
{
	printf("blob for storage: %s\n", blob);
}

/**
 * This callback is called for log messages.
 *
 * @sa sp_session_callbacks#log_message
 */
static void SP_CALLCONV log_message(sp_session *session, const char *data)
{
	if (log_to_stderr)
		fprintf(stderr, "%s", data);
}



/**
 * Callback called when libspotify has new metadata available
 *
 * Not used in this example (but available to be able to reuse the session.c file
 * for other examples.)
 *
 * @sa sp_session_callbacks#metadata_updated
 */
static void SP_CALLCONV metadata_updated(sp_session *sess)
{
	if(metadata_updated_fn)
		metadata_updated_fn();
#if WITH_TEST_COMMAND
	if(g_selftest)
		test_process();
#endif
}


/**
 *
 */
static void SP_CALLCONV offline_status_updated(sp_session *sess)
{
	sp_offline_sync_status status;
	sp_offline_sync_get_status(sess, &status);
	if(status.syncing) {
		printf("Offline status: queued:%d:%zd done:%d:%zd copied:%d:%zd nocopy:%d err:%d\n",
		    status.queued_tracks,
		    (size_t)status.queued_bytes,
		    status.done_tracks,
		    (size_t)status.done_bytes,
		    status.copied_tracks,
		    (size_t)status.copied_bytes,
		    status.willnotcopy_tracks,
		    status.error_tracks);
	} else {
		printf("Offline status: Idle\n");
	}
}

/**
 * Session callbacks
 */

static sp_session_callbacks callbacks;

/**
 *
 */
int spshell_init(const char *username, const char *password, const  char *blob, int selftest)
{
	sp_session_config config;
	sp_error error;
	sp_session *session;

        /// The application key is specific to each project, and allows Spotify
        /// to produce statistics on how our service is used.
	extern const char g_appkey[];
        /// The size of the application key.
	extern const size_t g_appkey_size;

	g_selftest = selftest;

	memset(&config, 0, sizeof(config));

	// Always do this. It allows libspotify to check for
	// header/library inconsistencies.
	config.api_version = SPOTIFY_API_VERSION;

	// The path of the directory to store the cache. This must be specified.
	// Please read the documentation on preferred values.
	config.cache_location = selftest ? "" : "tmp";

	// The path of the directory to store the settings. 
	// This must be specified.
	// Please read the documentation on preferred values.
	config.settings_location = selftest ? "" : "tmp";

	// The key of the application. They are generated by Spotify,
	// and are specific to each application using libspotify.
	config.application_key = g_appkey;
	config.application_key_size = g_appkey_size;

	// This identifies the application using some
	// free-text string [1, 255] characters.
	config.user_agent = "spshell";


	// Register the callbacks.
	callbacks.logged_in = logged_in;
	callbacks.logged_out = logged_out;
	callbacks.metadata_updated = metadata_updated;
	callbacks.connection_error = connection_error;
	callbacks.notify_main_thread = notify_main_thread;
#if WITH_TEST_COMMAND
	callbacks.music_delivery = music_delivery;
	callbacks.play_token_lost = play_token_lost;
	callbacks.end_of_track = end_of_track;
#endif
	callbacks.log_message = log_message;
	callbacks.offline_status_updated = offline_status_updated;
	callbacks.credentials_blob_updated = credentials_blob_updated;
#ifdef SP_LIBSPOTIFY_WITH_SCROBBLING
	callbacks.scrobble_error = scrobble_error;
	callbacks.private_session_mode_changed = private_session_mode_changed;
#endif
	config.callbacks = &callbacks;

	error = sp_session_create(&config, &session);
	if (SP_ERROR_OK != error) {
		fprintf(stderr, "failed to create session: %s\n",
		                sp_error_message(error));
		return 2;
	}

	// Login using the credentials given on the command line.
	if (username == NULL) {
		char reloginname[256];

		if (sp_session_relogin(session) == SP_ERROR_NO_CREDENTIALS) {
			fprintf(stderr, "No stored credentials\n");
			return 3;
		}
		sp_session_remembered_user(session, reloginname, sizeof(reloginname));
		fprintf(stderr, "Trying to relogin as user %s\n", reloginname);

	} else {
		sp_session_login(session, username, password, 1, blob);
	}

	g_session = session;
	return 0;
}


/**
 *
 */
int cmd_logout(int argc, char **argv)
{
	if(argc == 2 && !strcmp(argv[1], "permanent")) {
		fprintf(stderr, "Dropping stored credentials\n");
		sp_session_forget_me(g_session);
	}
	sp_session_logout(g_session);
	return 0;
}


/**
 *
 */
void test_finished(void)
{
	cmd_logout(0, NULL);
}

/**
 *
 */
int cmd_log(int argc, char **argv)
{
	if(argc != 2) {
		fprintf(stderr, "log enable|disable\n");
		return -1;
	}

	log_to_stderr = !strcmp(argv[1], "enable");
	return 1;
}


================================================
FILE: libspotify/examples/spshell/spshell.h
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 */

#ifndef SPSHELL_H__
#define SPSHELL_H__

#include <stdlib.h>
#ifndef WIN32
#include <stdint.h>
#endif
#include <stdio.h>
#include <libspotify/api.h>

#define WITH_TEST_COMMAND 1

#if WIN32
#include <windows.h>
#define snprintf sprintf_s
#define strcasecmp lstrcmp
#endif 

#ifndef PRIx64
#define PRIx64 "llx"
#endif

#if USE_STRCMP
#define strcasecmp strcmp
#endif

extern sp_session *g_session;

extern void (*metadata_updated_fn)(void);

extern int spshell_init(const char *username, const char *password, const char *blob, int selftest);

extern void SP_CALLCONV notify_main_thread(sp_session *session);

extern void start_prompt(void);

extern sp_uint64 get_ts(void);

#if WITH_TEST_COMMAND

extern void test_finished(void);

extern void test_process(void);

extern void SP_CALLCONV end_of_track(sp_session *s);

extern int SP_CALLCONV music_delivery(sp_session *s, const sp_audioformat *fmt, const void *frames, int num_frames);

extern void SP_CALLCONV play_token_lost(sp_session *s);

#endif

#endif // SPSHELL_H__


================================================
FILE: libspotify/examples/spshell/spshell_posix.c
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 */

#include <unistd.h>
#include <pthread.h>
#include <stdio.h>
#include <string.h>
#include <sys/time.h>

#include <readline/readline.h>
#include <readline/history.h>

#include "spshell.h"
#include "cmd.h"

/// Set when libspotify want to process events
static int notify_events;

/// Synchronization mutex to protect various shared data
static pthread_mutex_t notify_mutex;

/// Synchronization condition variable for the main thread
static pthread_cond_t notify_cond;

/// Synchronization condition variable to disable prompt temporarily
static pthread_cond_t prompt_cond;

/// Command line to execute
static char *cmdline;

/// 
static int show_prompt;

extern int is_logged_out;

extern int g_selftest;

/**
 *
 */
static void *promptloop(void *aux)
{
	pthread_mutex_lock(&notify_mutex);

	while(1) {
		char *l;

		while(show_prompt == 0)
			pthread_cond_wait(&prompt_cond, &notify_mutex);

		pthread_mutex_unlock(&notify_mutex);
		l = readline("> ");
		pthread_mutex_lock(&notify_mutex);

		show_prompt = 0;
		cmdline = l;
		pthread_cond_signal(&notify_cond);
	}
	return NULL;
}


/**
 *
 */
void start_prompt(void)
{
	static pthread_t id;
	if (id)
		return;
	show_prompt = 1;
	pthread_create(&id, NULL, promptloop, NULL);
}



/**
 *
 */
static void trim(char *buf)
{
	size_t l = strlen(buf);
	while(l > 0 && buf[l - 1] < 32)
		buf[--l] = 0;
}


/**
 *
 */
int main(int argc, char **argv)
{
	const char *username = NULL;
	const char *blob = NULL;
	const char *password = NULL;
	int selftest = 0;
	char username_buf[256];
	int r;
	int next_timeout = 0;
	int ch;

	printf("Using libspotify %s\n", sp_build_id());
	r = 0;
	while ((ch = getopt(argc, argv, "tb:u:p:")) != -1) {

		switch (ch) {
		case 'u':
		  	username = optarg;
			break;
		case 'p':
		  	password = optarg;
			break;
		case 'b':
			blob = optarg;
			r +=2;
			break;
		case 't':
			selftest = 1;
			r++;
			break;
		default:
			break;
		}
	}

	if (username == NULL) {
		printf("Username (just press enter to login with stored credentials): ");
		fflush(stdout);
		fgets(username_buf, sizeof(username_buf), stdin);
		trim(username_buf);
		if(username_buf[0] == 0) {
			username = NULL;
		} else {
			username = username_buf;
		}
	}

	// If a username was supplied but no blob, prompt for password
	if (username != NULL && password == NULL && blob == NULL)
		password = getpass("Password: ");

	pthread_mutex_init(&notify_mutex, NULL);
	pthread_cond_init(&notify_cond, NULL);
	pthread_cond_init(&prompt_cond, NULL);

	if ((r = spshell_init(username, password, blob, selftest)) != 0)
		exit(r);

	pthread_mutex_lock(&notify_mutex);

	while(!is_logged_out) {
		// Release prompt
		if (next_timeout == 0) {
			while(!notify_events && !cmdline)
				pthread_cond_wait(&notify_cond, &notify_mutex);
		} else {
			struct timespec ts;

#if _POSIX_TIMERS > 0
			clock_gettime(CLOCK_REALTIME, &ts);
#else
			struct timeval tv;
			gettimeofday(&tv, NULL);
			TIMEVAL_TO_TIMESPEC(&tv, &ts);
#endif

			ts.tv_sec += next_timeout / 1000;
			ts.tv_nsec += (next_timeout % 1000) * 1000000;
			if(ts.tv_nsec > 1000000000) {
				ts.tv_sec ++;
				ts.tv_nsec -= 1000000000;
			}


			while(!notify_events && !cmdline) {
				if(pthread_cond_timedwait(&notify_cond, &notify_mutex, &ts))
					break;
			}
		}

		// Process input from prompt
		if(cmdline) {
			char *l = cmdline;
			cmdline = NULL;
		
			pthread_mutex_unlock(&notify_mutex);
			cmd_exec_unparsed(l);
			free(l);
			pthread_mutex_lock(&notify_mutex);
		}

		// Process libspotify events
		notify_events = 0;
		pthread_mutex_unlock(&notify_mutex);

		do {
			sp_session_process_events(g_session, &next_timeout);
		} while (next_timeout == 0);

		if(g_selftest)
			test_process();

		pthread_mutex_lock(&notify_mutex);
	}
	printf("Logged out\n");
	sp_session_release(g_session);
	printf("Exiting...\n");
	return 0;
}

/**
 *
 */
void cmd_done(void)
{
	pthread_mutex_lock(&notify_mutex);
	show_prompt = 1;
	pthread_cond_signal(&prompt_cond);
	pthread_mutex_unlock(&notify_mutex);
}


/**
 *
 */
void notify_main_thread(sp_session *session)
{
	pthread_mutex_lock(&notify_mutex);
	notify_events = 1;
	pthread_cond_signal(&notify_cond);
	pthread_mutex_unlock(&notify_mutex);
}


/**
 *
 */
sp_uint64 get_ts(void)
{
	struct timeval tv;
	gettimeofday(&tv, NULL);
	return (int64_t)tv.tv_sec * 1000LL + (tv.tv_usec / 1000);
}


================================================
FILE: libspotify/examples/spshell/spshell_win32.c
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 */

#include "spshell.h"
#include "cmd.h"

static HANDLE events[2];

static int enable_console;
static char console_buf[1024];
static int console_ptr;

extern int is_logged_out;

extern int g_selftest;

/**
 * Very simplistic console input
 */
static void console_input(void)
{
	TCHAR inp;
	DWORD read;
	INPUT_RECORD rec;

	if(!ReadConsoleInput(events[1], &rec, 1, &read))
		return;

	if(read == 0)
		return;

	if(rec.EventType != KEY_EVENT)
		return;

	if(!rec.Event.KeyEvent.bKeyDown)
		return;

	inp = rec.Event.KeyEvent.uChar.AsciiChar;


	switch(inp) {
	case 8:
		if(console_ptr > 0) {
			console_ptr--;
			printf("\b \b");
		}
		break;
	case 13:
		printf("\n\r");
		console_buf[console_ptr++] = 0;
		console_ptr = 0;
		enable_console = 0;
		cmd_exec_unparsed(console_buf);
		break;

	default:
		if(console_ptr < sizeof(console_buf) - 1) {
			printf("%c", (char)inp);
			console_buf[console_ptr++] = inp;
		}
		break;
	}
}

static void trim(char *buf)
{
	size_t l = strlen(buf);
	while(l > 0 && buf[l - 1] < 32)
		buf[--l] = 0;
}


int __cdecl main(int argc, char **argv)
{
	const char *username = argc > 1 ? argv[1] : NULL;
	const char *blob = argc > 2 ? argv[2] : NULL;
	const char *password = NULL;
	int selftest = argc > 3 ? !strcmp(argv[3], "selftest") : 0;
	char username_buf[256];
	char password_buf[256];
	int r;
	int next_timeout = 0;
	DWORD ev;
	DWORD mode;

	events[0] = CreateEvent(NULL, FALSE, FALSE, NULL);
	events[1] = GetStdHandle(STD_INPUT_HANDLE);

	printf("Using libspotify %s\n", sp_build_id());

	if (username == NULL) {
		printf("Username: (just press enter to login with stored credentials): ");
		fflush(stdout);
		fgets(username_buf, sizeof(username_buf), stdin);
		trim(username_buf);
		if(username_buf[0] == 0) {
			username = NULL;
		} else {
			username = username_buf;
		}
	}

	// If a username was supplied but no blob, prompt for password
	if (username != NULL && blob == NULL) {
		printf("Password: ");
		fflush(stdout);

		if (!GetConsoleMode(events[1], &mode) ||
			!SetConsoleMode(events[1], mode & ~ENABLE_ECHO_INPUT)) {
			printf("Unable to set console mode err=%d\n", GetLastError());
			exit(1);
		}

		fgets(password_buf, sizeof(password_buf), stdin);
		trim(password_buf);
		password = password_buf;
		printf("\r\n");
	}

	if ((r = spshell_init(username, password, blob, selftest)) != 0)
		exit(r);

	if (!SetConsoleMode(events[1], ENABLE_PROCESSED_INPUT)) {
		printf("Unable to set console mode err=%d\n", GetLastError());
		exit(1);
	}

	while(!is_logged_out) {
		ev = WaitForMultipleObjects(1 + enable_console, events, FALSE, next_timeout > 0 ? next_timeout : INFINITE);
		switch (ev) {
		case WAIT_OBJECT_0 + 0:
		case WAIT_TIMEOUT:
			do {
				sp_session_process_events(g_session, &next_timeout);
			} while (next_timeout == 0);

			if(g_selftest)
				test_process();
			break;

		case WAIT_OBJECT_0 + 1:
			console_input();
			break;
		}
	}
	printf("Logged out\n");
	sp_session_release(g_session);
	printf("Exiting...\n");
	return 0;
}

/**
 *
 */
void cmd_done(void)
{
	enable_console = 1;
	printf("> ");
	fflush(stdout);
}


/**
 *
 */
void start_prompt(void)
{
	cmd_done();
}


/**
 *
 */
void SP_CALLCONV notify_main_thread(sp_session *session)
{
	SetEvent(events[0]);
}

/**
 *
 */
sp_uint64 get_ts(void)
{
	return GetTickCount();
}


================================================
FILE: libspotify/examples/spshell/star.c
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 */

#include "spshell.h"
#include "cmd.h"

/**
 *
 */
static void star_usage(const char *prefix)
{
	fprintf(stderr, "Usage: %sstar <track-uri>\n", prefix);
}


/**
 *
 */
static int dostar(int argc, char **argv, int set)
{
	sp_link *link;
	sp_track *track;

	if (argc != 2) {
		star_usage(set ? "" : "un");
		return -1;
	}
	
	link = sp_link_create_from_string(argv[1]);
	
	if (!link) {
		fprintf(stderr, "Not a spotify link\n");
		return -1;
	}

	if (sp_link_type(link) != SP_LINKTYPE_TRACK) {
		fprintf(stderr, "Not a track link\n");
		sp_link_release(link);
		return -1;
	}

	track = sp_link_as_track(link);
	sp_track_set_starred(g_session, &track, 1, set);
	sp_link_release(link);
	return -1;
}


/**
 *
 */
int cmd_star(int argc, char **argv)
{
	return dostar(argc, argv, 1);
}


/**
 *
 */
int cmd_unstar(int argc, char **argv)
{
	return dostar(argc, argv, 0);
}

/**
 *
 */
int cmd_starred(int argc, char **argv)
{
	sp_playlist *starred;
	if (argc > 1) {
		starred = sp_session_starred_for_user_create(g_session, argv[1]);
	} else {
		starred = sp_session_starred_create(g_session);
	}
	if (starred) {
		browse_playlist(starred);
	} else {
		printf("Starred not loaded\n");
	}
	
	return 1;
}


================================================
FILE: libspotify/examples/spshell/test.c
================================================
/**
 * Copyright (c) 2006-2011 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 */
#include <stdarg.h>
#include <stdio.h>
#include <string.h>

#if __APPLE__ || __linux__
#include <sys/resource.h>
#endif // __APPLE__ || __linux__

#include "spshell.h"
#include "cmd.h"

#define STRINGIFY(s) TOSTRING(s)
#define TOSTRING(s) #s



enum msglevel {
	MSG_ERROR,
	MSG_INFO,
	MSG_OK,
};

#if WIN32
const char *dec_by_level[] = {
	"",
	"",
	""
};
static const char *decorate_clr = "";
#else
const char *dec_by_level[] = {
	"\033[31m",
	"\033[36m",
	"\033[32m"
};
static const char *decorate_clr   = "\033[0m";
#endif

typedef struct Test {
	// Initialized by TEST_DECL
	const char *title;
	int maxtime;
	int arg1;
	int arg2;
	int arg3;

	// Other members
	struct Test *next;
	sp_uint64 start;
	int duration;
	int done;
} Test;

static struct Test *active_tests;




#define TEST_DECL(title,maxtime) Test title = { STRINGIFY(title), maxtime }
#define TEST_DECL3(title,maxtime, a) Test title = { STRINGIFY(title), maxtime, a }
#define TEST_DECL4(title,maxtime, a,b) Test title = { STRINGIFY(title), maxtime, a,b }
#define TEST_DECL5(title,maxtime, a,b,c) Test title = { STRINGIFY(title), maxtime, a,b,c }

void test_activate(struct Test *t)
{
	t->next = active_tests;
	active_tests = t;
}


void test_list_active(void)
{
	struct Test *t;
	for(t = active_tests; t != NULL; t = t->next)
		printf("%s\n", t->title);
}


void output(enum msglevel level, const char *fmt, ...)
{
	char msg[512];
	va_list ap;

	va_start(ap, fmt);
	vsnprintf(msg, sizeof(msg), fmt, ap);
	va_end(ap);

	printf("%s%s%s\n", dec_by_level[level], msg, decorate_clr);

}

void test_deactivate(const struct Test * const t)
{
	struct Test *l, **p = &active_tests;

	while((l = *p) != NULL) {
		if(t == l) {
			*p = l->next;
			return;
		}
		p = &l->next;
	}
	output(MSG_ERROR, "Test %s not linked", t->title);
	abort();
}


static int test_done(Test *t, int backend_time)
{
	t->done++;

	if(t->done > 1) {
		output(MSG_ERROR, "%s: Finished multiple times (%d)", t->title, t->done);
		abort();
		return 1;
	}

	test_deactivate(t);

	t->duration = (int)(get_ts() - t->start);

	if(t->duration > t->maxtime * 1000) {
		char trailer[100];

		if(backend_time != -1) {
			snprintf(trailer, sizeof(trailer), ", %dms waiting for backend",
				 backend_time);
		} else {
			trailer[0] = 0;
		}
		output(MSG_ERROR, "%s: %d Time exceeded, limit is %dms%s",
		       t->title, t->duration, t->maxtime * 1000, trailer);
		return 1;
	}
	return 0;
}


static void test_ok(Test *t)
{
	if(test_done(t, -1))
		return;

	output(MSG_OK, "%s: %d OK", t->title, t->duration);
}


static void test_ok_backend_duration(Test *t, int backend_duration)
{
	char trailer[100];

	if(test_done(t, backend_duration))
		return;

	if(backend_duration == -1)
		strcpy(trailer, "Loaded from cache");
	else
		snprintf(trailer, sizeof(trailer), "%d ms backend request delay", backend_duration);

	output(MSG_OK, "%s: %d OK, %s", t->title, t->duration, trailer);
}

static void test_report(Test *t, const char *fmt, ...)
{
	char msg[512];
	va_list ap;
	int level;

	if(test_done(t, -1))
		return;

	level = MSG_ERROR;
	va_start(ap, fmt);
	vsnprintf(msg, sizeof(msg), fmt, ap);
	va_end(ap);

	output(level, "%s: %d %s", t->title, t->duration, msg);
}


#define info_report(fmt, ...) output(MSG_INFO, fmt, ##__VA_ARGS__)


static void test_start(Test *t)
{
	t->start = get_ts();
	test_activate(t);
}

/*****************************************************************
 * URI helpers
 */
static sp_artist *artist_from_uri(const char *uri)
{
	sp_artist *a;
	sp_link *l = sp_link_create_from_string(uri);
	if(sp_link_type(l) != SP_LINKTYPE_ARTIST) {
		sp_link_release(l);
		return NULL;
	}
	a = sp_link_as_artist(l);
	sp_artist_add_ref(a);
	sp_link_release(l);
	return a;
}


static sp_album *album_from_uri(const char *uri)
{
	sp_album *a;
	sp_link *l = sp_link_create_from_string(uri);
	if(sp_link_type(l) != SP_LINKTYPE_ALBUM) {
		sp_link_release(l);
		return NULL;
	}
	a = sp_link_as_album(l);
	sp_album_add_ref(a);
	sp_link_release(l);
	return a;
}


static sp_track *track_from_uri(const char *uri)
{
	sp_track *t;
	sp_link *l = sp_link_create_from_string(uri);
	if(sp_link_type(l) != SP_LINKTYPE_TRACK) {
		sp_link_release(l);
		return NULL;
	}
	t = sp_link_as_track(l);
	sp_track_add_ref(t);
	sp_link_release(l);
	return t;
}


/*****************************************************************
 * Search
 */
TEST_DECL(search1, 3);
TEST_DECL(search2, 3);
TEST_DECL(did_you_mean, 3);


static void SP_CALLCONV search1_cb(sp_search *result, void *userdata)
{
	if(!sp_search_is_loaded(result))
		test_report(userdata, "Result not loaded");
	else if(sp_search_error(result) != SP_ERROR_OK)
		test_report(userdata, "%s", sp_error_message(sp_search_error(result)));
	else if(sp_search_num_tracks(result) != 2)
		test_report(userdata, "Expected %d tracks got %d", 2, sp_search_num_tracks(result));
	else if(sp_search_total_tracks(result) < sp_search_num_tracks(result))
		test_report(userdata, "Total tracks (%d) less than number of tracks (%d)", sp_search_total_tracks(result), sp_search_num_tracks(result));
	else if(sp_search_num_albums(result) != 4)
		test_report(userdata, "Expected %d albums got %d", 4, sp_search_num_albums(result));
	else if(sp_search_total_albums(result) < sp_search_num_albums(result))
		test_report(userdata, "Total albums (%d) less than number of albums (%d)", sp_search_total_albums(result), sp_search_num_albums(result));
	else if(sp_search_num_artists(result) != 6)
		test_report(userdata, "Expected %d artists got %d", 6, sp_search_num_artists(result));
	else if(sp_search_total_artists(result) < sp_search_num_artists(result))
		test_report(userdata, "Total artists (%d) less than number of artists (%d)", sp_search_total_artists(result), sp_search_num_artists(result));
	else if(sp_search_num_playlists(result) != 8)
		test_report(userdata, "Expected %d playlists got %d", 8, sp_search_num_playlists(result));
	else if(sp_search_total_playlists(result) < sp_search_num_playlists(result))
		test_report(userdata, "Total playlists (%d) less than number of playlists (%d)", sp_search_total_playlists(result), sp_search_num_playlists(result));
	else {
		if (!sp_search_playlist_name(result, 1)) {
			test_report(userdata, "Expected a name for playlist #1");
		} else
			test_ok(userdata);
	}
	sp_search_release(result);
}


static void SP_CALLCONV search2_cb(sp_search *result, void *userdata)
{
	if(!sp_search_is_loaded(result))
		test_report(userdata, "Result not loaded");
	else if(sp_search_error(result) != SP_ERROR_OK)
		test_report(userdata, "%s", sp_error_message(sp_search_error(result)));
	else
		test_ok(userdata);
	sp_search_release(result);
}

static void SP_CALLCONV did_you_mean_cb(sp_search *result, void *userdata)
{
	if(!sp_search_is_loaded(result))
		test_report(userdata, "Result not loaded");
	else if(sp_search_error(result) != SP_ERROR_OK)
		test_report(userdata, "%s", sp_error_message(sp_search_error(result)));
	else if(strcmp(sp_search_did_you_mean(result), "madonna"))
		test_report(userdata, "Expected '%s' but got '%s'",
			    "madonna", sp_search_did_you_mean(result));
	else
		test_ok(userdata);
	sp_search_release(result);
}


static void search_test(void)
{
	test_start(&search1);
	sp_search_create(g_session, "madonna", 1,2,3,4,5,6,7,8, SP_SEARCH_STANDARD, search1_cb, &search1);

	test_start(&search2);
	sp_search_create(g_session, "madonna", 0,250,0,250,0,250, 0, 0, SP_SEARCH_STANDARD, search2_cb, &search2);

	test_start(&did_you_mean);
	sp_search_create(g_session, "madonnnna", 0,250,0,250,0,250, 0, 0, SP_SEARCH_STANDARD, did_you_mean_cb, &did_you_mean);
}


/*****************************************************************
 * Album browse
 */
TEST_DECL(browse_50th_law, 3);

static void SP_CALLCONV album_cb(sp_albumbrowse *result, void *userdata)
{
	if(!sp_albumbrowse_is_loaded(result))
		test_report(userdata, "Result not loaded");
	else if(sp_albumbrowse_error(result) != SP_ERROR_OK)
		test_report(userdata, "%s", sp_error_message(sp_albumbrowse_error(result)));
	else if(sp_albumbrowse_num_tracks(result) != 11)
		test_report(userdata, "Expected 11 tracks but got %d", sp_albumbrowse_num_tracks(result));
	else if(strcmp("Introduction - Excerpt",
		       sp_track_name(sp_albumbrowse_track(result, 0))))
		test_report(userdata, "Expected track #1 to be %s but got %s",
			    "Introduction - Excerpt",
			    sp_track_name(sp_albumbrowse_track(result, 0)));
	else if(strcmp("Confront Your Mortality – the Sublime - Excerpt",
		       sp_track_name(sp_albumbrowse_track(result, 10))))
		test_report(userdata, "Expected track #11 to be %s but got %s",
			    "Confront Your Mortality – the Sublime - Excerpt",
			    sp_track_name(sp_albumbrowse_track(result, 10)));
	else
		test_ok_backend_duration(userdata, sp_albumbrowse_backend_request_duration(result));
	sp_albumbrowse_release(result);
}



static void albumbrowse_test(void)
{
	sp_album *alb;
	test_start(&browse_50th_law);

	alb = album_from_uri("spotify:album:1kSXIcMv2voPwcjaJiUoC5");
	sp_albumbrowse_create(g_session, alb, album_cb, &browse_50th_law);
	sp_album_release(alb);
}


/*****************************************************************
 * Artist browse no albums
 */
TEST_DECL(browse_david_guetta, 3);
TEST_DECL(browse_adele, 3);
TEST_DECL(browse_veronica_maggio, 3);
TEST_DECL(browse_rihanna, 3);
TEST_DECL(browse_elvis, 3);


static void SP_CALLCONV no_albums_cb(sp_artistbrowse *result, void *userdata)
{
	if(!sp_artistbrowse_is_loaded(result))
		test_report(userdata, "Result not loaded");
	else if(sp_artistbrowse_error(result) != SP_ERROR_OK)
		test_report(userdata, "%s", sp_error_message(sp_artistbrowse_error(result)));
	else if(sp_artistbrowse_num_tracks(result))
		test_report(userdata, "Expected 0 tracks but got %d", sp_artistbrowse_num_tracks(result));
	else if(sp_artistbrowse_num_albums(result))
		test_report(userdata, "Expected 0 albums but got %d", sp_artistbrowse_num_albums(result));
	else
		test_ok_backend_duration(userdata, sp_artistbrowse_backend_request_duration(result));
	sp_artistbrowse_release(result);
}



static void artistbrowse_test(void)
{
	sp_artist *art;
	test_start(&browse_david_guetta);
	test_start(&browse_adele);
	test_start(&browse_veronica_maggio);
	test_start(&browse_rihanna);
	test_start(&browse_elvis);

	art = artist_from_uri("spotify:artist:1Cs0zKBU1kc0i8ypK3B9ai");
	sp_artistbrowse_create(g_session, art, SP_ARTISTBROWSE_NO_ALBUMS, no_albums_cb, &browse_david_guetta);
	sp_artist_release(art);

	art = artist_from_uri("spotify:artist:4dpARuHxo51G3z768sgnrY");
	sp_artistbrowse_create(g_session, art, SP_ARTISTBROWSE_NO_ALBUMS, no_albums_cb, &browse_adele);
	sp_artist_release(art);

	art = artist_from_uri("spotify:artist:2OIWxN9xUhgUHkeUCWCaNs");
	sp_artistbrowse_create(g_session, art, SP_ARTISTBROWSE_NO_ALBUMS, no_albums_cb, &browse_veronica_maggio);
	sp_artist_release(art);

	art = artist_from_uri("spotify:artist:5pKCCKE2ajJHZ9KAiaK11H");
	sp_artistbrowse_create(g_session, art, SP_ARTISTBROWSE_NO_ALBUMS, no_albums_cb, &browse_rihanna);
	sp_artist_release(art);

	art = artist_from_uri("spotify:artist:43ZHCT0cAZBISjO8DG9PnE");
	sp_artistbrowse_create(g_session, art, SP_ARTISTBROWSE_NO_ALBUMS, no_albums_cb, &browse_elvis);
	sp_artist_release(art);
}


/*****************************************************************
 * Artist browse no tracks
 */
TEST_DECL(browse_no_tracks_elvis, 10);


static void SP_CALLCONV no_tracks_cb(sp_artistbrowse *result, void *userdata)
{
	if(!sp_artistbrowse_is_loaded(result))
		test_report(userdata, "Result not loaded");
	else if(sp_artistbrowse_error(result) != SP_ERROR_OK)
		test_report(userdata, "%s", sp_error_message(sp_artistbrowse_error(result)));
	else if(sp_artistbrowse_num_tracks(result))
		test_report(userdata, "Expected 0 tracks but got %d", sp_artistbrowse_num_tracks(result));
	else
		test_ok_backend_duration(userdata, sp_artistbrowse_backend_request_duration(result));
	sp_artistbrowse_release(result);
}



static void artistbrowse_no_tracks_test(void)
{
	sp_artist *art;
	test_start(&browse_no_tracks_elvis);

	art = artist_from_uri("spotify:artist:43ZHCT0cAZBISjO8DG9PnE");
	sp_artistbrowse_create(g_session, art, SP_ARTISTBROWSE_NO_TRACKS, no_tracks_cb, &browse_no_tracks_elvis);
	sp_artist_release(art);
}



/*****************************************************************
 * Toplist browse
 */
TEST_DECL5(browse_toplist_artist_global, 3,  0,   0,   100);
TEST_DECL5(browse_toplist_album_global,  3,  0,   100, 0);
TEST_DECL5(browse_toplist_track_global,  3,  100, 0,   0);
TEST_DECL5(browse_toplist_artist_user,   3,  0,   0,   20);
TEST_DECL5(browse_toplist_album_user,    3,  0,   20,  0);
TEST_DECL5(browse_toplist_track_user,    3,  20,  0,   0);
TEST_DECL5(browse_toplist_artist_SE,     3,  0,   0,   100);
TEST_DECL5(browse_toplist_album_SE,      3,  0,   100, 0);
TEST_DECL5(browse_toplist_track_SE,      3,  100, 0,   0);
TEST_DECL5(browse_toplist_artist_US,     3,  0,   0,   100);
TEST_DECL5(browse_toplist_album_US,      3,  0,   100, 0);
TEST_DECL5(browse_toplist_track_US,      3,  100, 0,   0);

static void SP_CALLCONV toplist_cb(sp_toplistbrowse *result, void *userdata)
{
	const Test *t = userdata;
	if(!sp_toplistbrowse_is_loaded(result))
		test_report(userdata, "Result not loaded");
	else if(sp_toplistbrowse_error(result) != SP_ERROR_OK)
		test_report(userdata, "%s", sp_error_message(sp_toplistbrowse_error(result)));
	else if(t->arg1 != sp_toplistbrowse_num_tracks(result))
		test_report(userdata, "Expected %d tracks but got %d",
			    t->arg1, sp_toplistbrowse_num_tracks(result));
	else if(t->arg2 != sp_toplistbrowse_num_albums(result))
		test_report(userdata, "Expected %d albums but got %d",
			    t->arg2, sp_toplistbrowse_num_albums(result));
	else if(t->arg3 != sp_toplistbrowse_num_artists(result))
		test_report(userdata, "Expected %d artists but got %d",
			    t->arg3, sp_toplistbrowse_num_artists(result));
	else
		test_ok_backend_duration(userdata, sp_toplistbrowse_backend_request_duration(result));
	sp_toplistbrowse_release(result);
}



static void toplistbrowse_test(void)
{
	test_start(&browse_toplist_artist_global);
	test_start(&browse_toplist_album_global);
	test_start(&browse_toplist_track_global);

	test_start(&browse_toplist_artist_user);
	test_start(&browse_toplist_album_user);
	test_start(&browse_toplist_track_user);

	test_start(&browse_toplist_artist_SE);
	test_start(&browse_toplist_album_SE);
	test_start(&browse_toplist_track_SE);

	test_start(&browse_toplist_artist_US);
	test_start(&browse_toplist_album_US);
	test_start(&browse_toplist_track_US);

	sp_toplistbrowse_create(g_session, SP_TOPLIST_TYPE_ARTISTS,
				SP_TOPLIST_REGION_EVERYWHERE, NULL,
				toplist_cb, &browse_toplist_artist_global);

	sp_toplistbrowse_create(g_session, SP_TOPLIST_TYPE_ALBUMS,
				SP_TOPLIST_REGION_EVERYWHERE, NULL,
				toplist_cb, &browse_toplist_album_global);

	sp_toplistbrowse_create(g_session, SP_TOPLIST_TYPE_TRACKS,
				SP_TOPLIST_REGION_EVERYWHERE, NULL,
				toplist_cb, &browse_toplist_track_global);


	sp_toplistbrowse_create(g_session, SP_TOPLIST_TYPE_ARTISTS,
				SP_TOPLIST_REGION_USER, NULL,
				toplist_cb, &browse_toplist_artist_user);

	sp_toplistbrowse_create(g_session, SP_TOPLIST_TYPE_ALBUMS,
				SP_TOPLIST_REGION_USER, NULL,
				toplist_cb, &browse_toplist_album_user);

	sp_toplistbrowse_create(g_session, SP_TOPLIST_TYPE_TRACKS,
				SP_TOPLIST_REGION_USER, NULL,
				toplist_cb, &browse_toplist_track_user);



	sp_toplistbrowse_create(g_session, SP_TOPLIST_TYPE_ARTISTS,
				SP_TOPLIST_REGION('S', 'E'), NULL,
				toplist_cb, &browse_toplist_artist_SE);

	sp_toplistbrowse_create(g_session, SP_TOPLIST_TYPE_ALBUMS,
				SP_TOPLIST_REGION('S', 'E'), NULL,
				toplist_cb, &browse_toplist_album_SE);

	sp_toplistbrowse_create(g_session, SP_TOPLIST_TYPE_TRACKS,
				SP_TOPLIST_REGION('S', 'E'), NULL,
				toplist_cb, &browse_toplist_track_SE);


	sp_toplistbrowse_create(g_session, SP_TOPLIST_TYPE_ARTISTS,
				SP_TOPLIST_REGION('U', 'S'), NULL,
				toplist_cb, &browse_toplist_artist_US);

	sp_toplistbrowse_create(g_session, SP_TOPLIST_TYPE_ALBUMS,
				SP_TOPLIST_REGION('U', 'S'), NULL,
				toplist_cb, &browse_toplist_album_US);

	sp_toplistbrowse_create(g_session, SP_TOPLIST_TYPE_TRACKS,
				SP_TOPLIST_REGION('U', 'S'), NULL,
				toplist_cb, &browse_toplist_track_US);
}

/*****************************************************************
 * Radio
 */
#ifdef SP_WITH_RADIO

TEST_DECL(radio_artist,3);
TEST_DECL(radio_track,3);
TEST_DECL(radio_genre,3);


static void radio_cb(sp_radio *result, void *userdata)
{
	int num_tracks;
	sp_track* track;

	if(!sp_radio_is_loaded(result))
		test_report(userdata, "Result not loaded");
	else if(sp_radio_error(result) != SP_ERROR_OK)
		test_report(userdata, "%s", sp_error_message(sp_radio_error(result)));
	else {
		num_tracks=sp_radio_num_tracks(result);
		if (num_tracks>0) {
			track = sp_radio_track(result, num_tracks - 1);
			if ( track ) {
				test_ok(userdata);
			} else {
				test_report(userdata, "Can't get last track");
			}
		} else {
			test_report(userdata, "No tracks returned");
		}
	}
	sp_radio_release(result);
}

static void radio_test(void)
{
	sp_link* link;
	test_start(&radio_artist);
	link = sp_link_create_from_string("spotify:artist:6tbjWDEIzxoDsBA1FuhfPW"); // Madonna
	sp_radio_create_from_link(g_session, link, &radio_cb, &radio_artist);
	sp_link_release( link );

	test_start(&radio_track);
	link = sp_link_create_from_string("spotify:track:1z3ugFmUKoCzGsI6jdY4Ci"); // Like A Prayer
	sp_radio_create_from_link(g_session, link, &radio_cb, &radio_track);
	sp_link_release( link );

	test_start(&radio_genre);
	sp_radio_create_from_genre(g_session, SP_RADIO_GENRE_DANCE, &radio_cb, &radio_genre);
}

#endif
/*****************************************************************
 * Streaming test
 */

TEST_DECL(playtrack, 25);

static sp_track *stream_track;
static int stream_track_end;


/**
 * Callback from spotify session. Happen on different thread so we need to signal and wakeup
 */
void SP_CALLCONV end_of_track(sp_session *s)
{
	stream_track_end = 1;
	notify_main_thread(g_session);
	info_report("end of track");
}

/**
 * Callback from spotify session. Just consume all frames
 */
int SP_CALLCONV music_delivery(sp_session *s, const sp_audioformat *fmt, const void *frames, int num_frames)
{
	return num_frames;
}

/**
 * Callback from spotify session. Happen on different thread so we need to signal and wakeup
 */
void SP_CALLCONV play_token_lost(sp_session *s)
{
	stream_track_end = 2;
	notify_main_thread(g_session);
	info_report("Playtoken lost");
}


static void playtrack_test(void)
{
	sp_error err;
	test_start(&playtrack);
	if((err = sp_session_player_load(g_session, stream_track)) != SP_ERROR_OK) {
		test_report(&playtrack, "Unable to load track: %s",  sp_error_message(err));
		return;
	}
	info_report("Streaming '%s' by '%s' this will take a while", sp_track_name(stream_track),
		    sp_artist_name(sp_track_artist(stream_track, 0)));
	sp_session_player_play(g_session, 1);
}

static int check_streaming_done(void)
{
	if(stream_track_end == 2)
		test_report(&playtrack, "Playtoken lost");
	else if(stream_track_end == 1)
		test_ok(&playtrack);
	else
		return 0;
	stream_track_end = 0;
	return 1;
}

/*****************************************************************
 * Image loading
 */
TEST_DECL3(image1, 3, 4560901);
TEST_DECL3(image2, 3, 4920563);
TEST_DECL3(image3, 3, 4440836);
TEST_DECL3(image4, 3, 2202765);
TEST_DECL3(image5, 3, 3254083);
TEST_DECL3(image6, 3, 2595372);
TEST_DECL3(image7, 3, 10028876);
TEST_DECL3(image8, 3, 7017370);
TEST_DECL3(image9, 3, 3655831);

static void SP_CALLCONV image_cb(sp_image *image, void *userdata)
{
	Test *t = userdata;
	size_t size;
	const byte *data;
	int sum;
	size_t i;

	data = sp_image_data(image, &size);
	sum = size;
	for(i = 0; i < size; i++)
		sum += data[i];

	sp_image_release(image);
	if(sum != t->arg1)
		test_report(userdata, "Invalid checksum");
	else
		test_ok(userdata);
}


static void load_image(Test *t, const char *uri)
{
	sp_link *l;
	sp_image *img;

	test_start(t);

	l = sp_link_create_from_string(uri);
	img = sp_image_create_from_link(g_session, l);
	sp_image_add_load_callback(img, image_cb, t);
	sp_link_release(l);

}

static void image_test(void)
{
	load_image(&image1, "spotify:image:34062b6f0168af33b9cd80c630a38f5de183f936");
	load_image(&image2, "spotify:image:654873a4d6a648f24055a5faec324aa2a80a997d");
	load_image(&image3, "spotify:image:5a9b36ac716b1178dc35bd05db96a34eafb77ad4");
	load_image(&image4, "spotify:image:564ce92718a792307f40634cb3225f0e91d7965b");
	load_image(&image5, "spotify:image:67b169a8a8df439437df7424ccd5dd7b7d88fca8");
	load_image(&image6, "spotify:image:b05e1aaf5824c9e4736b5d7b173aec5fdd4e6a4e");
	load_image(&image7, "spotify:image:0f44e39b1e7c21701640bb5ad035efde02b6aeeb");
	load_image(&image8, "spotify:image:c588570590c7d76670efad294424b991ddde17a0");
	load_image(&image9, "spotify:image:53a580c6e3e314838dcbc2ed97ebebb54a25693e");
}




/*********************************************************************************
 * State machine
 */
#define WAIT_FOR_TEST(t) state = __LINE__; case __LINE__: if(!(t)->done) return
#define WAIT_FOR(expr)   state = __LINE__; case __LINE__: if(!(expr)) return

static void print_resource_usage()
{
#if __APPLE__ || __linux__
	struct rusage r_usage;
	int res;

	res = getrusage(RUSAGE_SELF, &r_usage);
	if (res == 0) {
		printf("getrusage() returned:\n");

#if __APPLE__
#define TV_USEC_FORMAT "d"
#elif __linux__
#define TV_USEC_FORMAT "ld"
#endif
		printf("  User time:   %ld.%03" TV_USEC_FORMAT "s\n", r_usage.ru_utime.tv_sec, r_usage.ru_utime.tv_usec / 1000);
		printf("  System time: %ld.%03" TV_USEC_FORMAT "s\n", r_usage.ru_stime.tv_sec, r_usage.ru_stime.tv_usec / 1000);
#undef TV_USEC_FORMAT

#if __APPLE__
#define MAXRSS_UNITS "bytes"
#elif __linux__
#define MAXRSS_UNITS "kilobytes"
#endif
		printf("  Peak memory usage: %ld " MAXRSS_UNITS " (ru_maxrss)\n", r_usage.ru_maxrss); // integral max resident set size
#undef MAXRSS_UNITS

	} else {
		perror("getrusage() failed");
	}
#endif // __APPLE__ || __linux__
}

/**
 *
 */
void test_process(void)
{
	static int state;
	switch(state) {
	case 0:
		search_test();
		WAIT_FOR(!active_tests);

		albumbrowse_test();
		WAIT_FOR(!active_tests);

		artistbrowse_test();
		WAIT_FOR(!active_tests);

		artistbrowse_no_tracks_test();
		WAIT_FOR(!active_tests);

		image_test();
		WAIT_FOR(!active_tests);

		toplistbrowse_test();
		WAIT_FOR(!active_tests);

#ifdef SP_WITH_RADIO
		radio_test();
		WAIT_FOR(!active_tests);
#endif

		info_report("Loading %s", "spotify:track:5iIeIeH3LBSMK92cMIXrVD");
		stream_track = track_from_uri("spotify:track:5iIeIeH3LBSMK92cMIXrVD");
		WAIT_FOR(sp_track_is_loaded(stream_track));

		playtrack_test();

		WAIT_FOR(check_streaming_done());
		WAIT_FOR(!active_tests);
		sp_track_release(stream_track);

		state = -1;
		test_finished();
		print_resource_usage();
	}
}


int cmd_test(int argc, char **argv)
{
	extern int g_selftest;
	g_selftest = 1;
	test_process();
	return -1;
}


================================================
FILE: libspotify/examples/spshell/toplist.c
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 */

#include <string.h>

#include "spshell.h"
#include "cmd.h"

/**
 *
 */
static void print_album(int index, sp_album *album)
{
	printf("  Album %3d: \"%s\" by \"%s\"\n", index, sp_album_name(album), 
	       sp_artist_name(sp_album_artist(album)));
}

/**
 *
 */
static void print_artist(int index, sp_artist *artist)
{
	sp_link *l;
	char url[200];
	printf("  Artist %3d: \"%s\"\n", index, sp_artist_name(artist));

	l = sp_link_create_from_artist_portrait(artist, SP_IMAGE_SIZE_NORMAL);
	if(l != NULL) {
		sp_link_as_string(l, url, sizeof(url));
		printf("    Portrait: %s\n", url);
		sp_link_release(l);
	}
}


/**
 * Callback for libspotify
 *
 * @param result    The toplist result object that is now done
 * @param userdata  The opaque pointer given to sp_toplistbrowse_create()
 */
static void SP_CALLCONV got_toplist(sp_toplistbrowse *result, void *userdata)
{
	int i;

	// We print from all types. Only one of the loops will acually yield anything.

	for(i = 0; i < sp_toplistbrowse_num_artists(result); i++)
		print_artist(i + 1, sp_toplistbrowse_artist(result, i));

	for(i = 0; i < sp_toplistbrowse_num_albums(result); i++)
		print_album(i + 1, sp_toplistbrowse_album(result, i));

	for(i = 0; i < sp_toplistbrowse_num_tracks(result); i++) {
		printf("%3d: ", i + 1);
		print_track(sp_toplistbrowse_track(result, i));
	}

	sp_toplistbrowse_release(result);
	cmd_done();
}



/**
 *
 */
static void toplist_usage(void)
{
	fprintf(stderr, "Usage: toplist (tracks | albums | artists) (global | region <countrycode> | user)\n");
}

/**
 *
 */
int cmd_toplist(int argc, char **argv)
{
	sp_toplisttype type;
	sp_toplistregion region;

	if(argc < 3) {
		toplist_usage();
		return -1;
	}

	if(!strcasecmp(argv[1], "artists"))
		type = SP_TOPLIST_TYPE_ARTISTS;
	else if(!strcasecmp(argv[1], "albums"))
		type = SP_TOPLIST_TYPE_ALBUMS;
	else if(!strcasecmp(argv[1], "tracks"))
		type = SP_TOPLIST_TYPE_TRACKS;
	else {
		toplist_usage();
		return -1;
	}


	if(!strcasecmp(argv[2], "global"))
		region = SP_TOPLIST_REGION_EVERYWHERE;
	else if(!strcasecmp(argv[2], "user"))
		region = SP_TOPLIST_REGION_USER;
	else if(!strcasecmp(argv[2], "region")) {

		if(argc != 4 || strlen(argv[3]) != 2) {
			toplist_usage();
			return -1;
		}
		region = SP_TOPLIST_REGION(argv[3][0], argv[3][1]);
	} else {
		toplist_usage();
		return -1;
	}

	sp_toplistbrowse_create(g_session, type, region, NULL, got_toplist, NULL);
	return 0;
}


================================================
FILE: libspotify/examples/spshell/win32/spshell.vcproj
================================================
<?xml version="1.0" encoding="UTF-8"?>
<VisualStudioProject
	ProjectType="Visual C++"
	Version="9,00"
	Name="spshell"
	ProjectGUID="{6C49596C-977E-4BB6-BC94-123AEB5E2724}"
	Keyword="Win32Proj"
	TargetFrameworkVersion="131072"
	>
	<Platforms>
		<Platform
			Name="Win32"
		/>
	</Platforms>
	<ToolFiles>
	</ToolFiles>
	<Configurations>
		<Configuration
			Name="Debug|Win32"
			OutputDirectory="Debug"
			IntermediateDirectory="Debug"
			ConfigurationType="1"
			>
			<Tool
				Name="VCPreBuildEventTool"
			/>
			<Tool
				Name="VCCustomBuildTool"
			/>
			<Tool
				Name="VCXMLDataGeneratorTool"
			/>
			<Tool
				Name="VCWebServiceProxyGeneratorTool"
			/>
			<Tool
				Name="VCMIDLTool"
			/>
			<Tool
				Name="VCCLCompilerTool"
				Optimization="0"
				AdditionalIncludeDirectories="&quot;$(LIBSPOTIFY)\include&quot;;..\..\..\include"
				PreprocessorDefinitions="WIN32;_DEBUG;_CONSOLE;"
				MinimalRebuild="true"
				BasicRuntimeChecks="3"
				RuntimeLibrary="3"
				UsePrecompiledHeader="0"
				WarningLevel="3"
				Detect64BitPortabilityProblems="false"
				DebugInformationFormat="3"
				CallingConvention="2"
			/>
			<Tool
				Name="VCManagedResourceCompilerTool"
			/>
			<Tool
				Name="VCResourceCompilerTool"
			/>
			<Tool
				Name="VCPreLinkEventTool"
			/>
			<Tool
				Name="VCLinkerTool"
				AdditionalDependencies="libspotify.lib"
				LinkIncremental="2"
				AdditionalLibraryDirectories="&quot;$(LIBSPOTIFY)\lib&quot;;..\..\..\lib"
				GenerateDebugInformation="true"
				SubSystem="1"
				RandomizedBaseAddress="1"
				DataExecutionPrevention="0"
				TargetMachine="1"
			/>
			<Tool
				Name="VCALinkTool"
			/>
			<Tool
				Name="VCManifestTool"
			/>
			<Tool
				Name="VCXDCMakeTool"
			/>
			<Tool
				Name="VCBscMakeTool"
			/>
			<Tool
				Name="VCFxCopTool"
			/>
			<Tool
				Name="VCAppVerifierTool"
			/>
			<Tool
				Name="VCPostBuildEventTool"
			/>
		</Configuration>
		<Configuration
			Name="Release|Win32"
			OutputDirectory="Release"
			IntermediateDirectory="Release"
			ConfigurationType="1"
			>
			<Tool
				Name="VCPreBuildEventTool"
			/>
			<Tool
				Name="VCCustomBuildTool"
			/>
			<Tool
				Name="VCXMLDataGeneratorTool"
			/>
			<Tool
				Name="VCWebServiceProxyGeneratorTool"
			/>
			<Tool
				Name="VCMIDLTool"
			/>
			<Tool
				Name="VCCLCompilerTool"
				AdditionalIncludeDirectories="$(LIBSPOTIFY)\include;..\..\..\include"
				PreprocessorDefinitions="WIN32;NDEBUG;_CONSOLE;"
				RuntimeLibrary="2"
				UsePrecompiledHeader="0"
				WarningLevel="3"
				Detect64BitPortabilityProblems="true"
				DebugInformationFormat="3"
			/>
			<Tool
				Name="VCManagedResourceCompilerTool"
			/>
			<Tool
				Name="VCResourceCompilerTool"
			/>
			<Tool
				Name="VCPreLinkEventTool"
			/>
			<Tool
				Name="VCLinkerTool"
				AdditionalDependencies="libspotify.lib"
				LinkIncremental="1"
				AdditionalLibraryDirectories="$(LIBSPOTIFY)\lib;;..\..\..\lib"
				GenerateDebugInformation="true"
				SubSystem="1"
				OptimizeReferences="2"
				EnableCOMDATFolding="2"
				RandomizedBaseAddress="1"
				DataExecutionPrevention="0"
				TargetMachine="1"
			/>
			<Tool
				Name="VCALinkTool"
			/>
			<Tool
				Name="VCManifestTool"
			/>
			<Tool
				Name="VCXDCMakeTool"
			/>
			<Tool
				Name="VCBscMakeTool"
			/>
			<Tool
				Name="VCFxCopTool"
			/>
			<Tool
				Name="VCAppVerifierTool"
			/>
			<Tool
				Name="VCPostBuildEventTool"
			/>
		</Configuration>
	</Configurations>
	<References>
	</References>
	<Files>
		<Filter
			Name="Header Files"
			Filter="h;hpp;hxx;hm;inl;inc;xsd"
			UniqueIdentifier="{93995380-89BD-4b04-88EB-625FBE52EBFB}"
			>
			<File
				RelativePath="..\cmd.h"
				>
			</File>
			<File
				RelativePath="..\spshell.h"
				>
			</File>
		</Filter>
		<Filter
			Name="Resource Files"
			Filter="rc;ico;cur;bmp;dlg;rc2;rct;bin;rgs;gif;jpg;jpeg;jpe;resx"
			UniqueIdentifier="{67DA6AB6-F800-4c08-8B7A-83BB121AAD01}"
			>
		</Filter>
		<Filter
			Name="Source Files"
			Filter="cpp;c;cc;cxx;def;odl;idl;hpj;bat;asm;asmx"
			UniqueIdentifier="{4FC737F1-C7A5-4376-A066-2A32D752A2FF}"
			>
			<File
				RelativePath="..\..\appkey.c"
				>
			</File>
			<File
				RelativePath="..\browse.c"
				>
			</File>
			<File
				RelativePath="..\cmd.c"
				>
			</File>
			<File
				RelativePath="..\inbox.c"
				>
			</File>
			<File
				RelativePath="..\playlist.c"
				>
			</File>
			<File
				RelativePath="..\search.c"
				>
			</File>
			<File
				RelativePath="..\spshell.c"
				>
			</File>
			<File
				RelativePath="..\spshell_win32.c"
				>
			</File>
			<File
				RelativePath="..\star.c"
				>
			</File>
			<File
				RelativePath="..\test.c"
				>
			</File>
			<File
				RelativePath="..\toplist.c"
				>
			</File>
		</Filter>
	</Files>
	<Globals>
	</Globals>
</VisualStudioProject>


================================================
FILE: libspotify/examples/spshell/win32/spshell.vcxproj
================================================
<?xml version="1.0" encoding="utf-8"?>
<Project DefaultTargets="Build" ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <ItemGroup Label="ProjectConfigurations">
    <ProjectConfiguration Include="Debug|Win32">
      <Configuration>Debug</Configuration>
      <Platform>Win32</Platform>
    </ProjectConfiguration>
    <ProjectConfiguration Include="Release|Win32">
      <Configuration>Release</Configuration>
      <Platform>Win32</Platform>
    </ProjectConfiguration>
  </ItemGroup>
  <PropertyGroup Label="Globals">
    <ProjectGuid>{6C49596C-977E-4BB6-BC94-123AEB5E2724}</ProjectGuid>
    <Keyword>Win32Proj</Keyword>
  </PropertyGroup>
  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'" Label="Configuration">
    <ConfigurationType>Application</ConfigurationType>
  </PropertyGroup>
  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'" Label="Configuration">
    <ConfigurationType>Application</ConfigurationType>
  </PropertyGroup>
  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
  <ImportGroup Label="ExtensionSettings">
  </ImportGroup>
  <ImportGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'" Label="PropertySheets">
    <Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" />
  </ImportGroup>
  <ImportGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'" Label="PropertySheets">
    <Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" />
  </ImportGroup>
  <PropertyGroup Label="UserMacros" />
  <PropertyGroup>
    <_ProjectFileVersion>10.0.30319.1</_ProjectFileVersion>
    <OutDir Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">Debug\</OutDir>
    <IntDir Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">Debug\</IntDir>
    <LinkIncremental Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">true</LinkIncremental>
    <OutDir Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">Release\</OutDir>
    <IntDir Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">Release\</IntDir>
    <LinkIncremental Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">false</LinkIncremental>
    <CodeAnalysisRuleSet Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">AllRules.ruleset</CodeAnalysisRuleSet>
    <CodeAnalysisRules Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'" />
    <CodeAnalysisRuleAssemblies Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'" />
    <CodeAnalysisRuleSet Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">AllRules.ruleset</CodeAnalysisRuleSet>
    <CodeAnalysisRules Condition="'$(Configuration)|$(Platform)'=='Release|Win32'" />
    <CodeAnalysisRuleAssemblies Condition="'$(Configuration)|$(Platform)'=='Release|Win32'" />
  </PropertyGroup>
  <ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
    <ClCompile>
      <Optimization>Disabled</Optimization>
      <AdditionalIncludeDirectories>$(LIBSPOTIFY)\include;..\..\..\include</AdditionalIncludeDirectories>
      <PreprocessorDefinitions>WIN32;_DEBUG;_CONSOLE;%(PreprocessorDefinitions)</PreprocessorDefinitions>
      <MinimalRebuild>true</MinimalRebuild>
      <BasicRuntimeChecks>EnableFastChecks</BasicRuntimeChecks>
      <RuntimeLibrary>MultiThreadedDebugDLL</RuntimeLibrary>
      <PrecompiledHeader>
      </PrecompiledHeader>
      <WarningLevel>Level3</WarningLevel>
      <DebugInformationFormat>ProgramDatabase</DebugInformationFormat>
      <CallingConvention>StdCall</CallingConvention>
    </ClCompile>
    <Link>
      <AdditionalDependencies>libspotify.lib</AdditionalDependencies>
      <AdditionalLibraryDirectories>$(LIBSPOTIFY)\lib;..\..\..\lib</AdditionalLibraryDirectories>
      <GenerateDebugInformation>true</GenerateDebugInformation>
      <SubSystem>Console</SubSystem>
      <RandomizedBaseAddress>false</RandomizedBaseAddress>
      <DataExecutionPrevention>
      </DataExecutionPrevention>
      <TargetMachine>MachineX86</TargetMachine>
    </Link>
  </ItemDefinitionGroup>
  <ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">
    <ClCompile>
      <PreprocessorDefinitions>WIN32;NDEBUG;_CONSOLE;%(PreprocessorDefinitions)</PreprocessorDefinitions>
      <RuntimeLibrary>MultiThreadedDLL</RuntimeLibrary>
      <PrecompiledHeader>
      </PrecompiledHeader>
      <WarningLevel>Level3</WarningLevel>
      <DebugInformationFormat>ProgramDatabase</DebugInformationFormat>
      <AdditionalIncludeDirectories>$(LIBSPOTIFY)\include;..\..\..\include</AdditionalIncludeDirectories>
    </ClCompile>
    <Link>
      <GenerateDebugInformation>true</GenerateDebugInformation>
      <SubSystem>Console</SubSystem>
      <OptimizeReferences>true</OptimizeReferences>
      <EnableCOMDATFolding>true</EnableCOMDATFolding>
      <RandomizedBaseAddress>false</RandomizedBaseAddress>
      <DataExecutionPrevention>
      </DataExecutionPrevention>
      <TargetMachine>MachineX86</TargetMachine>
      <AdditionalDependencies>libspotify.lib</AdditionalDependencies>
      <AdditionalLibraryDirectories>$(LIBSPOTIFY)\lib;..\..\..\lib</AdditionalLibraryDirectories>
    </Link>
  </ItemDefinitionGroup>
  <ItemGroup>
    <ClInclude Include="..\cmd.h" />
    <ClInclude Include="..\spshell.h" />
  </ItemGroup>
  <ItemGroup>
    <ClCompile Include="..\..\appkey.c" />
    <ClCompile Include="..\browse.c" />
    <ClCompile Include="..\cmd.c" />
    <ClCompile Include="..\inbox.c" />
    <ClCompile Include="..\playlist.c" />
    <ClCompile Include="..\search.c" />
    <ClCompile Include="..\spshell.c" />
    <ClCompile Include="..\spshell_win32.c" />
    <ClCompile Include="..\star.c" />
    <ClCompile Include="..\test.c" />
    <ClCompile Include="..\toplist.c" />
  </ItemGroup>
  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.targets" />
  <ImportGroup Label="ExtensionTargets">
  </ImportGroup>
</Project>

================================================
FILE: libspotify/examples/spshell/win32/spshell.vcxproj.filters
================================================
<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <ItemGroup>
    <Filter Include="Header Files">
      <UniqueIdentifier>{93995380-89BD-4b04-88EB-625FBE52EBFB}</UniqueIdentifier>
      <Extensions>h;hpp;hxx;hm;inl;inc;xsd</Extensions>
    </Filter>
    <Filter Include="Resource Files">
      <UniqueIdentifier>{67DA6AB6-F800-4c08-8B7A-83BB121AAD01}</UniqueIdentifier>
      <Extensions>rc;ico;cur;bmp;dlg;rc2;rct;bin;rgs;gif;jpg;jpeg;jpe;resx</Extensions>
    </Filter>
    <Filter Include="Source Files">
      <UniqueIdentifier>{4FC737F1-C7A5-4376-A066-2A32D752A2FF}</UniqueIdentifier>
      <Extensions>cpp;c;cc;cxx;def;odl;idl;hpj;bat;asm;asmx</Extensions>
    </Filter>
  </ItemGroup>
  <ItemGroup>
    <ClInclude Include="..\cmd.h">
      <Filter>Header Files</Filter>
    </ClInclude>
    <ClInclude Include="..\spshell.h">
      <Filter>Header Files</Filter>
    </ClInclude>
  </ItemGroup>
  <ItemGroup>
    <ClCompile Include="..\..\appkey.c">
      <Filter>Source Files</Filter>
    </ClCompile>
    <ClCompile Include="..\browse.c">
      <Filter>Source Files</Filter>
    </ClCompile>
    <ClCompile Include="..\cmd.c">
      <Filter>Source Files</Filter>
    </ClCompile>
    <ClCompile Include="..\inbox.c">
      <Filter>Source Files</Filter>
    </ClCompile>
    <ClCompile Include="..\search.c">
      <Filter>Source Files</Filter>
    </ClCompile>
    <ClCompile Include="..\spshell.c">
      <Filter>Source Files</Filter>
    </ClCompile>
    <ClCompile Include="..\spshell_win32.c">
      <Filter>Source Files</Filter>
    </ClCompile>
    <ClCompile Include="..\star.c">
      <Filter>Source Files</Filter>
    </ClCompile>
    <ClCompile Include="..\toplist.c">
      <Filter>Source Files</Filter>
    </ClCompile>
    <ClCompile Include="..\playlist.c">
      <Filter>Source Files</Filter>
    </ClCompile>
    <ClCompile Include="..\test.c">
      <Filter>Source Files</Filter>
    </ClCompile>
  </ItemGroup>
</Project>

================================================
FILE: libspotify/examples/stub/Makefile
================================================
TARGET=posix_stu
CFLAGs += -Werror

include ../common.mk

$(TARGET): main.o
	$(CC) $(CFLAGS) $(LDFLAGS) $(LDLIBS) $^ -o $@

ifdef DEBUG
ifeq ($(shell uname),Darwin)
	install_name_tool -change @loader_path/../Frameworks/libspotify.framework/libspotify @rpath/libspotify.so $@
endif
endif


================================================
FILE: libspotify/examples/stub/main.c
================================================
/**
 * Copyright (c) 2006-2010 Spotify Ltd
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 */

#define USER_AGENT "<Add your own useragent>"
#error Please update above variables for your project
/* A simple stub that logs in and out */

#include "main.h"
#include <pthread.h>
#include <sys/time.h>
#include <stdlib.h>
#include <stdio.h>
sp_session *g_session;

static int notify_events;
static pthread_mutex_t notify_mutex;
static pthread_cond_t notify_cond;


static void connection_error(sp_session *session, sp_error error)
{
	
}

static void logged_in(sp_session *session, sp_error error)
{
	//add your testcode here 
	
}

static void logged_out(sp_session *session)
{
	exit(0);
}


/**
 * This callback is called for log messages.
 *
 * @sa sp_session_callbacks#log_message
 */
static void log_message(sp_session *session, const char *data)
{
	fprintf(stderr,"%s",data);
}

void notify_main_thread(sp_session *session)
{
	pthread_mutex_lock(&notify_mutex);
	notify_events = 1;
	pthread_cond_signal(&notify_cond);
	pthread_mutex_unlock(&notify_mutex);
}

static sp_session_callbacks callbacks = {
	&logged_in,
	&logged_out,
	NULL,
	&connection_error,
	NULL,
	&notify_main_thread,
	NULL,
	NULL,
	&log_message
};

int spotify_init(const char *username,const char *password)
{
	sp_session_config config;
	sp_error error;
	sp_session *session;
	
	/// The application key is specific to each project, and allows Spotify
	/// to produce statistics on how our service is used.
	extern const char g_appkey[];
	/// The size of the application key.
	extern const size_t g_appkey_size;

	// Always do this. It allows libspotify to check for
	// header/library inconsistencies.
	config.api_version = SPOTIFY_API_VERSION;

	// The path of the directory to store the cache. This must be specified.
	// Please read the documentation on preferred values.
	config.cache_location = "tmp";

	// The path of the directory to store the settings. 
	// This must be specified.
	// Please read the documentation on preferred values.
	config.settings_location = "tmp";

	// The key of the application. They are generated by Spotify,
	// and are specific to each application using libspotify.
	config.application_key = g_appkey;
	config.application_key_size = g_appkey_size;

	// This identifies the application using some
	// free-text string [1, 255] characters.
	config.user_agent = USER_AGENT;

	// Register the callbacks.
	config.callbacks = &callbacks;

	error = sp_session_create(&config, &session);
	if (SP_ERROR_OK != error) {
		fprintf(stderr, "failed to create session: %s\n",
		                sp_error_message(error));
		return 2;
	}

	// Login using the credentials given on the command line.
	error = sp_session_login(session, username, password, 0);

	if (SP_ERROR_OK != error) {
		fprintf(stderr, "failed to login: %s\n",
		                sp_error_message(error));
		return 3;
	}

	g_session = session;
	return 0;
}

int main(int argc, char **argv)
{
	int next_timeout = 0;
	if(argc < 3) {
		fprintf(stderr,"Usage: %s <username> <password>\n",argv[0]);
	}
	pthread_mutex_init(&notify_mutex, NULL);
	pthread_cond_init(&notify_cond, NULL);

	if(spotify_init(argv[1],argv[2]) != 0) {
		fprintf(stderr,"Spotify failed to initialize\n");
		exit(-1);
	}
	pthread_mutex_lock(&notify_mutex);
	for (;;) {
		if (next_timeout == 0) {
			while(!notify_events)
				pthread_cond_wait(&notify_cond, &notify_mutex);
		} else {
			struct timespec ts;

	#if _POSIX_TIMERS > 0
			clock_gettime(CLOCK_REALTIME, &ts);
	#else
			struct timeval tv;
			gettimeofday(&tv, NULL);
			TIMEVAL_TO_TIMESPEC(&tv, &ts);
	#endif

			ts.tv_sec += next_timeout / 1000;
			ts.tv_nsec += (next_timeout % 1000) * 1000000;

			while(!notify_events) {
				if(pthread_cond_timedwait(&notify_cond, &notify_mutex, &ts))
					break;
			}
		}

		// Process libspotify events
		notify_events = 0;
		pthread_mutex_unlock(&notify_mutex);

		do {
			sp_session_process_events(g_session, &next_timeout);
		} while (next_timeout == 0);

		pthread_mutex_lock(&notify_mutex);
	}
	return 0;
}


================================================
FILE: libspotify/examples/stub/main.h
================================================
#ifndef __MAIN_H__
#define __MAIN_H__
#include <libspotify/api.h>
#endif


================================================
FILE: libspotify/include/libspotify/api.h
================================================
/*
 * Copyright (c) 2006-2012 Spotify Ltd
 *
 * The terms of use for this and related files can be read in
 * the associated LICENSE file, usually stored in share/doc/libspotify/LICENSE.
 */

/**
 * @file   api.h    Public API for libspotify
 *
 * @note   All input strings are expected to be in UTF-8
 * @note   All output strings are in UTF-8.
 *
 * @note   All usernames are valid XMPP nodeprep identifiers:
 *         http://tools.ietf.org/html/rfc3920#appendix-A
 *         If you need to store user data, we strongly advise you
 *         to use the canonical form of the username.
 */

#ifndef PUBLIC_API_H
#define PUBLIC_API_H

#ifdef __cplusplus
extern "C" {
#endif

#ifndef SP_CALLCONV
#ifdef _WIN32
#define SP_CALLCONV __stdcall
#else
#define SP_CALLCONV
#endif
#endif

#ifndef SP_LIBEXPORT
#ifdef _WIN32
#define SP_LIBEXPORT(x) x __stdcall
#else
#define SP_LIBEXPORT(x) x
#endif
#endif

/* Includes */
#include <stddef.h>

#ifdef _WIN32
typedef unsigned __int64 sp_uint64;
#else
#include <stdint.h>
typedef uint64_t sp_uint64;
#endif

/* General types */

#if !defined(__cplusplus) && !defined(__bool_true_false_are_defined)
typedef unsigned char bool;
#endif

typedef unsigned char byte;

/**
 * @defgroup types Spotify types & structs
 *
 * @{
 */

typedef struct sp_session sp_session; ///< Representation of a session
typedef struct sp_track sp_track; ///< A track handle
typedef struct sp_album sp_album; ///< An album handle
typedef struct sp_artist sp_artist; ///< An artist handle
typedef struct sp_artistbrowse sp_artistbrowse; ///< A handle to an artist browse result
typedef struct sp_albumbrowse sp_albumbrowse; ///< A handle to an album browse result
typedef struct sp_toplistbrowse sp_toplistbrowse; ///< A handle to a toplist browse result
typedef struct sp_search sp_search; ///< A handle to a search result
typedef struct sp_link sp_link; ///< A handle to the libspotify internal representation of a URI
typedef struct sp_image sp_image; ///< A handle to an image
typedef struct sp_user sp_user; ///< A handle to a user
typedef struct sp_playlist sp_playlist; ///< A playlist handle
typedef struct sp_playlistcontainer sp_playlistcontainer; ///< A playlist container (playlist containing other playlists) handle
typedef struct sp_inbox sp_inbox; ///< Add to inbox request handle
/** @} */

/**
 * @defgroup error Error Handling
 *
 * All functions in libspotify use the same set of error codes. Most of them return
 * an error code, and let the result of the operation be stored in an out-parameter.
 *
 * @{
 */

/**
 * Error codes returned by various functions
 */
typedef enum sp_error {
  SP_ERROR_OK                        = 0,  ///< No errors encountered
  SP_ERROR_BAD_API_VERSION           = 1,  ///< The library version targeted does not match the one you claim you support
  SP_ERROR_API_INITIALIZATION_FAILED = 2,  ///< Initialization of library failed - are cache locations etc. valid?
  SP_ERROR_TRACK_NOT_PLAYABLE        = 3,  ///< The track specified for playing cannot be played
  SP_ERROR_BAD_APPLICATION_KEY       = 5,  ///< The application key is invalid
  SP_ERROR_BAD_USERNAME_OR_PASSWORD  = 6,  ///< Login failed because of bad username and/or password
  SP_ERROR_USER_BANNED               = 7,  ///< The specified username is banned
  SP_ERROR_UNABLE_TO_CONTACT_SERVER  = 8,  ///< Cannot connect to the Spotify backend system
  SP_ERROR_CLIENT_TOO_OLD            = 9,  ///< Client is too old, library will need to be updated
  SP_ERROR_OTHER_PERMANENT           = 10, ///< Some other error occurred, and it is permanent (e.g. trying to relogin will not help)
  SP_ERROR_BAD_USER_AGENT            = 11, ///< The user agent string is invalid or too long
  SP_ERROR_MISSING_CALLBACK          = 12, ///< No valid callback registered to handle events
  SP_ERROR_INVALID_INDATA            = 13, ///< Input data was either missing or invalid
  SP_ERROR_INDEX_OUT_OF_RANGE        = 14, ///< Index out of range
  SP_ERROR_USER_NEEDS_PREMIUM        = 15, ///< The specified user needs a premium account
  SP_ERROR_OTHER_TRANSIENT           = 16, ///< A transient error occurred.
  SP_ERROR_IS_LOADING                = 17, ///< The resource is currently loading
  SP_ERROR_NO_STREAM_AVAILABLE       = 18, ///< Could not find any suitable stream to play
  SP_ERROR_PERMISSION_DENIED         = 19, ///< Requested operation is not allowed
  SP_ERROR_INBOX_IS_FULL             = 20, ///< Target inbox is full
  SP_ERROR_NO_CACHE                  = 21, ///< Cache is not enabled
  SP_ERROR_NO_SUCH_USER              = 22, ///< Requested user does not exist
  SP_ERROR_NO_CREDENTIALS            = 23, ///< No credentials are stored
  SP_ERROR_NETWORK_DISABLED          = 24, ///< Network disabled
  SP_ERROR_INVALID_DEVICE_ID         = 25, ///< Invalid device ID
  SP_ERROR_CANT_OPEN_TRACE_FILE      = 26, ///< Unable to open trace file
  SP_ERROR_APPLICATION_BANNED        = 27, ///< This application is no longer allowed to use the Spotify service
  SP_ERROR_OFFLINE_TOO_MANY_TRACKS   = 31, ///< Reached the device limit for number of tracks to download
  SP_ERROR_OFFLINE_DISK_CACHE        = 32, ///< Disk cache is full so no more tracks can be downloaded to offline mode
  SP_ERROR_OFFLINE_EXPIRED           = 33, ///< Offline key has expired, the user needs to go online again
  SP_ERROR_OFFLINE_NOT_ALLOWED       = 34, ///< This user is not allowed to use offline mode
  SP_ERROR_OFFLINE_LICENSE_LOST      = 35, ///< The license for this device has been lost. Most likely because the user used offline on three other device
  SP_ERROR_OFFLINE_LICENSE_ERROR     = 36, ///< The Spotify license server does not respond correctly
  SP_ERROR_LASTFM_AUTH_ERROR         = 39, ///< A LastFM scrobble authentication error has occurred
  SP_ERROR_INVALID_ARGUMENT          = 40, ///< An invalid argument was specified
  SP_ERROR_SYSTEM_FAILURE            = 41, ///< An operating system error
} sp_error;

/**
 * Convert a numeric libspotify error code to a text string. The error message is in
 * English. This function is useful for logging purposes.
 *
 * @param[in]   error   The error code to lookup
 */
SP_LIBEXPORT(const char*) sp_error_message(sp_error error);

/** @} */



/**
 * @defgroup session Session handling
 *
 * The concept of a session is fundamental for all communication with the Spotify ecosystem - it is the
 * object responsible for communicating with the Spotify service. You will need to instantiate a
 * session that then can be used to request artist information, perform searches etc.
 *
 * @{
 */

/**
 * Current version of the application interface, that is, the API described by this file.
 *
 * This value should be set in the sp_session_config struct passed to sp_session_create().
 *
 * If an (upgraded) library is no longer compatible with this version the error #SP_ERROR_BAD_API_VERSION will be
 * returned from sp_session_create(). Future versions of the library will provide you with some kind of mechanism
 * to request an updated version of the library.
 */
#define SPOTIFY_API_VERSION 12

/**
 * Describes the current state of the connection
 */
typedef enum sp_connectionstate {
  SP_CONNECTION_STATE_LOGGED_OUT   = 0, ///< User not yet logged in
  SP_CONNECTION_STATE_LOGGED_IN    = 1, ///< Logged in against a Spotify access point
  SP_CONNECTION_STATE_DISCONNECTED = 2, ///< Was logged in, but has now been disconnected
  SP_CONNECTION_STATE_UNDEFINED    = 3, ///< The connection state is undefined
  SP_CONNECTION_STATE_OFFLINE    = 4  ///< Logged in in offline mode
} sp_connectionstate;


/**
 * Sample type descriptor
 */
typedef enum sp_sampletype {
  SP_SAMPLETYPE_INT16_NATIVE_ENDIAN = 0, ///< 16-bit signed integer samples
} sp_sampletype;

/**
 * Audio format descriptor
 */
typedef struct sp_audioformat {
  sp_sampletype sample_type;   ///< Sample type enum,
  int sample_rate;             ///< Audio sample rate, in samples per second.
  int channels;                ///< Number of channels. Currently 1 or 2.
} sp_audioformat;

/**
 * Bitrate definitions for music streaming
 */
typedef enum sp_bitrate {
  SP_BITRATE_160k      = 0, ///< Bitrate 160kbps
  SP_BITRATE_320k      = 1, ///< Bitrate 320kbps
  SP_BITRATE_96k       = 2, ///< Bitrate 96kbps
} sp_bitrate;

/**
 * Playlist types
 */
typedef enum sp_playlist_type {
  SP_PLAYLIST_TYPE_PLAYLIST     = 0, ///< A normal playlist.
  SP_PLAYLIST_TYPE_START_FOLDER = 1, ///< Marks a folder starting point,
  SP_PLAYLIST_TYPE_END_FOLDER   = 2, ///< and ending point.
  SP_PLAYLIST_TYPE_PLACEHOLDER  = 3, ///< Unknown entry.
} sp_playlist_type;



/**
 * Search types
 */
typedef enum sp_search_type {
  SP_SEARCH_STANDARD  = 0,
  SP_SEARCH_SUGGEST = 1,
} sp_search_type;

/**
 * Playlist offline status
 */
typedef enum sp_playlist_offline_status {
  SP_PLAYLIST_OFFLINE_STATUS_NO          = 0, ///< Playlist is not offline enabled
  SP_PLAYLIST_OFFLINE_STATUS_YES         = 1, ///< Playlist is synchronized to local storage
  SP_PLAYLIST_OFFLINE_STATUS_DOWNLOADING = 2, ///< This playlist is currently downloading. Only one playlist can be in this state any given time
  SP_PLAYLIST_OFFLINE_STATUS_WAITING     = 3, ///< Playlist is queued for download
} sp_playlist_offline_status;

/**
 * Track availability
 */
typedef enum sp_availability {
  SP_TRACK_AVAILABILITY_UNAVAILABLE = 0, ///< Track is not available
  SP_TRACK_AVAILABILITY_AVAILABLE   = 1, ///< Track is available and can be played
  SP_TRACK_AVAILABILITY_NOT_STREAMABLE = 2, ///< Track can not be streamed using this account
  SP_TRACK_AVAILABILITY_BANNED_BY_ARTIST = 3, ///< Track not available on artist's reqeust
} sp_track_availability;

/**
 * Track offline status
 */
typedef enum sp_track_offline_status {
  SP_TRACK_OFFLINE_NO             = 0, ///< Not marked for offline
  SP_TRACK_OFFLINE_WAITING        = 1, ///< Waiting for download
  SP_TRACK_OFFLINE_DOWNLOADING    = 2, ///< Currently downloading
  SP_TRACK_OFFLINE_DONE           = 3, ///< Downloaded OK and can be played
  SP_TRACK_OFFLINE_ERROR          = 4, ///< Error during download
  SP_TRACK_OFFLINE_DONE_EXPIRED   = 5, ///< Downloaded OK but not playable due to expiery
  SP_TRACK_OFFLINE_LIMIT_EXCEEDED = 6, ///< Waiting because device have reached max number of allowed tracks
  SP_TRACK_OFFLINE_DONE_RESYNC    = 7, ///< Downloaded OK and available but scheduled for re-download
} sp_track_offline_status;

/**
 * Image size
 */
typedef enum sp_image_size {
  SP_IMAGE_SIZE_NORMAL                  = 0, ///< Normal image size
  SP_IMAGE_SIZE_SMALL                   = 1, ///< Small image size
  SP_IMAGE_SIZE_LARGE                   = 2, ///< Large image size
} sp_image_size;

/**
 * Buffer stats used by get_audio_buffer_stats callback
 */
typedef struct sp_audio_buffer_stats {
  int samples;                      ///< Samples in buffer
  int stutter;                      ///< Number of stutters (audio dropouts) since last query
} sp_audio_buffer_stats;

/**
 * List of subscribers returned by sp_playlist_subscribers()
 */
typedef struct sp_subscribers {
  unsigned int count;    ///< Number of elements in 'subscribers'
  char *subscribers[1];  ///< Actual size is 'count'. Array of pointers to canonical usernames
} sp_subscribers;


/**
 * Current connection type set using sp_session_set_connection_type()
 */
typedef enum sp_connection_type {
  SP_CONNECTION_TYPE_UNKNOWN        = 0, ///< Connection type unknown (Default)
  SP_CONNECTION_TYPE_NONE           = 1, ///< No connection
  SP_CONNECTION_TYPE_MOBILE         = 2, ///< Mobile data (EDGE, 3G, etc)
  SP_CONNECTION_TYPE_MOBILE_ROAMING = 3, ///< Roamed mobile data (EDGE, 3G, etc)
  SP_CONNECTION_TYPE_WIFI           = 4, ///< Wireless connection
  SP_CONNECTION_TYPE_WIRED          = 5, ///< Ethernet cable, etc
} sp_connection_type;


/**
 * Connection rules, bitwise OR of flags
 *
 * The default is SP_CONNECTION_RULE_NETWORK | SP_CONNECTION_RULE_ALLOW_SYNC
 */
typedef enum sp_connection_rules {
  SP_CONNECTION_RULE_NETWORK                = 0x1, ///< Allow network traffic. When not set libspotify will force itself into offline mode
  SP_CONNECTION_RULE_NETWORK_IF_ROAMING     = 0x2, ///< Allow network traffic even if roaming
  SP_CONNECTION_RULE_ALLOW_SYNC_OVER_MOBILE = 0x4, ///< Set to allow syncing of offline content over mobile connections
  SP_CONNECTION_RULE_ALLOW_SYNC_OVER_WIFI   = 0x8, ///< Set to allow syncing of offline content over WiFi
} sp_connection_rules;


/**
 * Controls the type of data that will be included in artist browse queries
 */
typedef enum sp_artistbrowse_type {
  SP_ARTISTBROWSE_FULL,         /**< All information except tophit tracks
                   This mode is deprecated and will removed in a future release */
  SP_ARTISTBROWSE_NO_TRACKS,    /**< Only albums and data about them, no tracks.
             In other words, sp_artistbrowse_num_tracks() will return 0
              */
  SP_ARTISTBROWSE_NO_ALBUMS,    /**< Only return data about the artist (artist name, similar artist
             biography, etc
             No tracks or album will be abailable.
             sp_artistbrowse_num_tracks() and sp_artistbrowse_num_albums()
             will both return 0
              */
} sp_artistbrowse_type;

typedef enum sp_social_provider {
  SP_SOCIAL_PROVIDER_SPOTIFY,
  SP_SOCIAL_PROVIDER_FACEBOOK,
  SP_SOCIAL_PROVIDER_LASTFM,
} sp_social_provider;

typedef enum sp_scrobbling_state {
  SP_SCROBBLING_STATE_USE_GLOBAL_SETTING    = 0,
  SP_SCROBBLING_STATE_LOCAL_ENABLED         = 1,
  SP_SCROBBLING_STATE_LOCAL_DISABLED        = 2,
  SP_SCROBBLING_STATE_GLOBAL_ENABLED        = 3,
  SP_SCROBBLING_STATE_GLOBAL_DISABLED       = 4,
} sp_scrobbling_state;


/**
 * Offline sync status
 */
typedef struct sp_offline_sync_status {
  /**
   * Queued tracks/bytes is things left to sync in current sync
   * operation
   */
  int queued_tracks;
  sp_uint64 queued_bytes;

  /**
   * Done tracks/bytes is things marked for sync that existed on
   * device before current sync operation
   */
  int done_tracks;
  sp_uint64 done_bytes;

  /**
   * Copied tracks/bytes is things that has been copied in
   * current sync operation
   */
  int copied_tracks;
  sp_uint64 copied_bytes;

  /**
   * Tracks that are marked as synced but will not be copied
   * (for various reasons)
   */
  int willnotcopy_tracks;

  /**
   * A track is counted as error when something goes wrong while
   * syncing the track
   */
  int error_tracks;

  /**
   * Set if sync operation is in progress
   */
  bool syncing;

} sp_offline_sync_status;


/**
 * Session callbacks
 *
 * Registered when you create a session.
 * If some callbacks should not be of interest, set them to NULL.
 */
typedef struct sp_session_callbacks {

  /**
   * Called when login has been processed and was successful
   *
   * @param[in]  session    Session
   * @param[in]  error      One of the following errors, from ::sp_error
   *                        SP_ERROR_OK
   *                        SP_ERROR_CLIENT_TOO_OLD
   *                        SP_ERROR_UNABLE_TO_CONTACT_SERVER
   *                        SP_ERROR_BAD_USERNAME_OR_PASSWORD
   *                        SP_ERROR_USER_BANNED
   *                        SP_ERROR_USER_NEEDS_PREMIUM
   *                        SP_ERROR_OTHER_TRANSIENT
   *                        SP_ERROR_OTHER_PERMANENT
   */
  void (SP_CALLCONV *logged_in)(sp_session *session, sp_error error);

  /**
   * Called when logout has been processed. Either called explicitly
   * if you initialize a logout operation, or implicitly if there
   * is a permanent connection error
   *
   * @param[in]  session    Session
   */
  void (SP_CALLCONV *logged_out)(sp_session *session);
  /**
   * Called whenever metadata has been updated
   *
   * If you have metadata cached outside of libspotify, you should purge
   * your caches and fetch new versions.
   *
   * @param[in]  session    Session
   */
  void (SP_CALLCONV *metadata_updated)(sp_session *session);

  /**
   * Called when there is a connection error, and the library has problems
   * reconnecting to the Spotify service. Could be called multiple times (as
   * long as the problem is present)
   *
   *
   * @param[in]  session    Session
   * @param[in]  error      One of the following errors, from ::sp_error
   *                        SP_ERROR_OK
   *                        SP_ERROR_CLIENT_TOO_OLD
   *                        SP_ERROR_UNABLE_TO_CONTACT_SERVER
   *                        SP_ERROR_BAD_USERNAME_OR_PASSWORD
   *                        SP_ERROR_USER_BANNED
   *                        SP_ERROR_USER_NEEDS_PREMIUM
   *                        SP_ERROR_OTHER_TRANSIENT
   *                        SP_ERROR_OTHER_PERMANENT
   */
  void (SP_CALLCONV *connection_error)(sp_session *session, sp_error error);

  /**
   * Called when the access point wants to display a message to the user
   *
   * In the desktop client, these are shown in a blueish toolbar just below the
   * search box.
   *
   * @param[in]  session    Session
   * @param[in]  message    String in UTF-8 format.
   */
  void (SP_CALLCONV *message_to_user)(sp_session *session, const char *message);

  /**
   * Called when processing needs to take place on the main thread.
   *
   * You need to call sp_session_process_events() in the main thread to get
   * libspotify to do more work. Failure to do so may cause request timeouts,
   * or a lost connection.
   *
   * @param[in]  session    Session
   *
   * @note This function is called from an internal session thread - you need to have proper synchronization!
   */
  void (SP_CALLCONV *notify_main_thread)(sp_session *session);

  /**
   * Called when there is decompressed audio data available.
   *
   * @param[in]  session    Session
   * @param[in]  format     Audio format descriptor sp_audioformat
   * @param[in]  frames     Points to raw PCM data as described by \p format
   * @param[in]  num_frames Number of available samples in \p frames.
   *                        If this is 0, a discontinuity has occurred (such as after a seek). The application
   *                        should flush its audio fifos, etc.
   *
   * @return                Number of frames consumed.
   *                        This value can be used to rate limit the output from the library if your
   *                        output buffers are saturated. The library will retry delivery in about 100ms.
   *
   * @note This function is called from an internal session thread - you need to have proper synchronization!
   *
   * @note This function must never block. If your output buffers are full you must return 0 to signal
   *       that the library should retry delivery in a short while.
   */
  int (SP_CALLCONV *music_delivery)(sp_session *session, const sp_audioformat *format, const void *frames, int num_frames);

  /**
   * Music has been paused because an account only allows music
   * to be played from one location simultaneously.
   *
   * @note When this callback is invoked the application should
   *       behave just as if the user pressed the pause
   *       button. The application should also display a message
   *       to the user indicating the playback has been paused
   *       because another application is playing using the same
   *       account.
   *
   * @note IT MUST NOT automatically resume playback but must
   *       instead wait for the user to press play.
   *
   * @param[in]  session    Session
   */
  void (SP_CALLCONV *play_token_lost)(sp_session *session);

  /**
   * Logging callback.
   *
   * @param[in]  session    Session
   * @param[in]  data       Log data
   */
  void (SP_CALLCONV *log_message)(sp_session *session, const char *data);

  /**
   * End of track.
   * Called when the currently played track has reached its end.
   *
   * @note This function is invoked from the main thread
   *
   * @param[in]  session    Session
   */
  void (SP_CALLCONV *end_of_track)(sp_session *session);

  /**
   * Streaming error.
   * Called when streaming cannot start or continue.
   *
   * @note This function is invoked from the main thread
   *
   * @param[in]  session    Session
   * @param[in]  error      One of the following errors, from ::sp_error
   *                        SP_ERROR_NO_STREAM_AVAILABLE
   *                        SP_ERROR_OTHER_TRANSIENT
   *                        SP_ERROR_OTHER_PERMANENT
   */
  void (SP_CALLCONV *streaming_error)(sp_session *session, sp_error error);

  /**
   * Called after user info (anything related to sp_user objects) have been updated.
   *
   * @param[in]  session    Session
   */
  void (SP_CALLCONV *userinfo_updated)(sp_session *session);

  /**
   * Called when audio playback should start
   *
   * @note For this to work correctly the application must also implement get_audio_buffer_stats()
   *
   * @note This function is called from an internal session thread - you need to have proper synchronization!
   *
   * @note This function must never block.
   *
   * @param[in]  session    Session
   */
  void (SP_CALLCONV *start_playback)(sp_session *session);


  /**
   * Called when audio playback should stop
   *
   * @note For this to work correctly the application must also implement get_audio_buffer_stats()
   *
   * @note This function is called from an internal session thread - you need to have proper synchronization!
   *
   * @note This function must never block.
   *
   * @param[in]  session    Session
   */
  void (SP_CALLCONV *stop_playback)(sp_session *session);

  /**
   * Called to query application about its audio buffer
   *
   * @note This function is called from an internal session thread - you need to have proper synchronization!
   *
   * @note This function must never block.
   *
   * @param[in]  session    Session
   * @param[out] stats      Stats struct to be filled by application
   */
  void (SP_CALLCONV *get_audio_buffer_stats)(sp_session *session, sp_audio_buffer_stats *stats);

  /**
   * Called when offline synchronization status is updated
   *
   * @param[in]  session    Session
   */
  void (SP_CALLCONV *offline_status_updated)(sp_session *session);

  /**
   * Called when offline synchronization status is updated
   *
   * @param[in]  session    Session
   * @param[in]  error      Offline error. Will be SP_ERROR_OK if the offline synchronization
   *                        error state has cleared
   */
  void (SP_CALLCONV *offline_error)(sp_session *session, sp_error error);

  /**
   * Called when storable credentials have been updated, usually called when
   * we have connected to the AP.
   *
   * @param[in]  session    Session
   * @param[in]  blob   Blob is a null-terminated string which contains
   *        an encrypted token that can be stored safely on disk
   *        instead of storing plaintext passwords.
   */
  void (SP_CALLCONV *credentials_blob_updated)(sp_session *session, const char *blob);

  /**
   * Called when the connection state has updated - such as when logging in, going offline, etc.
   *
   * @param[in]  session    Session
   */
  void (SP_CALLCONV *connectionstate_updated)(sp_session *session);

   /**
  * Called when there is a scrobble error event
  *
  * @param[in]  session    Session
  * @param[in]  error      Scrobble error. Currently SP_ERROR_LASTFM_AUTH_ERROR.
  */
  void (SP_CALLCONV *scrobble_error)(sp_session *session, sp_error error);

   /**
  * Called when there is a change in the private session mode
  *
  * @param[in]  session    Session
  * @param[in]  isPrivate  True if in private session, false otherwhise
  */
  void (SP_CALLCONV *private_session_mode_changed)(sp_session *session, bool is_private);
} sp_session_callbacks;

/**
 * Session config
 */
typedef struct sp_session_config {
  int api_version;                       ///< The version of the Spotify API your application is compiled with. Set to #SPOTIFY_API_VERSION
  const char *cache_location;            /**< The location where Spotify will write cache files.
            *   This cache include tracks, cached browse results and coverarts.
                                          *   Set to empty string ("") to disable cache
            */
  const char *settings_location;         /**< The location where Spotify will write setting files and per-user
            *   cache items. This includes playlists, track metadata, etc.
            *   'settings_location' may be the same path as 'cache_location'.
            *   'settings_location' folder will not be created (unlike 'cache_location'),
            *   if you don't want to create the folder yourself, you can set 'settings_location' to 'cache_location'.
            */
  const void *application_key;           ///< Your application key
  size_t application_key_size;           ///< The size of the application key in bytes
  const char *user_agent;                /**< "User-Agent" for your application - max 255 characters long
                 The User-Agent should be a relevant, customer facing identification of your application
                 */

  const sp_session_callbacks *callbacks; ///< Delivery callbacks for session events, or NULL if you are not interested in any callbacks (not recommended!)
  void *userdata;                        ///< User supplied data for your application

  /**
   * Compress local copy of playlists, reduces disk space usage
   */
  bool compress_playlists;

  /**
   * Don't save metadata for local copies of playlists
   * Reduces disk space usage at the expense of needing
   * to request metadata from Spotify backend when loading list
   */
  bool dont_save_metadata_for_playlists;

  /**
   * Avoid loading playlists into RAM on startup.
   * See sp_playlist_is_in_ram() for more details.
   */
  bool initially_unload_playlists;

  /**
   * Device ID for offline synchronization and logging purposes. The Device Id must be unique to the particular device instance,
   * i.e. no two units must supply the same Device ID. The Device ID must not change between sessions or power cycles.
   * Good examples is the device's MAC address or unique serial number.
   */
  const char *device_id;

  /**
   * Url to the proxy server that should be used.
   * The format is protocol://<host>:port (where protocal is http/https/socks4/socks5)
   */
  const char *proxy;
  /**
   * Username to authenticate with proxy server
   */
  const char *proxy_username;
  /**
   * Password to authenticate with proxy server
   */
  const char *proxy_password;


  /**
   * Path to API trace file
   */
  const char *tracefile;

} sp_session_config;

/**
 * Initialize a session. The session returned will be initialized, but you will need
 * to log in before you can perform any other operation
 * Currently it is not supported to have multiple active sessions, and it's recommended to only call this once per process.
 *
 * Here is a snippet from \c spshell.c:
 * @dontinclude spshell.c
 * @skip config.api_version
 * @until }
 *
 * @param[in]   config    The configuration to use for the session
 * @param[out]  sess      If successful, a new session - otherwise NULL
 *
 * @return                One of the following errors, from ::sp_error
 *                        SP_ERROR_OK
 *                        SP_ERROR_BAD_API_VERSION
 *                        SP_ERROR_BAD_USER_AGENT
 *                        SP_ERROR_BAD_APPLICATION_KEY
 *                        SP_ERROR_API_INITIALIZATION_FAILED
 *                        SP_ERROR_INVALID_DEVICE_ID
 */
SP_LIBEXPORT(sp_error) sp_session_create(const sp_session_config *config, sp_session **sess);

/**
 * Release the session. This will clean up all data and connections associated with the session
 *
 * @param[in]   sess      Session object returned from sp_session_create()
 * @return                One of the following errors, from ::sp_error
 *                        SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_session_release(sp_session *sess);


/**
 * Logs in the specified username/password combo. This initiates the login in the background.
 * A callback is called when login is complete
 *
 * An application MUST NEVER store the user's password in clear text.
 * If automatic relogin is required, use sp_session_relogin()
 *
 * Here is a snippet from \c spshell.c:
 * @dontinclude spshell.c
 * @skip sp_session_login
 * @until }
 *
 * @param[in]   session             Your session object
 * @param[in]   username            The username to log in
 * @param[in]   password            The password for the specified username
 * @param[in]   remember_me         If set, the username / password will be remembered by libspotify
 * @param[in]   blob              If you have received a blob in the #credentials_blob_updated
 *                                  you can pas this here instead of password
 * @return                          One of the following errors, from ::sp_error
 *                                  SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_session_login(sp_session *session, const char *username, const char *password, bool remember_me, const char *blob);


/**
 * Log in the remembered user if last user that logged in logged in with remember_me set.
 * If no credentials are stored, this will return SP_ERROR_NO_CREDENTIALS.
 *
 * @param[in]   session      Your session object
 *
 * @return                 One of the following errors, from ::sp_error
 *                         SP_ERROR_OK
 *                         SP_ERROR_NO_CREDENTIALS
 */
SP_LIBEXPORT(sp_error) sp_session_relogin(sp_session *session);


/**
 * Get username of the user that will be logged in via sp_session_relogin()
 *
 * @param[in]   session      Your session object
 * @param[out]  buffer       The buffer to hold the username
 * @param[in]   buffer_size  The max size of the buffer that will hold the username.
 *                           The resulting string is guaranteed to always be null terminated if
 *                           buffer_size > 0
 *
 * @return                   The number of characters in the username.
 *                           If value is greater or equal than \p buffer_size, output was truncated.
 *                           If returned value is -1 no credentials are stored in libspotify.
 */
SP_LIBEXPORT(int) sp_session_remembered_user(sp_session *session, char *buffer, size_t buffer_size);


/**
 * Get a pointer to a string representing the user's login username.
 *
 * @param[in]   session         Your session object
 *
 * @return                   A string representing the login username.
 */
SP_LIBEXPORT(const char *) sp_session_user_name(sp_session *session);


/**
 * Remove stored credentials in libspotify. If no credentials are currently stored, nothing will happen.
 *
 * @param[in]   session      Your session object
 * @return                   One of the following errors, from ::sp_error
 *                           SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_session_forget_me(sp_session *session);


/**
 * Fetches the currently logged in user
 *
 * @param[in]   session    Your session object
 *
 * @return                 The logged in user (or NULL if not logged in)
 */
SP_LIBEXPORT(sp_user *) sp_session_user(sp_session *session);

/**
 * Logs out the currently logged in user
 *
 * Always call this before terminating the application and libspotify is currently
 * logged in. Otherwise, the settings and cache may be lost.
 *
 * @param[in]   session    Your session object
 * @return                 One of the following errors, from ::sp_error
 *                         SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_session_logout(sp_session *session);


/**
 * Flush the caches
 *
 * This will make libspotify write all data that is meant to be stored
 * on disk to the disk immediately. libspotify does this periodically
 * by itself and also on logout. So under normal conditions this
 * should never need to be used.
 *
 * @param[in]   session    Your session object
 * @return                 One of the following errors, from ::sp_error
 *                         SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_session_flush_caches(sp_session *session);

/**
 * The connection state of the specified session.
 *
 * @param[in]   session    Your session object
 *
 * @return                 The connection state - see the sp_connectionstate enum for possible values
 */
SP_LIBEXPORT(sp_connectionstate) sp_session_connectionstate(sp_session *session);

/**
 * The userdata associated with the session
 *
 * @param[in]   session    Your session object
 *
 * @return                 The userdata that was passed in on session creation
 */
SP_LIBEXPORT(void *) sp_session_userdata(sp_session *session);

/**
 * Set maximum cache size.
 *
 * @param[in]   session    Your session object
 * @param[in]   size       Maximum cache size in megabytes.
 *                         Setting it to 0 (the default) will let libspotify automatically
 *                         resize the cache (10% of disk free space)
 * @return                 One of the following errors, from ::sp_error
 *                         SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_session_set_cache_size(sp_session *session, size_t size);

/**
 * Make the specified session process any pending events
 *
 * @param[in]   session         Your session object
 * @param[out]  next_timeout    Stores the time (in milliseconds) until you should call this function again
 * @return                      One of the following errors, from ::sp_error
 *                              SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_session_process_events(sp_session *session, int *next_timeout);

/**
 * Loads the specified track
 *
 * After successfully loading the track, you have the option of running
 * sp_session_player_play() directly, or using sp_session_player_seek() first.
 * When this call returns, the track will have been loaded, unless an error occurred.
 *
 * @param[in]   session    Your session object
 * @param[in]   track      The track to be loaded
 *
 * @return                 One of the following errors, from ::sp_error
 *                         SP_ERROR_OK
 *                         SP_ERROR_MISSING_CALLBACK
 *                         SP_ERROR_TRACK_NOT_PLAYABLE
 *
 */
SP_LIBEXPORT(sp_error) sp_session_player_load(sp_session *session, sp_track *track);

/**
 * Seek to position in the currently loaded track
 *
 * @param[in]   session    Your session object
 * @param[in]   offset     Track position, in milliseconds.
 * @return                 One of the following errors, from ::sp_error
 *                         SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_session_player_seek(sp_session *session, int offset);

/**
 * Play or pause the currently loaded track
 *
 * @param[in]   session    Your session object
 * @param[in]   play       If set to true, playback will occur. If set to false, the playback will be paused.
 * @return                 One of the following errors, from ::sp_error
 *                         SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_session_player_play(sp_session *session, bool play);

/**
 * Stops the currently playing track
 *
 * This frees some resources held by libspotify to identify the currently
 * playing track.
 *
 * @param[in]   session    Your session object
 * @return                 One of the following errors, from ::sp_error
 *                         SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_session_player_unload(sp_session *session);

/**
 * Prefetch a track
 *
 * Instruct libspotify to start loading of a track into its cache.
 * This could be done by an application just before the current track ends.
 *
 * @param[in]   session    Your session object
 * @param[in]   track      The track to be prefetched
 *
 * @return                 One of the following errors, from ::sp_error
 *                         SP_ERROR_NO_CACHE
 *                         SP_ERROR_OK
 *
 * @note Prefetching is only possible if a cache is configured
 *
 */
SP_LIBEXPORT(sp_error) sp_session_player_prefetch(sp_session *session, sp_track *track);

/**
 * Returns the playlist container for the currently logged in user.
 *
 * @param[in]   session    Your session object
 *
 * @return                 Playlist container object, NULL if not logged in
 */
SP_LIBEXPORT(sp_playlistcontainer *) sp_session_playlistcontainer(sp_session *session);

/**
 * Returns an inbox playlist for the currently logged in user
 *
 * @param[in]  session        Session object
 *
 * @return     A playlist or NULL if no user is logged in
 * @note You need to release the playlist when you are done with it.
 * @see sp_playlist_release()
 */
SP_LIBEXPORT(sp_playlist *) sp_session_inbox_create(sp_session *session);

/**
 * Returns the starred list for the current user
 *
 * @param[in]  session        Session object
 *
 * @return     A playlist or NULL if no user is logged in
 * @note You need to release the playlist when you are done with it.
 * @see sp_playlist_release()
 */
SP_LIBEXPORT(sp_playlist *) sp_session_starred_create(sp_session *session);

/**
 * Returns the starred list for a user
 *
 * @param[in]  session        Session object
 * @param[in]  canonical_username       Canonical username
 *
 * @return     A playlist or NULL if no user is logged in
 * @note You need to release the playlist when you are done with it.
 * @see sp_playlist_release()
 */
SP_LIBEXPORT(sp_playlist *) sp_session_starred_for_user_create(sp_session *session, const char *canonical_username);

/**
 * Return the published container for a given @a canonical_username,
 * or the currently logged in user if @a canonical_username is NULL.
 *
 * When done with the list you should call sp_playlistconatiner_release() to
 * decrese the reference you own by having created it.
 *
 * @param[in]   session    Your session object.
 * @param[in]   canonical_username   The canonical username, or NULL.
 *
 * @return Playlist container object, NULL if not logged in.
 */
SP_LIBEXPORT(sp_playlistcontainer *) sp_session_publishedcontainer_for_user_create(sp_session *session, const char *canonical_username);


/**
 * Set preferred bitrate for music streaming
 *
 * @param[in]  session        Session object
 * @param[in]  bitrate        Preferred bitrate, see ::sp_bitrate for possible values
 * @return                    One of the following errors, from ::sp_error
 *                            SP_ERROR_OK
 *                            SP_ERROR_INVALID_ARGUMENT
 */
SP_LIBEXPORT(sp_error) sp_session_preferred_bitrate(sp_session *session, sp_bitrate bitrate);


/**
 * Set preferred bitrate for offline sync
 *
 * @param[in]  session        Session object
 * @param[in]  bitrate        Preferred bitrate, see ::sp_bitrate for possible values
 * @param[in]  allow_resync   Set to true if libspotify should resynchronize already synchronized tracks. Usually you should set this to false.
 * @return                   One of the following errors, from ::sp_error
 *                           SP_ERROR_OK
 *                           SP_ERROR_INVALID_ARGUMENT
 */
SP_LIBEXPORT(sp_error) sp_session_preferred_offline_bitrate(sp_session *session, sp_bitrate bitrate, bool allow_resync);


/**
 * Return status of volume normalization
 *
 * @param[in]  session        Session object
 *
 * @return true iff volume normalization is enabled
 *
 */
SP_LIBEXPORT(bool) sp_session_get_volume_normalization(sp_session *session);


/**
 * Set volume normalization
 *
 * @param[in]  session        Session object
 * @param[in]  on             True iff volume normalization should be enabled
 * @return                    One of the following errors, from ::sp_error
 *                            SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_session_set_volume_normalization(sp_session *session, bool on);


/**
 * Set if private session is enabled. This disables sharing what the user is listening to
 * to services such as Spotify Social, Facebook and LastFM. The private session will
 * last for a time, and then libspotify will revert to the normal state. The private
 * session is prolonged by user activity.
 *
 * @param[in]  session         Session object
 * @param[in]  enabled         True iff private session should be enabled
 * @return                     One of the following errors, from ::sp_error
 *                             SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_session_set_private_session(sp_session *session, bool enabled);

/**
 * Return True if private session is enabled
 *
 * @param[in]  session         Session object
 *
 * @return     True if private session is enabled
 */
SP_LIBEXPORT(bool) sp_session_is_private_session(sp_session *session);

/**
 * Set if scrobbling is enabled. This api allows setting local overrides of the global scrobbling settings.
 * Changing the global settings are currently not supported.
 *
 * @param[in]  session         Session object
 * @param[in]  provider        The scrobbling provider referred to
 * @param[in]  state           The state to set the provider to
 *
 * @return     error code
 *
 * @see sp_social_provider
 * @see sp_scrobbling_state
 */
SP_LIBEXPORT(sp_error) sp_session_set_scrobbling(sp_session *session, sp_social_provider provider, sp_scrobbling_state state);

/**
 * Return the scrobbling state. This makes it possible to find out if scrobbling is locally overrided or
 * if the global setting is used.
 *
 * @param[in]  session         Session object
 * @param[in]  provider        The scrobbling provider referred to
 * @param[out] state           The output variable receiving the sp_scrobbling_state state
 *
 * @return     error code
 */
SP_LIBEXPORT(sp_error) sp_session_is_scrobbling(sp_session *session, sp_social_provider provider, sp_scrobbling_state* state);

/**
 * Return True if scrobbling settings should be shown to the user. Currently this setting is relevant
 * only to the facebook provider.
 * The returned value may be false if the user is not connected to facebook,
 * or if the user has opted out from facebook social graph.
 *
 * @param[in]  session         Session object
 * @param[in]  provider        The scrobbling provider referred to
 * @param[out] out             True iff scrobbling is possible
 *
 * @return     error code
 */
  SP_LIBEXPORT(sp_error) sp_session_is_scrobbling_possible(sp_session *session, sp_social_provider provider, bool* out);

/**
 * Set the user's credentials with a social provider.
 * Currently this is only relevant for LastFm
 * Call sp_session_set_scrobbling to force an authentication attempt
 * with the LastFm server. If authentication fails a scrobble_error callback will be
 * sent.
 *
 * @param[in]  session         Session object
 * @param[in]  provider        The scrobbling provider referred to
 * @param[in]  username        The user name
 * @param[in]  password        The password
 *
 * @return     error code

 * @see sp_session_set_scrobbling
 * @see sp_session_callbacks#scrobble_error
 * @return                     One of the following errors, from ::sp_error
 *                             SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_session_set_social_credentials(sp_session *session, sp_social_provider provider, const char* username, const char* password);

/**
 * Set to true if the connection is currently routed over a roamed connectivity
 *
 * @param[in]  session        Session object
 * @param[in]  type           Connection type
 *
 * @note       Used in conjunction with sp_session_set_connection_rules() to control
 *             how libspotify should behave in respect to network activity and offline
 *             synchronization.
 * @see        sp_connection_type
 * @return     One of the following errors, from ::sp_error
 *             SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_session_set_connection_type(sp_session *session, sp_connection_type type);


/**
 * Set rules for how libspotify connects to Spotify servers and synchronizes offline content
 *
 * @param[in]  session        Session object
 * @param[in]  rules          Connection rules
 *
 * @note       Used in conjunction with sp_session_set_connection_type() to control
 *             how libspotify should behave in respect to network activity and offline
 *             synchronization.
 * @see        sp_connection_rules
 * @return     One of the following errors, from ::sp_error
 *             SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_session_set_connection_rules(sp_session *session, sp_connection_rules rules);



/**
 * Get total number of tracks that needs download before everything
 * from all playlists that is marked for offline is fully synchronized
 *
 * @param[in]  session        Session object
 *
 * @return Number of tracks
 */
SP_LIBEXPORT(int) sp_offline_tracks_to_sync(sp_session *session);

/**
 * Return number of playlisys that is marked for offline synchronization
 *
 * @param[in]  session        Session object
 *
 * @return Number of playlists
 */
SP_LIBEXPORT(int) sp_offline_num_playlists(sp_session *session);

/**
 * Return offline synchronization status. When the internal status is
 * updated the offline_status_updated() callback will be invoked.
 *
 * @param[in]  session        Session object
 * @param[out] status         Status object that will be filled with info
 *
 * @return false if no synching is in progress (in which case the contents
 *               of status is undefined)
 *
 */
SP_LIBEXPORT(bool) sp_offline_sync_get_status(sp_session *session, sp_offline_sync_status *status);

/**
 * Return remaining time (in seconds) until the offline key store expires
 * and the user is required to relogin
 *
 * @param[in]  session        Session object
 * @return                    Seconds until expiration
 *
 */
SP_LIBEXPORT(int) sp_offline_time_left(sp_session *session);

/**
 * Get currently logged in users country
 * updated the offline_status_updated() callback will be invoked.
 *
 * @param[in]  session        Session object
 *
 * @return  Country encoded in an integer 'SE' = 'S' << 8 | 'E'
 */
SP_LIBEXPORT(int) sp_session_user_country(sp_session *session);


/** @} */


/**
 * @defgroup link Links (Spotify URIs)
 *
 * These functions handle links to Spotify entities in a way that allows you to
 * not care about the textual representation of the link.
 * @{
 */

/**
 * Link types
 */
typedef enum {
  SP_LINKTYPE_INVALID  = 0, ///< Link type not valid - default until the library has parsed the link, or when parsing failed
  SP_LINKTYPE_TRACK    = 1, ///< Link type is track
  SP_LINKTYPE_ALBUM    = 2, ///< Link type is album
  SP_LINKTYPE_ARTIST   = 3, ///< Link type is artist
  SP_LINKTYPE_SEARCH   = 4, ///< Link type is search
  SP_LINKTYPE_PLAYLIST = 5, ///< Link type is playlist
  SP_LINKTYPE_PROFILE  = 6, ///< Link type is profile
  SP_LINKTYPE_STARRED  = 7, ///< Link type is starred
  SP_LINKTYPE_LOCALTRACK  = 8, ///< Link type is a local file
  SP_LINKTYPE_IMAGE = 9, ///< Link type is an image
} sp_linktype;

/**
 * Create a Spotify link given a string
 *
 * @param[in]   link       A string representation of a Spotify link
 *
 * @return                 A link representation of the given string representation.
 *                         If the link could not be parsed, this function returns NULL.
 *
 * @note You need to release the link when you are done with it.
 * @see sp_link_type()
 * @see sp_link_release()
 */
SP_LIBEXPORT(sp_link *) sp_link_create_from_string(const char *link);

/**
 * Generates a link object from a track
 *
 * @param[in]   track        A track object
 * @param[in]   offset       Offset in track in ms.
 *
 * @return                   A link representing the track
 *
 * @note You need to release the link when you are done with it.
 * @see sp_link_release()
 */
SP_LIBEXPORT(sp_link *) sp_link_create_from_track(sp_track *track, int offset);

/**
 * Create a link object from an album
 *
 * @param[in]   album      An album object
 *
 * @return                 A link representing the album
 *
 * @note You need to release the link when you are done with it.
 * @see sp_link_release()
 */
SP_LIBEXPORT(sp_link *) sp_link_create_from_album(sp_album *album);

/**
 * Create an image link object from an album
 *
 * @param[in]   album      An album object
 * @param[in]   size       The desired size of the image
 *
 * @return                 A link representing the album cover. Type is set to SP_LINKTYPE_IMAGE
 *
 * @note You need to release the link when you are done with it.
 * @see sp_link_release()
 */
SP_LIBEXPORT(sp_link *) sp_link_create_from_album_cover(sp_album *album, sp_image_size size);

/**
 * Creates a link object from an artist
 *
 * @param[in]   artist     An artist object
 *
 * @return                 A link object representing the artist
 *
 * @note You need to release the link when you are done with it.
 * @see sp_link_release()
 */
SP_LIBEXPORT(sp_link *) sp_link_create_from_artist(sp_artist *artist);

/**
 * Creates a link object pointing to an artist portrait
 *
 * @param[in]   artist     Artist browse object
 * @param[in]   size       The desired size of the image
 *
 * @return                 A link object representing an image
 *
 * @note You need to release the link when you are done with it.
 * @see sp_link_release()
 * @see sp_artistbrowse_num_portraits()
 */
SP_LIBEXPORT(sp_link *) sp_link_create_from_artist_portrait(sp_artist *artist, sp_image_size size);


/**
 * Creates a link object from an artist portrait
 *
 * @param[in]   arb        Artist browse object
 * @param[in]   index      The index of the portrait. Should be in the interval [0, sp_artistbrowse_num_portraits() - 1]
 *
 * @return                 A link object representing an image
 *
 * @note You need to release the link when you are done with it.
 * @see sp_link_release()
 * @see sp_artistbrowse_num_portraits()
 *
 * @note The difference from sp_link_create_from_artist_portrait() is
 * that the artist browse object may contain multiple portraits.
 *
 */
SP_LIBEXPORT(sp_link *) sp_link_create_from_artistbrowse_portrait(sp_artistbrowse *arb, int index);


/**
 * Generate a link object representing the current search
 *
 * @param[in]  search       Search object
 *
 * @return                  A link representing the search
 *
 * @note You need to release the link when you are done with it.
 * @see sp_link_release()
 */
SP_LIBEXPORT(sp_link *) sp_link_create_from_search(sp_search *search);

/**
 * Create a link object representing the given playlist
 *
 * @param[in]  playlist       Playlist object
 *
 * @return                    A link representing the playlist
 *
 * @note You need to release the link when you are done with it.
 * @see sp_link_release()
 *
 * @note Due to reasons in the playlist backend design and the Spotify URI
 * scheme you need to wait for the playlist to be loaded before you can
 * successfully construct an URI. If sp_link_create_from_playlist() returns
 * NULL, try again after teh playlist_state_changed callback has fired.
 */
SP_LIBEXPORT(sp_link *) sp_link_create_from_playlist(sp_playlist *playlist);

/**
 * Create a link object representing the given playlist
 *
 * @param[in]  user       User object
 *
 * @return                    A link representing the profile.
 *
 * @note You need to release the link when you are done with it.
 * @see sp_link_release()
 */
SP_LIBEXPORT(sp_link *) sp_link_create_from_user(sp_user *user);

/**
 * Create a link object representing the given image
 *
 * @param[in]  image          Image object
 *
 * @return                    A link representing the image.
 *
 * @note You need to release the link when you are done with it.
 * @see sp_link_release()
 */
SP_LIBEXPORT(sp_link *) sp_link_create_from_image(sp_image *image);

/**
 * Create a string representation of the given Spotify link
 *
 * @param[in]   link         The Spotify link whose string representation you are interested in
 * @param[out]  buffer       The buffer to hold the string representation of link
 * @param[in]   buffer_size  The max size of the buffer that will hold the string representation
 *                           The resulting string is guaranteed to always be null terminated if
 *                           buffer_size > 0
 *
 * @return                   The number of characters in the string representation of the link. If this
 *                           value is greater or equal than \p buffer_size, output was truncated.
 */
SP_LIBEXPORT(int) sp_link_as_string(sp_link *link, char *buffer, int buffer_size);

/**
 * The link type of the specified link
 *
 * @param[in]   link       The Spotify link whose type you are interested in
 *
 * @return                 The link type of the specified link - see the sp_linktype enum for possible values
 */
SP_LIBEXPORT(sp_linktype) sp_link_type(sp_link *link);

/**
 * The track representation for the given link
 *
 * @param[in]   link       The Spotify link whose track you are interested in
 *
 * @return                 The track representation of the given track link
 *                         If the link is not of track type then NULL is returned.
 */
SP_LIBEXPORT(sp_track *) sp_link_as_track(sp_link *link);

/**
 * The track and offset into track representation for the given link
 *
 * @param[in]   link       The Spotify link whose track you are interested in
 * @param[out]  offset     Pointer to offset into track (in milliseconds). If the link
 *                         does not contain an offset this will be set to 0.
 *
 * @return                 The track representation of the given track link
 *                         If the link is not of track type then NULL is returned.
 */
SP_LIBEXPORT(sp_track *) sp_link_as_track_and_offset(sp_link *link, int *offset);

/**
 * The album representation for the given link
 *
 * @param[in]   link       The Spotify link whose album you are interested in
 *
 * @return                 The album representation of the given album link
 *                         If the link is not of album type then NULL is returned
 */
SP_LIBEXPORT(sp_album *) sp_link_as_album(sp_link *link);

/**
 * The artist representation for the given link
 *
 * @param[in]   link       The Spotify link whose artist you are interested in
 *
 * @return                 The artist representation of the given link
 *                         If the link is not of artist type then NULL is returned
 */
SP_LIBEXPORT(sp_artist *) sp_link_as_artist(sp_link *link);


/**
 * The user representation for the given link
 *
 * @param[in]   link       The Spotify link whose user you are interested in
 *
 * @return                 The user representation of the given link
 *                         If the link is not of user type then NULL is returned
 */
SP_LIBEXPORT(sp_user *) sp_link_as_user(sp_link *link);


/**
 * Increase the reference count of a link
 *
 * @param[in]   link       The link object
 * @return                 One of the following errors, from ::sp_error
 *                         SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_link_add_ref(sp_link *link);

/**
 * Decrease the reference count of a link
 *
 * @param[in]   link       The link object
 * @return                 One of the following errors, from ::sp_error
 *                         SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_link_release(sp_link *link);

/** @} */



/**
 * @defgroup track Track subsystem
 * @{
 */

/**
 * Return whether or not the track metadata is loaded.
 *
 * @param[in]   track      The track
 *
 * @return                 True if track is loaded
 *
 * @note  This is equivalent to checking if sp_track_error() not returns SP_ERROR_IS_LOADING.
 */
SP_LIBEXPORT(bool) sp_track_is_loaded(sp_track *track);

/**
 * Return an error code associated with a track. For example if it could not load
 *
 * @param[in]   track      The track
 *
 * @return                 One of the following errors, from ::sp_error
 *                         SP_ERROR_OK
 *                         SP_ERROR_IS_LOADING
 *                         SP_ERROR_OTHER_PERMANENT
 */
SP_LIBEXPORT(sp_error) sp_track_error(sp_track *track);


/**
 * Return offline status for a track. sp_session_callbacks::metadata_updated() will be invoked when
 * offline status of a track changes
 *
 * @param[in]   track      The track
 *
 * @return                 Stats as described by ::sp_track_offline_status
 *
 */
SP_LIBEXPORT(sp_track_offline_status) sp_track_offline_get_status(sp_track *track);

/**
 * Return availability for a track
 *
 * @param[in]   session    Session
 * @param[in]   track      The track
 *
 * @return                 Availability status, see ::sp_track_availability
 *
 * @note The track must be loaded or this function will always SP_TRACK_AVAILABILITY_UNAVAILABLE
 * @see sp_track_is_loaded()
 */
SP_LIBEXPORT(sp_track_availability) sp_track_get_availability(sp_session *session, sp_track *track);

/**
 * Return true if the track is a local file.
 *
 * @param[in]   session    Session
 * @param[in]   track      The track
 *
 * @return                 True if track is a local file.
 *
 * @note The track must be loaded or this function will always return false.
 * @see sp_track_is_loaded()
 */
SP_LIBEXPORT(bool) sp_track_is_local(sp_session *session, sp_track *track);

/**
 * Return true if the track is autolinked to another track.
 *
 * @param[in]   session    Session
 * @param[in]   track      The track
 *
 * @return                 True if track is autolinked.
 *
 * @note The track must be loaded or this function will always return false.
 * @see sp_track_is_loaded()
 */
SP_LIBEXPORT(bool) sp_track_is_autolinked(sp_session *session, sp_track *track);


/**
 * Return the actual track that will be played if the given track is played
 *
 * @param[in]   session    Session
 * @param[in]   track      The track
 *
 * @return                 A track
 *
 */
SP_LIBEXPORT(sp_track *) sp_track_get_playable(sp_session *session, sp_track *track);

/**
 * Return true if the track is a placeholder. Placeholder tracks are used
 * to store other objects than tracks in the playlist. Currently this is
 * used in the inbox to store artists, albums and playlists.
 *
 * Use sp_link_create_from_track() to get a link object that points
 * to the real object this "track" points to.
 *
 * @param[in]   track      The track
 *
 * @return                 True if track is a placeholder
 *
 * @note Contrary to most functions the track does not have to be
 *       loaded for this function to return correct value
 */
SP_LIBEXPORT(bool) sp_track_is_placeholder(sp_track *track);


/**
 * Return true if the track is starred by the currently logged in user.
 *
 * @param[in]   session    Session
 * @param[in]   track      The track
 *
 * @return                 True if track is starred.
 *
 * @note The track must be loaded or this function will always return false.
 * @see sp_track_is_loaded()
 */
SP_LIBEXPORT(bool) sp_track_is_starred(sp_session *session, sp_track *track);

/**
 * Star/Unstar the specified track
 *
 * @param[in]   session    Session
 * @param[in]   tracks     Array of pointer to tracks.
 * @param[in]   num_tracks Length of \p tracks array
 * @param[in]   star       Starred status of the track
 *
 * @note This will fail silently if playlists are disabled.
 * @see sp_set_playlists_enabled()
 */
SP_LIBEXPORT(sp_error) sp_track_set_starred(sp_session *session, sp_track *const*tracks, int num_tracks, bool star);

/**
 * The number of artists performing on the specified track
 *
 * @param[in]   track     The track whose number of participating artists you are interested in
 *
 * @return                The number of artists performing on the specified track.
 *                        If no metadata is available for the track yet, this function returns 0.
 */
SP_LIBEXPORT(int) sp_track_num_artists(sp_track *track);

/**
 * The artist matching the specified index performing on the current track.
 *
 * @param[in]   track      The track whose participating artist you are interested in
 * @param[in]   index      The index for the participating artist. Should be in the interval [0, sp_track_num_artists() - 1]
 *
 * @return                 The participating artist, or NULL if invalid index
 */
SP_LIBEXPORT(sp_artist *) sp_track_artist(sp_track *track, int index);

/**
 * The album of the specified track
 *
 * @param[in]   track      A track object
 *
 * @return                 The album of the given track. You need to increase the refcount
 *                         if you want to keep the pointer around.
 *                         If no metadata is available for the track yet, this function returns 0.
 */
SP_LIBEXPORT(sp_album *) sp_track_album(sp_track *track);

/**
 * The string representation of the specified track's name
 *
 * @param[in]   track      A track object
 *
 * @return                 The string representation of the specified track's name.
 *                         Returned string is valid as long as the album object stays allocated
 *                         and no longer than the next call to sp_session_process_events()
 *                         If no metadata is available for the track yet, this function returns empty string.
 */
SP_LIBEXPORT(const char *) sp_track_name(sp_track *track);

/**
 * The duration, in milliseconds, of the specified track
 *
 * @param[in]   track      A track object
 *
 * @return                 The duration of the specified track, in milliseconds
 *                         If no metadata is available for the track yet, this function returns 0.
 */
SP_LIBEXPORT(int) sp_track_duration(sp_track *track);

/**
 * Returns popularity for track
 *
 * @param[in]   track      A track object
 *
 * @return                 Popularity in range 0 to 100, 0 if undefined.
 *                         If no metadata is available for the track yet, this function returns 0.
 */
SP_LIBEXPORT(int) sp_track_popularity(sp_track *track);

/**
 * Returns the disc number for a track
 *
 * @param[in]   track      A track object
 *
 * @return                 Disc index. Possible values are [1, total number of discs on album]
 *                         This function returns valid data only for tracks appearing in a browse
 *                         artist or browse album result (otherwise returns 0).
 */
SP_LIBEXPORT(int) sp_track_disc(sp_track *track);

/**
 * Returns the position of a track on its disc
 *
 * @param[in]   track      A track object
 *
 * @return                 Track position, starts at 1 (relative the corresponding disc)
 *                         This function returns valid data only for tracks appearing in a browse
 *                         artist or browse album result (otherwise returns 0).
 */
SP_LIBEXPORT(int) sp_track_index(sp_track *track);

/**
 * Returns the newly created local track
 *
 * @param[in]   artist     Name of the artist
 * @param[in]   title      Song title
 * @param[in]   album      Name of the album, or an empty string if not available
 * @param[in]   length      Length in MS, or -1 if not available.
 *
 * @return                 A track.
 */
SP_LIBEXPORT(sp_track *) sp_localtrack_create(const char *artist, const char *title, const char *album, int length);

/**
 * Increase the reference count of a track
 *
 * @param[in]   track       The track object
 * @return                  One of the following errors, from ::sp_error
 *                          SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_track_add_ref(sp_track *track);

/**
 * Decrease the reference count of a track
 *
 * @param[in]   track       The track object
 * @return                  One of the following errors, from ::sp_error
 *                          SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_track_release(sp_track *track);

/** @} */



/**
 * @defgroup album Album subsystem
 * @{
 */

/**
 * Album types
 */
typedef enum {
  SP_ALBUMTYPE_ALBUM       = 0, ///< Normal album
  SP_ALBUMTYPE_SINGLE      = 1, ///< Single
  SP_ALBUMTYPE_COMPILATION = 2, ///< Compilation
  SP_ALBUMTYPE_UNKNOWN     = 3, ///< Unknown type
} sp_albumtype;

/**
 * Check if the album object is populated with data
 *
 * @param[in]  album       Album object
 * @return True if metadata is present, false if not
 */
SP_LIBEXPORT(bool) sp_album_is_loaded(sp_album *album);


/**
 * Return true if the album is available in the current region.
 *
 * @param[in]   album      The album
 *
 * @return                 True if album is available for playback, otherwise false.
 *
 * @note The album must be loaded or this function will always return false.
 * @see sp_album_is_loaded()
 */
SP_LIBEXPORT(bool) sp_album_is_available(sp_album *album);

/**
 * Get the artist associated with the given album
 *
 * @param[in]  album       Album object
 * @return A reference to the artist. NULL if the metadata has not been loaded yet
 */
SP_LIBEXPORT(sp_artist *) sp_album_artist(sp_album *album);

/**
 * Return image ID representing the album's coverart.
 *
 * @param[in]   album      Album object
 * @param[in]   size       The desired size of the image
 *
 * @return                 ID byte sequence that can be passed to sp_image_create()
 *                         If the album has no image or the metadata for the album is not
 *                         loaded yet, this function returns NULL.
 *
 * @see sp_image_create
 */
SP_LIBEXPORT(const byte *) sp_album_cover(sp_album *album, sp_image_size size);

/**
 * Return name of album
 *
 * @param[in]   album      Album object
 *
 * @return                 Name of album.
 *                         Returned string is valid as long as the album object stays allocated
 *                         and no longer than the next call to sp_session_process_events()
 */
SP_LIBEXPORT(const char *) sp_album_name(sp_album *album);

/**
 * Return release year of specified album
 *
 * @param[in]   album      Album object
 *
 * @return                 Release year
 */
SP_LIBEXPORT(int) sp_album_year(sp_album *album);


/**
 * Return type of specified album
 *
 * @param[in]   album      Album object
 *
 * @return                 sp_albumtype
 */
SP_LIBEXPORT(sp_albumtype) sp_album_type(sp_album *album);


/**
 * Increase the reference count of an album
 *
 * @param[in]   album       The album object
 * @return                  One of the following errors, from ::sp_error
 *                          SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_album_add_ref(sp_album *album);

/**
 * Decrease the reference count of an album
 *
 * @param[in]   album       The album object
 * @return                  One of the following errors, from ::sp_error
 *                          SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_album_release(sp_album *album);

/** @} */



/**
 * @defgroup artist Artist subsystem
 * @{
 */

/**
 * Return name of artist
 *
 * @param[in]   artist     Artist object
 *
 * @return                 Name of artist.
 *                         Returned string is valid as long as the artist object stays allocated
 *                         and no longer than the next call to sp_session_process_events()
 */
SP_LIBEXPORT(const char *) sp_artist_name(sp_artist *artist);

/**
 * Check if the artist object is populated with data
 *
 * @param[in]   artist     An artist object
 *
 * @return                 True if metadata is present, false if not
 *
 */
SP_LIBEXPORT(bool) sp_artist_is_loaded(sp_artist *artist);

/**
 * Return portrait for artist
 *
 * @param[in]   artist     The artist object
 * @param[in]   size       The desired size of the image
 *
 * @return                 ID byte sequence that can be passed to sp_image_create()
 *                         If the artist has no image or the metadata for the album is not
 *                         loaded yet, this function returns NULL.
 *
 */
SP_LIBEXPORT(const byte *) sp_artist_portrait(sp_artist *artist, sp_image_size size);

/**
 * Increase the reference count of a artist
 *
 * @param[in]   artist       The artist object
 * @return                   One of the following errors, from ::sp_error
 *                           SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_artist_add_ref(sp_artist *artist);

/**
 * Decrease the reference count of a artist
 *
 * @param[in]   artist       The artist object
 * @return                   One of the following errors, from ::sp_error
 *                           SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_artist_release(sp_artist *artist);

/** @} */


/**
 * @defgroup albumbrowse Album browsing
 *
 * Browsing adds additional information to what an ::sp_album holds. It retrieves
 * copyrights, reviews and tracks of the album.
 *
 * @{
 */

/**
 * The type of a callback used in sp_albumbrowse_create()
 *
 * When the callback is called, the metadata of all tracks belonging to it will have
 * been loaded, so sp_track_is_loaded() will return non-zero. The ::sp_artist of the
 * album will also have been fully loaded.
 *
 * @param[in]   result          The same pointer returned by sp_albumbrowse_create()
 * @param[in]   userdata        The opaque pointer given to sp_albumbrowse_create()
 */
typedef void SP_CALLCONV albumbrowse_complete_cb(sp_albumbrowse *result, void *userdata);

/**
 * Initiate a request for browsing an album
 *
 * The user is responsible for freeing the returned album browse using sp_albumbrowse_release(). This can be done in the callback.
 *
 * @param[in]   session         Session object
 * @param[in]   album           Album to be browsed. The album metadata does not have to be loaded
 * @param[in]   callback        Callback to be invoked when browsing has been completed. Pass NULL if you are not interested in this event.
 * @param[in]   userdata        Userdata passed to callback.
 *
 * @return                      Album browse object
 *
 * @see ::albumbrowse_complete_cb
 */
SP_LIBEXPORT(sp_albumbrowse *) sp_albumbrowse_create(sp_session *session, sp_album *album, albumbrowse_complete_cb *callback, void *userdata);

/**
 * Check if an album browse request is completed
 *
 * @param[in]   alb        Album browse object
 *
 * @return                 True if browsing is completed, false if not
 */
SP_LIBEXPORT(bool) sp_albumbrowse_is_loaded(sp_albumbrowse *alb);


/**
* Check if browsing returned an error code.
*
* @param[in]   alb        Album browse object
*
* @return                 One of the following errors, from ::sp_error
*                         SP_ERROR_OK
*                         SP_ERROR_IS_LOADING
*                         SP_ERROR_OTHER_PERMANENT
*                         SP_ERROR_OTHER_TRANSIENT
*/
SP_LIBEXPORT(sp_error) sp_albumbrowse_error(sp_albumbrowse *alb);

/**
 * Given an album browse object, return the pointer to its album object
 *
 * @param[in]   alb        Album browse object
 *
 * @return                 Album object
 */
SP_LIBEXPORT(sp_album *) sp_albumbrowse_album(sp_albumbrowse *alb);

/**
 * Given an album browse object, return the pointer to its artist object
 *
 * @param[in]   alb        Album browse object
 *
 * @return                 Artist object
 */
SP_LIBEXPORT(sp_artist *) sp_albumbrowse_artist(sp_albumbrowse *alb);

/**
 * Given an album browse object, return number of copyright strings
 *
 * @param[in]   alb        Album browse object
 *
 * @return                 Number of copyright strings available, 0 if unknown
 */
SP_LIBEXPORT(int) sp_albumbrowse_num_copyrights(sp_albumbrowse *alb);

/**
 * Given an album browse object, return one of its copyright strings
 *
 * @param[in]   alb           Album browse object
 * @param[in]   index         The index for the copyright string. Should be in the interval [0, sp_albumbrowse_num_copyrights() - 1]
 *
 * @return                    Copyright string in UTF-8 format, or NULL if the index is invalid.
 *                            Returned string is valid as long as the album object stays allocated
 *                            and no longer than the next call to sp_session_process_events()
 */
SP_LIBEXPORT(const char *) sp_albumbrowse_copyright(sp_albumbrowse *alb, int index);

/**
 * Given an album browse object, return number of tracks
 *
 * @param[in]   alb         Album browse object
 *
 * @return                  Number of tracks on album
 */
SP_LIBEXPORT(int) sp_albumbrowse_num_tracks(sp_albumbrowse *alb);

/**
 * Given an album browse object, return a pointer to one of its tracks
 *
 * @param[in]   alb        Album browse object
 * @param[in]   index      The index for the track. Should be in the interval [0, sp_albumbrowse_num_tracks() - 1]
 *
 * @return                 A track.
 *
 * @see track
 */
SP_LIBEXPORT(sp_track *) sp_albumbrowse_track(sp_albumbrowse *alb, int index);

/**
 * Given an album browse object, return its review
 *
 * @param[in]   alb        Album browse object
 *
 * @return                 Review string in UTF-8 format.
 *                         Returned string is valid as long as the album object stays allocated
 *                         and no longer than the next call to sp_session_process_events()
 */
SP_LIBEXPORT(const char *) sp_albumbrowse_review(sp_albumbrowse *alb);

/**
 * Return the time (in ms) that was spent waiting for the Spotify backend to serve the request
 *
 * @param[in] alb         Album browse object
 *
 * @return                -1 if the request was served from the local cache
 *                        If the result is not yet loaded the return value is undefined
 */
SP_LIBEXPORT(int) sp_albumbrowse_backend_request_duration(sp_albumbrowse *alb);


/**
 * Increase the reference count of an album browse result
 *
 * @param[in]   alb       The album browse result object
 * @return                One of the following errors, from ::sp_error
 *                        SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_albumbrowse_add_ref(sp_albumbrowse *alb);

/**
 * Decrease the reference count of an album browse result
 *
 * @param[in]   alb       The album browse result object
 * @return                One of the following errors, from ::sp_error
 *                        SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_albumbrowse_release(sp_albumbrowse *alb);

/** @} */


/**
 * @defgroup artistbrowse Artist browsing
 *
 * Artist browsing initiates the fetching of information for a certain artist.
 *
 * @note   There is currently no built-in functionality available for getting the albums belonging
 *         to an artist. For now, just iterate over all tracks and note the album to build a list of all albums.
 *         This feature will be added in a future version of the library.
 *
 * @{
 */

/**
 * The type of a callback used in sp_artistbrowse_create()
 *
 * When the callback is called, the metadata of all tracks belonging to it will have
 * been loaded, so sp_track_is_loaded() will return non-zero. The same goes for the
 * similar artist data.
 *
 * @param[in]   result          The same pointer returned by sp_artistbrowse_create()
 * @param[in]   userdata        The opaque pointer given to sp_artistbrowse_create()
 */
typedef void SP_CALLCONV artistbrowse_complete_cb(sp_artistbrowse *result, void *userdata);

/**
 * Initiate a request for browsing an artist
 *
 * The user is responsible for freeing the returned artist browse using sp_artistbrowse_release(). This can be done in the callback.
 *
 * @param[in] session         Session object
 * @param[in] artist          Artist to be browsed. The artist metadata does not have to be loaded
 * @param[in] type            Type of data requested, see the sp_artistbrowse_type enum for details
 * @param[in] callback        Callback to be invoked when browsing has been completed. Pass NULL if you are not interested in this event.
 * @param[in] userdata        Userdata passed to callback.
 *
 * @return                    Artist browse object
 *
 * @see ::artistbrowse_complete_cb
 */
SP_LIBEXPORT(sp_artistbrowse *) sp_artistbrowse_create(sp_session *session, sp_artist *artist, sp_artistbrowse_type type, artistbrowse_complete_cb *callback, void *userdata);

/**
 * Check if an artist browse request is completed
 *
 * @param[in]   arb        Artist browse object
 *
 * @return                 True if browsing is completed, false if not
 */
SP_LIBEXPORT(bool) sp_artistbrowse_is_loaded(sp_artistbrowse *arb);

/**
* Check if browsing returned an error code.
*
* @param[in]   arb        Artist browse object
*
* @return                 One of the following errors, from ::sp_error
*                         SP_ERROR_OK
*                         SP_ERROR_IS_LOADING
*                         SP_ERROR_OTHER_PERMANENT
*                         SP_ERROR_OTHER_TRANSIENT
*/
SP_LIBEXPORT(sp_error) sp_artistbrowse_error(sp_artistbrowse *arb);

/**
 * Given an artist browse object, return a pointer to its artist object
 *
 * @param[in]   arb        Artist browse object
 *
 * @return                 Artist object
 */
SP_LIBEXPORT(sp_artist *) sp_artistbrowse_artist(sp_artistbrowse *arb);

/**
 * Given an artist browse object, return number of portraits available
 *
 * @param[in]   arb        Artist browse object
 *
 * @return                 Number of portraits for given artist
 */
SP_LIBEXPORT(int) sp_artistbrowse_num_portraits(sp_artistbrowse *arb);

/**
 * Return image ID representing a portrait of the artist
 *
 * @param[in] arb             Artist object
 * @param[in] index           The index of the portrait. Should be in the interval [0, sp_artistbrowse_num_portraits() - 1]
 *
 * @return                    ID byte sequence that can be passed to sp_image_create()
 *
 * @see sp_image_create
 */
SP_LIBEXPORT(const byte *) sp_artistbrowse_portrait(sp_artistbrowse *arb, int index);

/**
 * Given an artist browse object, return number of tracks
 *
 * @param[in] arb             Artist browse object
 *
 * @return                    Number of tracks for given artist
 */
SP_LIBEXPORT(int) sp_artistbrowse_num_tracks(sp_artistbrowse *arb);

/**
 * Given an artist browse object, return one of its tracks
 *
 * @param[in] arb             Album browse object
 * @param[in] index           The index for the track. Should be in the interval [0, sp_artistbrowse_num_tracks() - 1]
 *
 * @return                    A track object, or NULL if the index is out of range.
 *
 * @see track
 */
SP_LIBEXPORT(sp_track *) sp_artistbrowse_track(sp_artistbrowse *arb, int index);


/**
 * Given an artist browse object, return number of tophit tracks
 * This is a set of tracks for the artist with highest popularity
 *
 * @param[in] arb             Artist browse object
 *
 * @return                    Number of tophit tracks for given artist
 */
SP_LIBEXPORT(int) sp_artistbrowse_num_tophit_tracks(sp_artistbrowse *arb);

/**
 * Given an artist browse object, return one of its tophit tracks
 * This is a set of tracks for the artist with highest popularity
 *
 * @param[in] arb             Album browse object
 * @param[in] index           The index for the track. Should be in the interval [0, sp_artistbrowse_num_tophit_tracks() - 1]
 *
 * @return                    A track object, or NULL if the index is out of range.
 *
 * @see track
 */
SP_LIBEXPORT(sp_track *) sp_artistbrowse_tophit_track(sp_artistbrowse *arb, int index);

/**
 * Given an artist browse object, return number of albums
 *
 * @param[in] arb             Artist browse object
 *
 * @return                    Number of albums for given artist
 */
SP_LIBEXPORT(int) sp_artistbrowse_num_albums(sp_artistbrowse *arb);

/**
 * Given an artist browse object, return one of its albums
 *
 * @param[in] arb             Album browse object
 * @param[in] index           The index for the album. Should be in the interval [0, sp_artistbrowse_num_albums() - 1]
 *
 * @return                    A album object, or NULL if the index is out of range.
 *
 * @see album
 */
SP_LIBEXPORT(sp_album *) sp_artistbrowse_album(sp_artistbrowse *arb, int index);

/**
 * Given an artist browse object, return number of similar artists
 *
 * @param[in] arb             Artist browse object
 *
 * @return                    Number of similar artists for given artist
 */
SP_LIBEXPORT(int) sp_artistbrowse_num_similar_artists(sp_artistbrowse *arb);

/**
 * Given an artist browse object, return a similar artist by index
 *
 * @param[in] arb             Album browse object
 * @param[in] index           The index for the artist. Should be in the interval [0, sp_artistbrowse_num_similar_artists() - 1]
 *
 * @return                    A pointer to an artist object.
 *
 * @see artist
 */
SP_LIBEXPORT(sp_artist *) sp_artistbrowse_similar_artist(sp_artistbrowse *arb, int index);

/**
 * Given an artist browse object, return the artists biography
 *
 * @note This function must be called from the same thread that did sp_session_create()
 * @param[in] arb             Artist browse object
 *
 * @return                    Biography string in UTF-8 format.
 *                            Returned string is valid as long as the album object stays allocated
 *                            and no longer than the next call to sp_session_process_events()
 */
SP_LIBEXPORT(const char *) sp_artistbrowse_biography(sp_artistbrowse *arb);

/**
 * Return the time (in ms) that was spent waiting for the Spotify backend to serve the request
 *
 * @param[in] arb         Artist browse object
 *
 * @return                -1 if the request was served from the local cache
 *                        If the result is not yet loaded the return value is undefined
 */
SP_LIBEXPORT(int) sp_artistbrowse_backend_request_duration(sp_artistbrowse *arb);


/**
 * Increase the reference count of an artist browse result
 *
 * @param[in]   arb       The artist browse result object
 * @return                One of the following errors, from ::sp_error
 *                        SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_artistbrowse_add_ref(sp_artistbrowse *arb);

/**
 * Decrease the reference count of an artist browse result
 *
 * @param[in]   arb       The artist browse result object
 * @return                One of the following errors, from ::sp_error
 *                        SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_artistbrowse_release(sp_artistbrowse *arb);

/** @} */



/**
 * @defgroup image Image handling
 * @{
 */

/**
 * Image format
 */
typedef enum {
  SP_IMAGE_FORMAT_UNKNOWN = -1, ///< Unknown image format
  SP_IMAGE_FORMAT_JPEG   = 0,   ///< JPEG image
} sp_imageformat;

/**
 * The type of a callback used to notify the application that an image
 * is done loading.
 */
typedef void SP_CALLCONV image_loaded_cb(sp_image *image, void *userdata);

/**
 * Create an image object
 *
 * @param[in]  session    Session
 * @param[in]  image_id   Spotify image ID
 *
 * @return                Pointer to an image object. To free the object, use
 *                        sp_image_release()
 *
 * @see sp_album_cover
 * @see sp_artistbrowse_portrait
 */
SP_LIBEXPORT(sp_image *) sp_image_create(sp_session *session, const byte image_id[20]);

/**
 * Create an image object from a link
 *
 * @param[in]  session    Session
 * @param[in]  l          Spotify link object. This must be of SP_LINKTYPE_IMAGE type
 *
 * @return                Pointer to an image object. To free the object, use
 *                        sp_image_release()
 *
 * @see sp_image_create
 */
SP_LIBEXPORT(sp_image *) sp_image_create_from_link(sp_session *session, sp_link *l);

/**
 * Add a callback that will be invoked when the image is loaded
 *
 * If an image is loaded, and loading fails, the image will behave like an
 * empty image.
 *
 * @param[in]  image      Image object
 * @param[in]  callback   Callback that will be called when image has been
 *                        fetched.
 * @param[in]  userdata   Opaque pointer passed to \p callback
 *
 */
SP_LIBEXPORT(sp_error) sp_image_add_load_callback(sp_image *image, image_loaded_cb *callback, void *userdata);

/**
 * Remove an image load callback previously added with sp_image_add_load_callback()
 *
 * @param[in]  image      Image object
 * @param[in]  callback   Callback that will not be called when image has been
 *                        fetched.
 * @param[in]  userdata   Opaque pointer passed to \p callback
 * @return                One of the following errors, from ::sp_error
 *                        SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_image_remove_load_callback(sp_image *image, image_loaded_cb *callback, void *userdata);

/**
 * Check if an image is loaded. Before the image is loaded, the rest of the
 * methods will behave as if the image is empty.
 *
 * @param[in]  image      Image object
 *
 * @return                True if image is loaded, false otherwise
 */
SP_LIBEXPORT(bool) sp_image_is_loaded(sp_image *image);

/**
* Check if image retrieval returned an error code.
*
* @param[in]   image      Image object
*
* @return                 One of the following errors, from ::sp_error
*                         SP_ERROR_OK
*                         SP_ERROR_IS_LOADING
*                         SP_ERROR_OTHER_PERMANENT
*                         SP_ERROR_OTHER_TRANSIENT
*/
SP_LIBEXPORT(sp_error) sp_image_error(sp_image *image);

/**
 * Get image format
 *
 * @param[in]  image      Image object
 *
 * @return                Image format as described by sp_imageformat
 */
SP_LIBEXPORT(sp_imageformat) sp_image_format(sp_image *image);

/**
* Get image data
*
* @param[in]  image      Image object
* @param[out] data_size  Size of raw image data
*
* @return                Pointer to raw image data
*/

SP_LIBEXPORT(const void *) sp_image_data(sp_image *image, size_t *data_size);

/**
 * Get image ID
 *
 * @param[in]  image      Image object
 *
 * @return                Image ID
 */
SP_LIBEXPORT(const byte *) sp_image_image_id(sp_image *image);


/**
 * Increase the reference count of an image
 *
 * @param[in]   image     The image object
 * @return                One of the following errors, from ::sp_error
 *                        SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_image_add_ref(sp_image *image);

/**
 * Decrease the reference count of an image
 *
 * @param[in]   image     The image object
 * @return                One of the following errors, from ::sp_error
 *                        SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_image_release(sp_image *image);

/** @} */



/**
 * @defgroup search Search subsystem
 * @{
 */

/**
 * The type of a callback used in sp_search_create()
 *
 * When this callback is called, the sp_track_is_loaded(), sp_album_is_loaded(),
 * and sp_artist_is_loaded() functions will return non-zero for the objects
 * contained in the search result.
 *
 * @param[in]   result          The same pointer returned by sp_search_create()
 * @param[in]   userdata        The opaque pointer given to sp_search_create()
 */
typedef void SP_CALLCONV search_complete_cb(sp_search *result, void *userdata);

/**
 * Create a search object from the given query
 *
 * @param[in]  session    Session
 * @param[in]  query      Query search string, e.g. 'The Rolling Stones' or 'album:"The Black Album"'
 * @param[in]  track_offset     The offset among the tracks of the result
 * @param[in]  track_count      The number of tracks to ask for
 * @param[in]  album_offset     The offset among the albums of the result
 * @param[in]  album_count      The number of albums to ask for
 * @param[in]  artist_offset    The offset among the artists of the result
 * @param[in]  artist_count     The number of artists to ask for
 * @param[in]  playlist_offset  The offset among the playlists of the result
 * @param[in]  playlist_count   The number of playlists to ask for
 * @param[in]  search_type      Type of search, can be used for suggest searches
 * @param[in]  callback   Callback that will be called once the search operation is complete. Pass NULL if you are not interested in this event.
 * @param[in]  userdata   Opaque pointer passed to \p callback
 *
 * @return                Pointer to a search object. To free the object, use sp_search_release()
 */
SP_LIBEXPORT(sp_search *) sp_search_create(sp_session *session, const char *query, int track_offset, int track_count, int album_offset, int album_count, int artist_offset, int artist_count, int playlist_offset, int playlist_count, sp_search_type search_type, search_complete_cb *callback, void *userdata);

/**
 * Get load status for the specified search. Before it is loaded, it will behave as an empty search result.
 *
 * @param[in]  search   Search object
 *
 * @return              True if search is loaded, otherwise false
 */
SP_LIBEXPORT(bool) sp_search_is_loaded(sp_search *search);

/**
* Check if search returned an error code.
*
* @param[in]   search     Search object
*
* @return                 One of the following errors, from ::sp_error
*                         SP_ERROR_OK
*                         SP_ERROR_IS_LOADING
*                         SP_ERROR_OTHER_PERMANENT
*                         SP_ERROR_OTHER_TRANSIENT
*/
SP_LIBEXPORT(sp_error) sp_search_error(sp_search *search);

/**
 * Get the number of tracks for the specified search
 *
 * @param[in]  search   Search object
 *
 * @return              The number of tracks for the specified search
 */
SP_LIBEXPORT(int) sp_search_num_tracks(sp_search *search);

/**
 * Return the track at the given index in the given search object
 *
 * @param[in]  search     Search object
 * @param[in]  index      Index of the wanted track. Should be in the interval [0, sp_search_num_tracks() - 1]
 *
 * @return                The track at the given index in the given search object
 */
SP_LIBEXPORT(sp_track *) sp_search_track(sp_search *search, int index);

/**
 * Get the number of albums for the specified search
 *
 * @param[in]  search   Search object
 *
 * @return              The number of albums for the specified search
 */
SP_LIBEXPORT(int) sp_search_num_albums(sp_search *search);

/**
 * Return the album at the given index in the given search object
 *
 * @param[in]  search     Search object
 * @param[in]  index      Index of the wanted album. Should be in the interval [0, sp_search_num_albums() - 1]
 *
 * @return                The album at the given index in the given search object
 */
SP_LIBEXPORT(sp_album *) sp_search_album(sp_search *search, int index);

/**
 * Get the number of playlists for the specified search
 *
 * @param[in]  search   Search object
 *
 * @return              The number of playlists for the specified search
 */
SP_LIBEXPORT(int) sp_search_num_playlists(sp_search *search);

/**
 * Load the playlist at the given index in the given search object
 *
 * @param[in]  search     Search object
 * @param[in]  index      Index of the wanted playlist. Should be in the interval [0, sp_search_num_playlists() - 1]
 *
 * @return                A playlist object. This reference is owned by the caller and should be released with sp_playlist_release()
 */
SP_LIBEXPORT(sp_playlist *) sp_search_playlist(sp_search *search, int index);

/**
 * Return the playlist at the given index in the given search object
 *
 * @param[in]  search     Search object
 * @param[in]  index      Index of the wanted playlist. Should be in the interval [0, sp_search_num_playlists() - 1]
 *
 * @return                The playlist name at the given index in the given search object
 */
SP_LIBEXPORT(const char *) sp_search_playlist_name(sp_search *search, int index);

/**
 * Return the uri of a playlist at the given index in the given search object
 *
 * @param[in]  search     Search object
 * @param[in]  index      Index of the wanted playlist. Should be in the interval [0, sp_search_num_playlists() - 1]
 *
 * @return                The playlist uri at the given index in the given search object
 */
SP_LIBEXPORT(const char *) sp_search_playlist_uri(sp_search *search, int index);

/**
 * Return the image_uri of a playlist at the given index in the given search object
 *
 * @param[in]  search     Search object
 * @param[in]  index      Index of the wanted playlist. Should be in the interval [0, sp_search_num_playlists() - 1]
 *
 * @return                The playlist image_uri at the given index in the given search object
 */
SP_LIBEXPORT(const char *) sp_search_playlist_image_uri(sp_search *search, int index);

/**
 * Get the number of artists for the specified search
 *
 * @param[in]  search   Search object
 *
 * @return              The number of artists for the specified search
 */
SP_LIBEXPORT(int) sp_search_num_artists(sp_search *search);

/**
 * Return the artist at the given index in the given search object
 *
 * @param[in]  search     Search object
 * @param[in]  index      Index of the wanted artist. Should be in the interval [0, sp_search_num_artists() - 1]
 *
 * @return                The artist at the given index in the given search object
 */
SP_LIBEXPORT(sp_artist *) sp_search_artist(sp_search *search, int index);

/**
 * Return the search query for the given search object
 *
 * @param[in]  search     Search object
 *
 * @return                The search query for the given search object
 */
SP_LIBEXPORT(const char *) sp_search_query(sp_search *search);

/**
 * Return the "Did you mean" query for the given search object
 *
 * @param[in]  search     Search object
 *
 * @return                The "Did you mean" query for the given search object, or the empty string if no such info is available
 */
SP_LIBEXPORT(const char *) sp_search_did_you_mean(sp_search *search);

/**
 * Return the total number of tracks for the search query - regardless of the interval requested at creation.
 * If this value is larger than the interval specified at creation of the search object, more search results are available.
 * To fetch these, create a new search object with a new interval.
 *
 * @param[in]  search     Search object
 *
 * @return                The total number of tracks matching the original query
 */
SP_LIBEXPORT(int) sp_search_total_tracks(sp_search *search);

/**
 * Return the total number of albums for the search query - regardless of the interval requested at creation.
 * If this value is larger than the interval specified at creation of the search object, more search results are available.
 * To fetch these, create a new search object with a new interval.
 *
 * @param[in]  search     Search object
 *
 * @return                The total number of albums matching the original query
 */
SP_LIBEXPORT(int) sp_search_total_albums(sp_search *search);

/**
 * Return the total number of artists for the search query - regardless of the interval requested at creation.
 * If this value is larger than the interval specified at creation of the search object, more search results are available.
 * To fetch these, create a new search object with a new interval.
 *
 * @param[in]  search     Search object
 *
 * @return                The total number of artists matching the original query
 */
SP_LIBEXPORT(int) sp_search_total_artists(sp_search *search);

/**
 * Return the total number of playlists for the search query - regardless of the interval requested at creation.
 * If this value is larger than the interval specified at creation of the search object, more search results are available.
 * To fetch these, create a new search object with a new interval.
 *
 * @param[in]  search     Search object
 *
 * @return                The total number of playlists matching the original query
 */
SP_LIBEXPORT(int) sp_search_total_playlists(sp_search *search);

/**
 * Increase the reference count of a search result
 *
 * @param[in]   search    The search result object
 * @return                One of the following errors, from ::sp_error
 *                        SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_search_add_ref(sp_search *search);

/**
 * Decrease the reference count of a search result
 *
 * @param[in]   search    The search result object
 * @return                One of the following errors, from ::sp_error
 *                        SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_search_release(sp_search *search);

/** @} */




/**
 * @defgroup playlist Playlist subsystem
 *
 * The playlist subsystem handles playlists and playlist containers (list of playlists).
 *
 * The playlist container functions are always valid, but your playlists are not
 * guaranteed to be loaded until the sp_session_callbacks#logged_in callback has
 * been issued.
 *
 * @{
 */

/**
 * Playlist callbacks
 *
 * Used to get notifications when playlists are updated.
 * If some callbacks should not be of interest, set them to NULL.
 */
typedef struct sp_playlist_callbacks {

  /**
   * Called when one or more tracks have been added to a playlist
   *
   * @param[in]  pl         Playlist object
   * @param[in]  tracks     Array of pointers to track objects
   * @param[in]  num_tracks Number of entries in \p tracks
   * @param[in]  position   Position in the playlist for the first track.
   * @param[in]  userdata   Userdata passed to sp_playlist_add_callbacks()
   */
  void (SP_CALLCONV *tracks_added)(sp_playlist *pl, sp_track * const *tracks, int num_tracks, int position, void *userdata);

  /**
   * Called when one or more tracks have been removed from a playlist
   *
   * @param[in]  pl         Playlist object
   * @param[in]  tracks     Array of positions representing the tracks that were removed
   * @param[in]  num_tracks Number of entries in \p tracks
   * @param[in]  userdata   Userdata passed to sp_playlist_add_callbacks()
   */
  void (SP_CALLCONV *tracks_removed)(sp_playlist *pl, const int *tracks, int num_tracks, void *userdata);

  /**
   * Called when one or more tracks have been moved within a playlist
   *
   * @param[in]  pl         Playlist object
   * @param[in]  tracks     Array of positions representing the tracks that were moved
   * @param[in]  num_tracks Number of entries in \p tracks
   * @param[in]  position   New position in the playlist for the first track.
   * @param[in]  userdata   Userdata passed to sp_playlist_add_callbacks()
   */
  void (SP_CALLCONV *tracks_moved)(sp_playlist *pl, const int *tracks, int num_tracks, int new_position, void *userdata);

  /**
   * Called when a playlist has been renamed. sp_playlist_name() can be used to find out the new name
   *
   * @param[in]  pl         Playlist object
   * @param[in]  userdata   Userdata passed to sp_playlist_add_callbacks()
   */
  void (SP_CALLCONV *playlist_renamed)(sp_playlist *pl, void *userdata);

  /**
   * Called when state changed for a playlist.
   *
   * There are three states that trigger this callback:
   * - Collaboration for this playlist has been turned on or off
   * - The playlist started having pending changes, or all pending changes have now been committed
   * - The playlist started loading, or finished loading
   *
   * @param[in]  pl         Playlist object
   * @param[in]  userdata   Userdata passed to sp_playlist_add_callbacks()
   * @sa sp_playlist_is_collaborative
   * @sa sp_playlist_has_pending_changes
   * @sa sp_playlist_is_loaded
   */
  void (SP_CALLCONV *playlist_state_changed)(sp_playlist *pl, void *userdata);

  /**
   * Called when a playlist is updating or is done updating
   *
   * This is called before and after a series of changes are applied to the
   * playlist. It allows e.g. the user interface to defer updating until the
   * entire operation is complete.
   *
   * @param[in]  pl         Playlist object
   * @param[in]  done       True iff the update is completed
   * @param[in]  userdata   Userdata passed to sp_playlist_add_callbacks()
   */
  void (SP_CALLCONV *playlist_update_in_progress)(sp_playlist *pl, bool done, void *userdata);

  /**
   * Called when metadata for one or more tracks in a playlist has been updated.
   *
   * @param[in]  pl         Playlist object
   * @param[in]  userdata   Userdata passed to sp_playlist_add_callbacks()
   */
  void (SP_CALLCONV *playlist_metadata_updated)(sp_playlist *pl, void *userdata);

  /**
   * Called when create time and/or creator for a playlist entry changes
   *
   * @param[in]  pl         Playlist object
   * @param[in]  position   Position in playlist
   * @param[in]  user       User object
   * @param[in]  time       When entry was created, seconds since the unix epoch.
   * @param[in]  userdata   Userdata passed to sp_playlist_add_callbacks()
   */
  void (SP_CALLCONV *track_created_changed)(sp_playlist *pl, int position, sp_user *user, int when, void *userdata);

  /**
   * Called when seen attribute for a playlist entry changes.
   *
   * @param[in]  pl         Playlist object
   * @param[in]  position   Position in playlist
   * @param[in]  seen       Set if entry it marked as seen
   * @param[in]  userdata   Userdata passed to sp_playlist_add_callbacks()
   */
  void (SP_CALLCONV *track_seen_changed)(sp_playlist *pl, int position, bool seen, void *userdata);

  /**
   * Called when playlist description has changed
   *
   * @param[in]  pl         Playlist object
   * @param[in]  desc       New description
   * @param[in]  userdata   Userdata passed to sp_playlist_add_callbacks()
   */
  void (SP_CALLCONV *description_changed)(sp_playlist *pl, const char *desc, void *userdata);


  /**
   * Called when playlist image has changed
   *
   * @param[in]  pl         Playlist object
   * @param[in]  image      New image
   * @param[in]  userdata   Userdata passed to sp_playlist_add_callbacks()
   */
  void (SP_CALLCONV *image_changed)(sp_playlist *pl, const byte *image, void *userdata);


  /**
   * Called when message attribute for a playlist entry changes.
   *
   * @param[in]  pl         Playlist object
   * @param[in]  position   Position in playlist
   * @param[in]  message    UTF-8 encoded message
   * @param[in]  userdata   Userdata passed to sp_playlist_add_callbacks()
   */
  void (SP_CALLCONV *track_message_changed)(sp_playlist *pl, int position, const char *message, void *userdata);


  /**
   * Called when playlist subscribers changes (count or list of names)
   *
   * @param[in]  pl         Playlist object
   * @param[in]  userdata   Userdata passed to sp_playlist_add_callbacks()
   */
  void (SP_CALLCONV *subscribers_changed)(sp_playlist *pl, void *userdata);

} sp_playlist_callbacks;


/**
 * Get load status for the specified playlist. If it's false, you have to wait until
 * playlist_state_changed happens, and check again if is_loaded has changed
 *
 * @param[in]  playlist   Playlist object
 *
 * @return                True if playlist is loaded, otherwise false
 */
SP_LIBEXPORT(bool) sp_playlist_is_loaded(sp_playlist *playlist);

/**
 * Register interest in the given playlist
 *
 * Here is a snippet from \c jukebox.c:
 * @dontinclude jukebox.c
 * @skipline sp_playlist_add_callbacks
 *
 * @param[in]  playlist   Playlist object
 * @param[in]  callbacks  Callbacks, see #sp_playlist_callbacks
 * @param[in]  userdata   Userdata to be passed to callbacks
 * @sa sp_playlist_remove_callbacks
 *
 */
SP_LIBEXPORT(sp_error) sp_playlist_add_callbacks(sp_playlist *playlist, sp_playlist_callbacks *callbacks, void *userdata);

/**
 * Unregister interest in the given playlist
 *
 * The combination of (\p callbacks, \p userdata) is used to find the entry to be removed
 *
 * Here is a snippet from \c jukebox.c:
 * @dontinclude jukebox.c
 * @skipline sp_playlist_remove_callbacks
 *
 * @param[in]  playlist   Playlist object
 * @param[in]  callbacks  Callbacks, see #sp_playlist_callbacks
 * @param[in]  userdata   Userdata to be passed to callbacks
 * @sa sp_playlist_add_callbacks
 * @return                One of the following errors, from ::sp_error
 *                        SP_ERROR_OK
 *
 */
SP_LIBEXPORT(sp_error) sp_playlist_remove_callbacks(sp_playlist *playlist, sp_playlist_callbacks *callbacks, void *userdata);

/**
 * Return number of tracks in the given playlist
 *
 * @param[in]  playlist   Playlist object
 *
 * @return                The number of tracks in the playlist
 */
SP_LIBEXPORT(int) sp_playlist_num_tracks(sp_playlist *playlist);

/**
 * Return the track at the given index in a playlist
 *
 * @param[in]  playlist   Playlist object
 * @param[in]  index      Index into playlist container. Should be in the interval [0, sp_playlist_num_tracks() - 1]
 *
 * @return                The track at the given index
 */
SP_LIBEXPORT(sp_track *) sp_playlist_track(sp_playlist *playlist, int index);

/**
 * Return when the given index was added to the playlist
 *
 * @param[in]  playlist   Playlist object
 * @param[in]  index      Index into playlist container. Should be in the interval [0, sp_playlist_num_tracks() - 1]
 *
 * @return                Time, Seconds since unix epoch.
 */
SP_LIBEXPORT(int) sp_playlist_track_create_time(sp_playlist *playlist, int index);

/**
 * Return user that added the given index in the playlist
 *
 * @param[in]  playlist   Playlist object
 * @param[in]  index      Index into playlist container. Should be in the interval [0, sp_playlist_num_tracks() - 1]
 *
 * @return                User object
 */
SP_LIBEXPORT(sp_user *) sp_playlist_track_creator(sp_playlist *playlist, int index);

/**
 * Return if a playlist entry is marked as seen or not
 *
 * @param[in]  playlist   Playlist object
 * @param[in]  index      Index into playlist container. Should be in the interval [0, sp_playlist_num_tracks() - 1]
 *
 * @return                Seen state
 */
SP_LIBEXPORT(bool) sp_playlist_track_seen(sp_playlist *playlist, int index);

/**
 * Set seen status of a playlist entry
 *
 * @param[in]  playlist   Playlist object
 * @param[in]  index      Index into playlist container. Should be in the interval [0, sp_playlist_num_tracks() - 1]
 * @param[in]  seen       Seen status to be set
 *
 * @return     error     One of the following errors, from ::sp_error
 *                       SP_ERROR_OK
 *                       SP_ERROR_INDEX_OUT_OF_RANGE
 */
SP_LIBEXPORT(sp_error) sp_playlist_track_set_seen(sp_playlist *playlist, int index, bool seen);

/**
 * Return a message attached to a playlist item. Typically used on inbox.
 *
 * @param[in]  playlist   Playlist object
 * @param[in]  index      Index into playlist container. Should be in the interval [0, sp_playlist_num_tracks() - 1]
 *
 * @return                UTF-8 encoded message, or NULL if no message is present
 */
SP_LIBEXPORT(const char *) sp_playlist_track_message(sp_playlist *playlist, int index);

/**
 * Return name of given playlist
 *
 * @param[in]  playlist   Playlist object
 *
 * @return                The name of the given playlist
 */
SP_LIBEXPORT(const char *) sp_playlist_name(sp_playlist *playlist);

/**
 * Rename the given playlist
 * The name must not consist of only spaces and it must be shorter than 256 characters.
 *
 * @param[in]  playlist   Playlist object
 * @param[in]  new_name   New name for playlist
 *
 * @return                One of the following errors, from ::sp_error
 *                        SP_ERROR_OK
 *                        SP_ERROR_INVALID_INDATA
 *                        SP_ERROR_PERMISSION_DENIED
 */
SP_LIBEXPORT(sp_error) sp_playlist_rename(sp_playlist *playlist, const char *new_name);

/**
 * Return a pointer to the user for the given playlist
 *
 * @param[in]  playlist   Playlist object
 *
 * @return                User object
 */
SP_LIBEXPORT(sp_user *) sp_playlist_owner(sp_playlist *playlist);

/**
 * Return collaborative status for a playlist.
 *
 * A playlist in collaborative state can be modifed by all users, not only the user owning the list
 *
 * @param[in]  playlist   Playlist object
 *
 * @return                true if playlist is collaborative, otherwise false
 */
SP_LIBEXPORT(bool) sp_playlist_is_collaborative(sp_playlist *playlist);

/**
 * Set collaborative status for a playlist.
 *
 * A playlist in collaborative state can be modified by all users, not only the user owning the list
 *
 * @param[in]  playlist       Playlist object
 * @param[in]  collaborative  True or false
 * @return                    One of the following errors, from ::sp_error
 *                            SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_playlist_set_collaborative(sp_playlist *playlist, bool collaborative);

/**
 * Set autolinking state for a playlist.
 *
 * If a playlist is autolinked, unplayable tracks will be made playable
 * by linking them to other Spotify tracks, where possible.
 *
 * @param[in]  playlist       Playlist object
 * @param[in]  link           True or false
 * @return                    One of the following errors, from ::sp_error
 *                            SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_playlist_set_autolink_tracks(sp_playlist *playlist, bool link);


/**
 * Get description for a playlist
 *
 * @param[in]  playlist       Playlist object
 *
 * @return                    Playlist description or NULL if unset
 *
 */
SP_LIBEXPORT(const char *) sp_playlist_get_description(sp_playlist *playlist);


/**
 * Get description for a playlist
 *
 * @param[in]  playlist       Playlist object
 * @param[out] image          20 byte image id

 * @return                    TRUE if playlist has an image, FALSE if not
 *
 */
SP_LIBEXPORT(bool) sp_playlist_get_image(sp_playlist *playlist, byte image[20]);


/**
 * Check if a playlist has pending changes
 *
 * Pending changes are local changes that have not yet been acknowledged by the server.
 *
 * @param[in]  playlist       Playlist object
 *
 * @return                    A flag representing if there are pending changes or not
 */
SP_LIBEXPORT(bool) sp_playlist_has_pending_changes(sp_playlist *playlist);

/**
 * Add tracks to a playlist
 *
 * @param[in]  playlist       Playlist object
 * @param[in]  tracks         Array of pointer to tracks.
 * @param[in]  num_tracks     Length of \p tracks array
 * @param[in]  position       Start position in playlist where to insert the tracks
 * @param[in]  session        Your session object
 *
 * @return                One of the following errors, from ::sp_error
 *                        SP_ERROR_OK
 *                        SP_ERROR_INVALID_INDATA - position is > current playlist length
 *                        SP_ERROR_PERMISSION_DENIED
 */
SP_LIBEXPORT(sp_error) sp_playlist_add_tracks(sp_playlist *playlist, sp_track *const*tracks, int num_tracks, int position, sp_session *session);

/**
 * Remove tracks from a playlist
 *
 * @param[in]  playlist       Playlist object
 * @param[in]  tracks         Array of pointer to track indices.
 *                            A certain track index should be present at most once, e.g. [0, 1, 2] is valid indata,
 *                            whereas [0, 1, 1] is invalid.
 * @param[in]  num_tracks     Length of \p tracks array
 *
 * @return                    One of the following errors, from ::sp_error
 *                            SP_ERROR_OK
 *                            SP_ERROR_PERMISSION_DENIED
 */
SP_LIBEXPORT(sp_error) sp_playlist_remove_tracks(sp_playlist *playlist, const int *tracks, int num_tracks);

/**
 * Move tracks in playlist
 *
 * @param[in]  playlist       Playlist object
 * @param[in]  tracks         Array of pointer to track indices to be moved.
 *                            A certain track index should be present at most once, e.g. [0, 1, 2] is valid indata,
 *                            whereas [0, 1, 1] is invalid.
 * @param[in]  num_tracks     Length of \p tracks array
 * @param[in]  new_position   New position for tracks
 *
 * @return                    One of the following errors, from ::sp_error
 *                            SP_ERROR_OK
 *                            SP_ERROR_INVALID_INDATA - position is > current playlist length
 *                            SP_ERROR_PERMISSION_DENIED
 */
SP_LIBEXPORT(sp_error) sp_playlist_reorder_tracks(sp_playlist *playlist, const int *tracks, int num_tracks, int new_position);


/**
 * Return number of subscribers for a given playlist
 *
 * @param[in]  playlist       Playlist object
 *
 * @return     Number of subscribers
 *
 */
SP_LIBEXPORT(unsigned int) sp_playlist_num_subscribers(sp_playlist *playlist);

/**
 * Return subscribers for a playlist
 *
 * @param[in]  playlist       Playlist object
 *
 * @return     sp_subscribers struct with array of canonical usernames.
 *             This object should be free'd using sp_playlist_subscribers_free()
 *
 * @note       The count returned for this function may be less than those
 *             returned by sp_playlist_num_subscribers(). Spotify does not
 *             track each user subscribed to a playlist for playlist with
 *             many (>500) subscribers.
 */
SP_LIBEXPORT(sp_subscribers *) sp_playlist_subscribers(sp_playlist *playlist);

/**
 * Free object returned from sp_playlist_subscribers()
 *
 * @param[in] subscribers   Subscribers object
 * @return                    One of the following errors, from ::sp_error
 *                            SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_playlist_subscribers_free(sp_subscribers *subscribers);

/**
 * Ask library to update the subscription count for a playlist
 *
 * When the subscription info has been fetched from the Spotify backend
 * the playlist subscribers_changed() callback will be invoked.
 * In that callback use sp_playlist_num_subscribers() and/or
 * sp_playlist_subscribers() to get information about the subscribers.
 * You can call those two functions anytime you want but the information
 * might not be up to date in such cases
 *
 * @param[in]  session        Session object
 * @param[in]  playlist       Playlist object
 * @return                    One of the following errors, from ::sp_error
 *                            SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_playlist_update_subscribers(sp_session *session, sp_playlist *playlist);

/**
 * Return whether a playlist is loaded in RAM (as opposed to only
 * stored on disk)
 *
 * @param[in]  session        Session object
 * @param[in]  playlist       Playlist object
 *
 * @return True iff playlist is in RAM, False otherwise
 *
 * @note       When a playlist is no longer in RAM it will appear empty.
 *             However, libspotify will retain information about the
 *             list metadata  (owner, title, picture, etc) in RAM.
 *             There is one caveat tough: If libspotify has never seen the
 *             playlist before this metadata will also be unset.
 *             In order for libspotify to get the metadata the playlist
 *             needs to be loaded at least once.
 *             In order words, if libspotify starts with an empty playlist
 *             cache and the application has set 'initially_unload_playlists'
 *             config parameter to True all playlists will be empty.
 *             It will not be possible to generate URI's to the playlists
 *             nor extract playlist title until the application calls
 *             sp_playlist_set_in_ram(..., true). So an application
 *             that needs to stay within a low memory profile would need to
 *             cycle thru all new playlists in order to extract metadata.
 *
 *             The easiest way to detect this case is when
 *             sp_playlist_is_in_ram() returns false and
 *             sp_link_create_from_playlist() returns NULL
 */
SP_LIBEXPORT(bool) sp_playlist_is_in_ram(sp_session *session, sp_playlist *playlist);

/**
 * Return whether a playlist is loaded in RAM (as opposed to only
 * stored on disk)
 *
 * @param[in]  session        Session object
 * @param[in]  playlist       Playlist object
 * @param[in]  in_ram         Controls whether or not to keep the list in RAM
 * @return                    One of the following errors, from ::sp_error
 *                            SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_playlist_set_in_ram(sp_session *session, sp_playlist *playlist, bool in_ram);

/**
 * Load an already existing playlist without adding it to a playlistcontainer.
 *
 * @param[in]  session        Session object
 * @param[in]  link           Link object referring to a playlist
 *
 * @return     A playlist. The reference is owned by the caller and should be released with sp_playlist_release()
 *
 */
SP_LIBEXPORT(sp_playlist *) sp_playlist_create(sp_session *session, sp_link *link);

/**
 * Mark a playlist to be synchronized for offline playback.
 * The playlist must be in the users playlistcontainer
 *
 * @param[in]  session        Session object
 * @param[in]  playlist       Playlist object
 * @param[in]  offline        True iff playlist should be offline, false otherwise
 * @return                    One of the following errors, from ::sp_error
 *                            SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_playlist_set_offline_mode(sp_session *session, sp_playlist *playlist, bool offline);

/**
 * Get offline status for a playlist
 *
 * @param[in]  session        Session object
 * @param[in]  playlist       Playlist object
 *
 * @return sp_playlist_offline_status
 *
 * @see When in SP_PLAYLIST_OFFLINE_STATUS_DOWNLOADING mode the
 *      sp_playlist_get_offline_download_completed() method can be used to query
 *      progress of the download
 */
SP_LIBEXPORT(sp_playlist_offline_status) sp_playlist_get_offline_status(sp_session *session, sp_playlist *playlist);

/**
 * Get download progress for an offline playlist
 *
 * @param[in]  session        Session object
 * @param[in]  playlist       Playlist object
 *
 * @return Value from 0 - 100 that indicates amount of playlist that is downloaded
 * or 0 if the playlist is not in the SP_PLAYLIST_OFFLINE_STATUS_DOWNLOADING mode.
 *
 * @see sp_playlist_offline_status()
 */
SP_LIBEXPORT(int) sp_playlist_get_offline_download_completed(sp_session *session, sp_playlist *playlist);

/**
 * Increase the reference count of a playlist
 *
 * @param[in]   playlist       The playlist object
 * @return                     One of the following errors, from ::sp_error
 *                             SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_playlist_add_ref(sp_playlist *playlist);

/**
 * Decrease the reference count of a playlist
 *
 * @param[in]   playlist       The playlist object
 * @return                     One of the following errors, from ::sp_error
 *                             SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_playlist_release(sp_playlist *playlist);


/**
 * Playlist container callbacks.
 * If some callbacks should not be of interest, set them to NULL.
 *
 * @see sp_playlistcontainer_add_callbacks
 * @see sp_playlistcontainer_remove_callbacks
 */
typedef struct sp_playlistcontainer_callbacks {
  /**
   * Called when a new playlist has been added to the playlist container.
   *
   * @param[in]  pc         Playlist container
   * @param[in]  playlist   Playlist object.
   * @param[in]  position   Position in list
   * @param[in]  userdata   Userdata as set in sp_playlistcontainer_add_callbacks()
   */
  void (SP_CALLCONV *playlist_added)(sp_playlistcontainer *pc, sp_playlist *playlist, int position, void *userdata);


  /**
   * Called when a new playlist has been removed from playlist container
   *
   * @param[in]  pc         Playlist container
   * @param[in]  playlist   Playlist object.
   * @param[in]  position   Position in list
   * @param[in]  userdata   Userdata as set in sp_playlistcontainer_add_callbacks()
   */
  void (SP_CALLCONV *playlist_removed)(sp_playlistcontainer *pc, sp_playlist *playlist, int position, void *userdata);


  /**
   * Called when a playlist has been moved in the playlist container
   *
   * @param[in]  pc         Playlist container
   * @param[in]  playlist   Playlist object.
   * @param[in]  position   Previous position in playlist container list
   * @param[in]  new_position   New position in playlist container list
   * @param[in]  userdata   Userdata as set in sp_playlistcontainer_add_callbacks()
   */
  void (SP_CALLCONV *playlist_moved)(sp_playlistcontainer *pc, sp_playlist *playlist, int position, int new_position, void *userdata);

  /**
   * Called when the playlist container is loaded
   *
   * @param[in]  pc         Playlist container
   * @param[in]  userdata   Userdata as set in sp_playlistcontainer_add_callbacks()
   */
  void (SP_CALLCONV *container_loaded)(sp_playlistcontainer *pc, void *userdata);
} sp_playlistcontainer_callbacks;


/**
 * Register interest in changes to a playlist container
 *
 * @param[in]  pc        Playlist container
 * @param[in]  callbacks Callbacks, see sp_playlistcontainer_callbacks
 * @param[in]  userdata  Opaque value passed to callbacks.
 *
 * @note Every sp_playlistcontainer_add_callbacks() needs to be paired with a corresponding
 *       sp_playlistcontainer_remove_callbacks() that is invoked before releasing the
 *       last reference you own for the container. In other words, you must make sure
 *       to have removed all the callbacks before the container gets destroyed.
 *
 * @sa sp_session_playlistcontainer()
 * @sa sp_playlistcontainer_remove_callbacks
 * @return              One of the following errors, from ::sp_error
 *                      SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_playlistcontainer_add_callbacks(sp_playlistcontainer *pc, sp_playlistcontainer_callbacks *callbacks, void *userdata);


/**
 * Unregister interest in changes to a playlist container
 *
 * @param[in]  pc        Playlist container
 * @param[in]  callbacks Callbacks, see sp_playlistcontainer_callbacks
 * @param[in]  userdata  Opaque value passed to callbacks.
 *
 * @sa sp_session_playlistcontainer()
 * @sa sp_playlistcontainer_add_callbacks
 * @return              One of the following errors, from ::sp_error
 *                      SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_playlistcontainer_remove_callbacks(sp_playlistcontainer *pc, sp_playlistcontainer_callbacks *callbacks, void *userdata);

/**
 * Return the number of playlists in the given playlist container
 *
 * @param[in]  pc        Playlist container
 *
 * @return               Number of playlists, -1 if undefined
 *
 * @sa sp_session_playlistcontainer()
 */
SP_LIBEXPORT(int) sp_playlistcontainer_num_playlists(sp_playlistcontainer *pc);

/**
 * Return true if the playlistcontainer is fully loaded
 *
 * @param[in]  pc        Playlist container
 *
 * @return               True if container is loaded
 *
 * @note The container_loaded callback will be invoked when this flips to true
 */
SP_LIBEXPORT(bool) sp_playlistcontainer_is_loaded(sp_playlistcontainer *pc);

/**
 * Return a pointer to the playlist at a specific index
 *
 * @param[in]  pc        Playlist container
 * @param[in]  index     Index in playlist container. Should be in the interval [0, sp_playlistcontainer_num_playlists() - 1]
 *
 * @return               The playlist object
 *
 * @sa sp_session_playlistcontainer()
 */
SP_LIBEXPORT(sp_playlist *) sp_playlistcontainer_playlist(sp_playlistcontainer *pc, int index);

/**
 * Return the type of the playlist at a @a index
 *
 * @param[in]  pc        Playlist container
 * @param[in]  index     Index in playlist container. Should be in the interval [0, sp_playlistcontainer_num_playlists() - 1]
 *
 * @return               Type of the playlist, @see sp_playlist_type
 *
 * @sa sp_session_playlistcontainer()
 */
SP_LIBEXPORT(sp_playlist_type) sp_playlistcontainer_playlist_type(sp_playlistcontainer *pc, int index);

/**
 * Return the folder name at @a index
 *
 * @param[in]  pc           Playlist container
 * @param[in]  index        Index in playlist container. Should be in the interval [0, sp_playlistcontainer_num_playlists() - 1].
 *                          Index should point at a start-folder entry, otherwise the empty string is written to buffer.
 * @param[in]  buffer       Pointer to char[] where to store folder name
 * @param[in]  buffer_size  Size of array
 *
 * @return                  One of the following errors, from ::sp_error
 *                          SP_ERROR_OK
 *                          SP_ERROR_INDEX_OUT_OF_RANGE
 *
 * @sa sp_session_playlistcontainer()
 */
SP_LIBEXPORT(sp_error) sp_playlistcontainer_playlist_folder_name(sp_playlistcontainer *pc, int index, char *buffer, int buffer_size);

/**
 * Return the folder id at @a index
 *
 * @param[in]  pc        Playlist container
 * @param[in]  index     Index in playlist container. Should be in the interval [0, sp_playlistcontainer_num_playlists() - 1]
 *
 * @return               The group ID of the folder. Returns 0 on index out of range, pc being NULL or indexed item not being a folder
 *
 * @sa sp_session_playlistcontainer()
 */
SP_LIBEXPORT(sp_uint64) sp_playlistcontainer_playlist_folder_id(sp_playlistcontainer *pc, int index);

/**
 * Add an empty playlist at the end of the playlist container.
 * The name must not consist of only spaces and it must be shorter than 256 characters.
 *
 * @param[in]  pc        Playlist container
 * @param[in]  name      Name of new playlist
 *
 * @return               Pointer to the new playlist. Can be NULL if the operation fails.
 */
SP_LIBEXPORT(sp_playlist *) sp_playlistcontainer_add_new_playlist(sp_playlistcontainer *pc, const char *name);

/**
 * Add an existing playlist at the end of the given playlist container
 *
 * @param[in]  pc        Playlist container
 * @param[in]  link      Link object pointing to a playlist
 *
 * @return               Pointer to the new playlist. Will be NULL if the playlist already exists.
 */
SP_LIBEXPORT(sp_playlist *) sp_playlistcontainer_add_playlist(sp_playlistcontainer *pc, sp_link *link);

/**
 * Remove playlist at index from the given playlist container
 *
 * @param[in]  pc        Playlist container
 * @param[in]  index     Index of playlist to be removed
 *
 * @return     error     One of the following errors, from ::sp_error
 *                       SP_ERROR_OK
 *                       SP_ERROR_INDEX_OUT_OF_RANGE
 */
SP_LIBEXPORT(sp_error) sp_playlistcontainer_remove_playlist(sp_playlistcontainer *pc, int index);

/**
 * Move a playlist in the playlist container
 *
 * @param[in]  pc           Playlist container
 * @param[in]  index        Index of playlist to be moved
 * @param[in]  new_position New position for the playlist
 * @param[in]  dry_run      Do not execute the move, only check if it possible

 * @return     error        One of the following errors, from ::sp_error
 *                          SP_ERROR_OK
 *                          SP_ERROR_INDEX_OUT_OF_RANGE
 *                          SP_ERROR_INVALID_INDATA - If trying to move a folder into itself
 */
SP_LIBEXPORT(sp_error) sp_playlistcontainer_move_playlist(sp_playlistcontainer *pc, int index, int new_position, bool dry_run);


/**
 * Add a playlist folder
 *
 * @param[in]  pc           Playlist container
 * @param[in]  index        Position of SP_PLAYLIST_TYPE_START_FOLDER entry
 * @param[in]  name         Name of group

 * @return     error        One of the following errors, from ::sp_error
 *                          SP_ERROR_OK
 *                          SP_ERROR_INDEX_OUT_OF_RANGE
 *
 * @note This operation will actually create two playlists. One of
 * type SP_PLAYLIST_TYPE_START_FOLDER and immediately following a
 * SP_PLAYLIST_TYPE_END_FOLDER one.
 *
 * To remove a playlist folder both of these must be deleted or the list
 * will be left in an inconsistant state.
 *
 * There is no way to rename a playlist folder. Instead you need to remove
 * the folder and recreate it again.
 */
SP_LIBEXPORT(sp_error) sp_playlistcontainer_add_folder(sp_playlistcontainer *pc, int index, const char *name);


/**
 * Return a pointer to the user object of the owner.
 *
 * @param[in]  pc   Playlist container.
 * @return          The user object or NULL if unknown or none.
 */
SP_LIBEXPORT(sp_user *) sp_playlistcontainer_owner(sp_playlistcontainer *pc);


/**
 * Increase reference count on playlistconatiner object
 *
 * @param[in]  pc   Playlist container.
 * @return          One of the following errors, from ::sp_error
 *                  SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_playlistcontainer_add_ref(sp_playlistcontainer *pc);

/**
 * Release reference count on playlistconatiner object
 *
 * @param[in]  pc   Playlist container.
 * @return          One of the following errors, from ::sp_error
 *                  SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_playlistcontainer_release(sp_playlistcontainer *pc);

/**
 * Get the number of new tracks in a playlist since the corresponding
 * function sp_playlistcontainer_clear_unseen_tracks() was called. The
 * function always returns the number of new tracks, and fills the
 * \p tracks array with the new tracks, but not more than specified in
 * \p num_tracks. The function will return a negative value on failure.
 *
 * @param[in]  pc         Playlist container.
 * @param[in]  playlist   Playlist object.
 * @param[out] tracks     Array of pointer to new tracks (maybe NULL)
 * @param[in]  num_tracks Size of tracks array
 * @return     Returns the number of unseen tracks
 */
SP_LIBEXPORT(int) sp_playlistcontainer_get_unseen_tracks(sp_playlistcontainer *pc, sp_playlist *playlist, sp_track **tracks, int num_tracks);

/**
 * Clears a playlist from unseen tracks, so that next call to sp_playlistcontainer_get_unseen_tracks() will return 0 until a new track is added to the \p playslist.
 *
 * @param[in]  pc       Playlist container.
 * @param[in]  playlist   Playlist object.
 * @return     Returns 0 on success and -1 on failure.
 */
SP_LIBEXPORT(int) sp_playlistcontainer_clear_unseen_tracks(sp_playlistcontainer *pc, sp_playlist *playlist);

/** @} */


/**
 * @defgroup user User handling
 * @{
 */


/**
 * User relation type
 */
typedef enum sp_relation_type {
  SP_RELATION_TYPE_UNKNOWN = 0,          ///< Not yet known
  SP_RELATION_TYPE_NONE = 1,             ///< No relation
  SP_RELATION_TYPE_UNIDIRECTIONAL = 2,   ///< The currently logged in user is following this uer
  SP_RELATION_TYPE_BIDIRECTIONAL = 3,    ///< Bidirectional friendship established
} sp_relation_type;



/**
 * Get a pointer to a string representing the user's canonical username.
 *
 * @param[in]   user         The Spotify user whose canonical username you would like a string representation of
 *
 * @return                   A string representing the canonical username.
 */
SP_LIBEXPORT(const char *) sp_user_canonical_name(sp_user *user);

/**
 * Get a pointer to a string representing the user's displayable username.
 * If there is no difference between the canonical username and the display name,
 * or if the library does not know about the display name yet, the canonical username will
 * be returned.
 *
 * @param[in]   user         The Spotify user whose displayable username you would like a string representation of
 *
 * @return                   A string
 */
SP_LIBEXPORT(const char *) sp_user_display_name(sp_user *user);

/**
 * Get load status for a user object. Before it is loaded, only the user's canonical username
 * is known.
 *
 * @param[in]   user         Spotify user object
 *
 * @return                   True if user object is loaded, otherwise false
 */
SP_LIBEXPORT(bool) sp_user_is_loaded(sp_user *user);


/**
 * Increase the reference count of an user
 *
 * @param[in]   user       The user object
 * @return                 One of the following errors, from ::sp_error
 *                         SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_user_add_ref(sp_user *user);

/**
 * Decrease the reference count of an user
 *
 * @param[in]   user       The user object
 * @return                 One of the following errors, from ::sp_error
 *                         SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_user_release(sp_user *user);

/** @} */


/**
 * @defgroup toplist Toplist handling
 * @{
 */

/**
 * Toplist types
 */
typedef enum {
  SP_TOPLIST_TYPE_ARTISTS = 0, ///< Top artists
  SP_TOPLIST_TYPE_ALBUMS  = 1, ///< Top albums
  SP_TOPLIST_TYPE_TRACKS  = 2, ///< Top tracks
} sp_toplisttype;


/**
 * Convenience macro to create a toplist region. Toplist regions are ISO 3166-1
 * country codes (in uppercase) encoded in an integer. There are also some reserved
 * codes used to denote non-country regions. See sp_toplistregion
 *
 * Example: SP_TOPLIST_REGION('S', 'E') for Sweden
 */
#define SP_TOPLIST_REGION(a, b) ((a) << 8 | (b))

/**
 * Special toplist regions
 */
typedef enum {
  SP_TOPLIST_REGION_EVERYWHERE = 0, ///< Global toplist
  SP_TOPLIST_REGION_USER = 1,       ///< Toplist for a given user
} sp_toplistregion;


/**
 * The type of a callback used in sp_toplistbrowse_create()
 *
 * When the callback is called, the metadata of all tracks belonging to it will have
 * been loaded, so sp_track_is_loaded() will return non-zero. The same goes for the
 * similar toplist data.
 *
 * @param[in]   result          The same pointer returned by sp_toplistbrowse_create()
 * @param[in]   userdata        The opaque pointer given to sp_toplistbrowse_create()
 */
typedef void SP_CALLCONV toplistbrowse_complete_cb(sp_toplistbrowse *result, void *userdata);

/**
 * Initiate a request for browsing an toplist
 *
 * The user is responsible for freeing the returned toplist browse using sp_toplistbrowse_release(). This can be done in the callback.
 *
 * @param[in]   session         Session object
 * @param[in]   type            Type of toplist to be browsed. see the sp_toplisttype enum for possible values
 * @param[in]   region          Region. see sp_toplistregion enum. Country specific regions are coded as two chars in an integer.
 *                              Sweden would correspond to 'S' << 8 | 'E'
 * @param[in]   username        If region is SP_TOPLIST_REGION_USER this specifies which user to get toplists for. NULL means the logged in user.
 * @param[in]   callback        Callback to be invoked when browsing has been completed. Pass NULL if you are not interested in this event.
 * @param[in]   userdata        Userdata passed to callback.
 *
 * @return                      Toplist browse object
 *
 * @see ::toplistbrowse_complete_cb
 */
SP_LIBEXPORT(sp_toplistbrowse *) sp_toplistbrowse_create(sp_session *session, sp_toplisttype type, sp_toplistregion region, const char *username, toplistbrowse_complete_cb *callback, void *userdata);


/**
 * Check if an toplist browse request is completed
 *
 * @param[in]   tlb        Toplist browse object
 *
 * @return                 True if browsing is completed, false if not
 */
SP_LIBEXPORT(bool) sp_toplistbrowse_is_loaded(sp_toplistbrowse *tlb);

/**
* Check if browsing returned an error code.
*
* @param[in]   tlb        Toplist browse object
*
* @return                 One of the following errors, from ::sp_error
*                         SP_ERROR_OK
*                         SP_ERROR_IS_LOADING
*                         SP_ERROR_OTHER_PERMANENT
*                         SP_ERROR_OTHER_TRANSIENT
*/
SP_LIBEXPORT(sp_error) sp_toplistbrowse_error(sp_toplistbrowse *tlb);



/**
 * Increase the reference count of an toplist browse result
 *
 * @param[in]   tlb       The toplist browse result object
 * @return                One of the following errors, from ::sp_error
 *                        SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_toplistbrowse_add_ref(sp_toplistbrowse *tlb);

/**
 * Decrease the reference count of an toplist browse result
 *
 * @param[in]   tlb       The toplist browse result object
 * @return                One of the following errors, from ::sp_error
 *                        SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_toplistbrowse_release(sp_toplistbrowse *tlb);

/**
 * Given an toplist browse object, return number of artists
 *
 * @param[in]   tlb         Toplist browse object
 *
 * @return                  Number of artists on toplist
 */
SP_LIBEXPORT(int) sp_toplistbrowse_num_artists(sp_toplistbrowse *tlb);

/**
 * Return the artist at the given index in the given toplist browse object
 *
 * @param[in]  tlb        Toplist object
 * @param[in]  index      Index of the wanted artist. Should be in the interval [0, sp_toplistbrowse_num_artists() - 1]
 *
 * @return                The artist at the given index in the given toplist browse object
 */
SP_LIBEXPORT(sp_artist *) sp_toplistbrowse_artist(sp_toplistbrowse *tlb, int index);


/**
 * Given an toplist browse object, return number of albums
 *
 * @param[in]   tlb         Toplist browse object
 *
 * @return                  Number of albums on toplist
 */
SP_LIBEXPORT(int) sp_toplistbrowse_num_albums(sp_toplistbrowse *tlb);


/**
 * Return the album at the given index in the given toplist browse object
 *
 * @param[in]  tlb        Toplist object
 * @param[in]  index      Index of the wanted album. Should be in the interval [0, sp_toplistbrowse_num_albums() - 1]
 *
 * @return                The album at the given index in the given toplist browse object
 */
SP_LIBEXPORT(sp_album *) sp_toplistbrowse_album(sp_toplistbrowse *tlb, int index);


/**
 * Given an toplist browse object, return number of tracks
 *
 * @param[in]   tlb         Toplist browse object
 *
 * @return                  Number of tracks on toplist
 */
SP_LIBEXPORT(int) sp_toplistbrowse_num_tracks(sp_toplistbrowse *tlb);


/**
 * Return the track at the given index in the given toplist browse object
 *
 * @param[in]  tlb        Toplist object
 * @param[in]  index      Index of the wanted track. Should be in the interval [0, sp_toplistbrowse_num_tracks() - 1]
 *
 * @return                The track at the given index in the given toplist browse object
 */
SP_LIBEXPORT(sp_track *) sp_toplistbrowse_track(sp_toplistbrowse *tlb, int index);

/**
 * Return the time (in ms) that was spent waiting for the Spotify backend to serve the request
 *
 * @param[in]  tlb        Toplist object
 *
 * @return                -1 if the request was served from the local cache
 *                        If the result is not yet loaded the return value is undefined
 */
SP_LIBEXPORT(int) sp_toplistbrowse_backend_request_duration(sp_toplistbrowse *tlb);


/** @} */

/**
 * @defgroup inbox Inbox subsystem
 * @{
 */

/**
 * The type of a callback used in sp_inbox_post()
 *
 * When this callback is called, the sp_track_is_loaded(), sp_album_is_loaded(),
 * and sp_artist_is_loaded() functions will return non-zero for the objects
 * contained in the search result.
 *
 * @param[in]   result          The same pointer returned by sp_search_create()
 * @param[in]   userdata        The opaque pointer given to sp_search_create()
 */
typedef void SP_CALLCONV inboxpost_complete_cb(sp_inbox *result, void *userdata);

/**
 * Add to inbox
 *
 * @param[in]  session    Session object
 * @param[in]  user       Canonical username of recipient
 * @param[in]  tracks     Array of tracks to post
 * @param[in]  num_tracks Number of tracks in \p tracks
 * @param[in]  message    Message to attach to tracks. UTF-8
 * @param[in]  callback   Callback to be invoked when the request has completed
 * @param[in]  userdata   Userdata passed to callback
 *
 * @return                sp_inbox object if the request has been sent, NULL if request failed to initialize
 */
SP_LIBEXPORT(sp_inbox *) sp_inbox_post_tracks(sp_session *session, const char *user, sp_track * const *tracks, int num_tracks, const char *message, inboxpost_complete_cb *callback, void *userdata);


/**
* Check if inbox operation returned an error code.
*
* @param[in]   inbox      Inbox object
*
* @return                 One of the following errors, from ::sp_error
*                         SP_ERROR_OK
*                         SP_ERROR_OTHER_TRANSIENT
*                         SP_ERROR_PERMISSION_DENIED
*                         SP_ERROR_INVALID_INDATA
*                         SP_ERROR_INBOX_IS_FULL
*                         SP_ERROR_NO_SUCH_USER
*                         SP_ERROR_OTHER_PERMANENT
*/
SP_LIBEXPORT(sp_error) sp_inbox_error(sp_inbox *inbox);

/**
 * Increase the reference count of a inbox result
 *
 * @param[in]   inbox    The inbox result object
 * @return               One of the following errors, from ::sp_error
 *                       SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_inbox_add_ref(sp_inbox *inbox);

/**
 * Decrease the reference count of a inbox result
 *
 * @param[in]   inbox    The inbox result object
 * @return               One of the following errors, from ::sp_error
 *                       SP_ERROR_OK
 */
SP_LIBEXPORT(sp_error) sp_inbox_release(sp_inbox *inbox);

/** @} */

/**
 * Return the libspotify build ID
 *
 * This might be useful to have available for display somewhere in your
 * user interface.
 */
SP_LIBEXPORT(const char *) sp_build_id(void);

#ifdef __cplusplus
}
#endif

#endif /* PUBLIC_API_H */
/**
 * @example browse.c
 *
 * The browse.c example shows how you can use the album, artist, and browse functions.
 * The example also include some rudimentary playlist browsing.
 * It is part of the spshell program
 */
/**
 * @example search.c
 *
 * The search.c example shows how you can use search functions.
 * It is part of the spshell program
 */
/**
 * @example toplist.c
 *
 * The toplist.c example shows how you can use toplist functions.
 * It is part of the spshell program
 */
/**
 * @example jukebox.c
 *
 * The jukebox.c example shows how you can use playback and playlist functions.
 */


================================================
FILE: libspotify/licenses.xhtml
================================================
<?xml version             = "1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
  <title>
    Third-party licenses
  </title>
  <style type="text/css" media="screen">
  body {
    margin: 20px;
  }
  body, td, div, p, li {
    font-family:helvetica,arial,sans-serif;
    font-size:13px;
    line-height:1.3;
    color:#555;
  }
  h1, h2, h3, h4, h5, h6 {
    font-family: helvetica, arial, sans-serif;
    font-weight:normal;
    color: #222;
    margin: 0;
    padding: 0;
    line-height: 1.0;
  }
  h1 {
    font-size:22px;
    padding: 0px;
    margin: 0px;
    color:#222;
  }
  h2 {
    font-size:18px;
    padding: 0px;
    margin: 30px 0px 0px;
    color:#222;
  }
  h3 {
    font-size: 13px;
    font-weight: bold;
  }
  p {
    margin: 14px 0 14px 0;
  }
  a {
    text-decoration: none;
  }
  a:link, a:active {
    color: #0088CC;
  }
  a:visited {
    color: #406e8d;
  }
  a:link:hover, a:active:hover, a:visited:hover {
    background-color: #e0f2c2;
    color: #518300;
    border-color: #999;
  }
  h2 a {
    color: #222 !important;
  }
  hr {
    border: none;
    border-top: 1px solid #ddd;
    height: 1px;
  }
  ul.toc {
    list-style: none;
    padding: 0px;
    padding-left: 10px;
  }
  ul.toc li {
    padding-left: 0px;
  }
  ul {
    list-style: square;
    margin: 14px 0px;
  }
  li {
    padding: 0px 0px 4px;
  }
  </style>
</head>
<body>
  <div class="page-wrapper">
    <h1>
      Third-party licenses
    </h1>
    <p>
      Several fantastic pieces of <a href = "http://www.gnu.org/philosophy/free-sw.html">free</a> and <a href="http://www.opensource.org/">open-source</a> software have really helped get <a href="http://www.spotify.com/">Spotify</a> to where it is today. A few require that we include their license agreements within our product. Consider it done. As we enjoy giving credit where it's due, we included the entire list below. This means you can not only see which software we've been using, but the terms of the licenses too. A big thanks from all of us at Spotify to the smart people behind the fantastic programs listed. Rock on!
    </p>
    <ul class="toc">
      <li>
        <a href="#boost">Boost</a>
      </li>
      <li>
        <a href="#expat">Expat</a>
      </li>
      <li>
        <a href="#fastdelegate">FastDelegate</a>
      </li>
      <li>
        <a href="#libogg">libogg</a>
      </li>
      <li>
        <a href="#libvorbis">libvorbis</a>
      </li>
      <li>
        <a href="#tremolo">Tremolo</a>
      </li>
      <li>
        <a href="#tremor">Tremor</a>
      </li>
      <li>
        <a href="#mersennetwister">Mersenne Twister</a>
      </li>
      <li>
        <a href="#zlib">zlib</a>
      </li>
      <li>
        <a href="#curl">cURL</a>
      </li>
      <li>
        <a href="#cares">c-ares</a>
      </li>
    </ul>
    <hr />
    <h2><a name="boost" id="boost" href="#boost">
      Boost
    </a></h2>
    <p>
      <a href="http://www.boost.org/">http://www.boost.org/</a>
    </p>
    <p>
      Boost Software License - Version 1.0 - August 17th, 2003
    </p>
    <p>
      Permission is hereby granted, free of charge, to any person or organization obtaining a copy of the software and accompanying documentation covered by this license (the "Software") to use, reproduce, display, distribute, execute, and transmit the Software, and to prepare derivative works of the Software, and to permit third-parties to whom the Software is furnished to do so, all subject to the following:
    </p>
    <p>
      The copyright notices in the Software and this entire statement, including the above license grant, this restriction and the following disclaimer, must be included in all copies of the Software, in whole or in part, and all derivative works of the Software, unless such copies or derivative works are solely in the form of machine-executable object code generated by a source language processor.
    </p>
    <p>
      THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
    </p>
    <hr />
    <h2><a name="expat" id="expat" href="#expat">
      Expat
    </a></h2>
    <p>
      <a href="http://www.jclark.com/xml/expat.html">http://www.jclark.com/xml/expat.html</a>
    </p>
    <p>
      Expat License. Copyright (c) 1998, 1999, 2000 Thai Open Source Software Center Ltd
    </p>
    <p>
      Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
    </p>
    <p>
      The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
    </p>
    <p>
      THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
    </p>
    <hr />
    <h2><a name="fastdelegate" id="fastdelegate" href="#fastdelegate">
      FastDelegate
    </a></h2>
    <p>
      <a href="http://www.codeproject.com/KB/cpp/FastDelegate.aspx">http://www.codeproject.com/KB/cpp/FastDelegate.aspx</a>
    </p>
    <p>
      THE WORK (AS DEFINED BELOW) IS PROVIDED UNDER THE TERMS OF THIS CODE PROJECT OPEN LICENSE ("LICENSE"). THE WORK IS PROTECTED BY COPYRIGHT AND/OR OTHER APPLICABLE LAW. ANY USE OF THE WORK OTHER THAN AS AUTHORIZED UNDER THIS LICENSE OR COPYRIGHT LAW IS PROHIBITED.
    </p>
    <p>
      BY EXERCISING ANY RIGHTS TO THE WORK PROVIDED HEREIN, YOU ACCEPT AND AGREE TO BE BOUND BY THE TERMS OF THIS LICENSE. THE AUTHOR GRANTS YOU THE RIGHTS CONTAINED HEREIN IN CONSIDERATION OF YOUR ACCEPTANCE OF SUCH TERMS AND CONDITIONS. IF YOU DO NOT AGREE TO ACCEPT AND BE BOUND BY THE TERMS OF THIS LICENSE, YOU CANNOT MAKE ANY USE OF THE WORK.
    </p>
    <ol>
      <li>
        Definitions.
        <ol type="a">
          <li>
            "Articles" means, collectively, all articles written by Author which describes how the Source Code and Executable Files for the Work may be used by a user.
          </li>
          <li>
            "Author" means the individual or entity that offers the Work under the terms of this License.
          </li>
          <li>
            "Derivative Work" means a work based upon the Work or upon the Work and other pre-existing works.
          </li>
          <li>
            "Executable Files" refer to the executables, binary files, configuration and any required data files included in the Work.
          </li>
          <li>
            "Publisher" means the provider of the website, magazine, CD-ROM, DVD or other medium from or by which the Work is obtained by You.
          </li>
          <li>
            "Source Code" refers to the collection of source code and configuration files used to create the Executable Files.
          </li>
          <li>
            "Standard Version" refers to such a Work if it has not been modified, or has been modified in accordance with the consent of the Author, such consent being in the full discretion of the Author.
          </li>
          <li>
            "Work" refers to the collection of files distributed by the Publisher, including the Source Code, Executable Files, binaries, data files, documentation, whitepapers and the Articles.
          </li>
          <li>
            "You" is you, an individual or entity wishing to use the Work and exercise your rights under this License.
          </li>
        </ol>
      </li>
      <li>
        Fair Use/Fair Use Rights. Nothing in this License is intended to reduce, limit, or restrict any rights arising from fair use, fair dealing, first sale or other limitations on the exclusive rights of the copyright owner under copyright law or other applicable laws.
      </li>
      <li>
        License Grant. Subject to the terms and conditions of this License, the Author hereby grants You a worldwide, royalty-free, non-exclusive, perpetual (for the duration of the applicable copyright) license to exercise the rights in the Work as stated below:
        <ol type="a">
          <li>
            You may use the standard version of the Source Code or Executable Files in Your own applications.
          </li>
          <li>
            You may apply bug fixes, portability fixes and other modifications obtained from the Public Domain or from the Author. A Work modified in such a way shall still be considered the standard version and will be subject to this License.
          </li>
          <li>
            You may otherwise modify Your copy of this Work (excluding the Articles) in any way to create a Derivative Work, provided that You insert a prominent notice in each changed file stating how, when and where You changed that file.
          </li>
          <li>
            You may distribute the standard version of the Executable Files and Source Code or Derivative Work in aggregate with other (possibly commercial) programs as part of a larger (possibly commercial) software distribution.
          </li>
          <li>
            The Articles discussing the Work published in any form by the author may not be distributed or republished without the Author's consent. The author retains copyright to any such Articles. You may use the Executable Files and Source Code pursuant to this License but you may not repost or republish or otherwise distribute or make available the Articles, without the prior written consent of the Author.
          </li>
        </ol>
        Any subroutines or modules supplied by You and linked into the Source Code or Executable Files this Work shall not be considered part of this Work and will not be subject to the terms of this License.
      </li>
      <li>
        Patent License. Subject to the terms and conditions of this License, each Author hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, import, and otherwise transfer the Work.
      </li>
      <li>
        Restrictions. The license granted in Section 3 above is expressly made subject to and limited by the following restrictions:
        <ol type="a">
          <li>
            You agree not to remove any of the original copyright, patent, trademark, and attribution notices and associated disclaimers that may appear in the Source Code or Executable Files.
          </li>
          <li>
            You agree not to advertise or in any way imply that this Work is a product of Your own.
          </li>
          <li>
            The name of the Author may not be used to endorse or promote products derived from the Work without the prior written consent of the Author.
          </li>
          <li>
            You agree not to sell, lease, or rent any part of the Work. This does not restrict you from including the Work or any part of the Work inside a larger software distribution that itself is being sold. The Work by itself, though, cannot be sold, leased or rented.
          </li>
          <li>
            You may distribute the Executable Files and Source Code only under the terms of this License, and You must include a copy of, or the Uniform Resource Identifier for, this License with every copy of the Executable Files or Source Code You distribute and ensure that anyone receiving such Executable Files and Source Code agrees that the terms of this License apply to such Executable Files and/or Source Code. You may not offer or impose any terms on the Work that alter or restrict the terms of this License or the recipients' exercise of the rights granted hereunder. You may not sublicense the Work. You must keep intact all notices that refer to this License and to the disclaimer of warranties. You may not distribute the Executable Files or Source Code with any technological measures that control access or use of the Work in a manner inconsistent with the terms of this License.
          </li>
          <li>
            You agree not to use the Work for illegal, immoral or improper purposes, or on pages containing illegal, immoral or improper material. The Work is subject to applicable export laws. You agree to comply with all such laws and regulations that may apply to the Work after Your receipt of the Work.
          </li>
        </ol>
      </li>
      <li>
        Representations, Warranties and Disclaimer. THIS WORK IS PROVIDED "AS IS", "WHERE IS" AND "AS AVAILABLE", WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES OR CONDITIONS OR GUARANTEES. YOU, THE USER, ASSUME ALL RISK IN ITS USE, INCLUDING COPYRIGHT INFRINGEMENT, PATENT INFRINGEMENT, SUITABILITY, ETC. AUTHOR EXPRESSLY DISCLAIMS ALL EXPRESS, IMPLIED OR STATUTORY WARRANTIES OR CONDITIONS, INCLUDING WITHOUT LIMITATION, WARRANTIES OR CONDITIONS OF MERCHANTABILITY, MERCHANTABLE QUALITY OR FITNESS FOR A PARTICULAR PURPOSE, OR ANY WARRANTY OF TITLE OR NON-INFRINGEMENT, OR THAT THE WORK (OR ANY PORTION THEREOF) IS CORRECT, USEFUL, BUG-FREE OR FREE OF VIRUSES. YOU MUST PASS THIS DISCLAIMER ON WHENEVER YOU DISTRIBUTE THE WORK OR DERIVATIVE WORKS.
      </li>
      <li>
        Indemnity. You agree to defend, indemnify and hold harmless the Author and the Publisher from and against any claims, suits, losses, damages, liabilities, costs, and expenses (including reasonable legal or attorneys’ fees) resulting from or relating to any use of the Work by You.
      </li>
      <li>
        Limitation on Liability. EXCEPT TO THE EXTENT REQUIRED BY APPLICABLE LAW, IN NO EVENT WILL THE AUTHOR OR THE PUBLISHER BE LIABLE TO YOU ON ANY LEGAL THEORY FOR ANY SPECIAL, INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR EXEMPLARY DAMAGES ARISING OUT OF THIS LICENSE OR THE USE OF THE WORK OR OTHERWISE, EVEN IF THE AUTHOR OR THE PUBLISHER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
      </li>
      <li>
        Termination.
        <ol type="a">
          <li>
            This License and the rights granted hereunder will terminate automatically upon any breach by You of any term of this License. Individuals or entities who have received Derivative Works from You under this License, however, will not have their licenses terminated provided such individuals or entities remain in full compliance with those licenses. Sections 1, 2, 6, 7, 8, 9, 10 and 11 will survive any termination of this License.
          </li>
          <li>
            If You bring a copyright, trademark, patent or any other infringement claim against any contributor over infringements You claim are made by the Work, your License from such contributor to the Work ends automatically.
          </li>
          <li>
            Subject to the above terms and conditions, this License is perpetual (for the duration of the applicable copyright in the Work). Notwithstanding the above, the Author reserves the right to release the Work under different license terms or to stop distributing the Work at any time; provided, however that any such election will not serve to withdraw this License (or any other license that has been, or is required to be, granted under the terms of this License), and this License will continue in full force and effect unless terminated as stated above.
          </li>
        </ol>
      </li>
      <li>
        Publisher. The parties hereby confirm that the Publisher shall not, under any circumstances, be responsible for and shall not have any liability in respect of the subject matter of this License. The Publisher makes no warranty whatsoever in connection with the Work and shall not be liable to You or any party on any legal theory for any damages whatsoever, including without limitation any general, special, incidental or consequential damages arising in connection to this license. The Publisher reserves the right to cease making the Work available to You at any time without notice
      </li>
      <li>
        Miscellaneous
        <ol type="a">
          <li>
            This License shall be governed by the laws of the location of the head office of the Author or if the Author is an individual, the laws of location of the principal place of residence of the Author.
          </li>
          <li>
            If any provision of this License is invalid or unenforceable under applicable law, it shall not affect the validity or enforceability of the remainder of the terms of this License, and without further action by the parties to this License, such provision shall be reformed to the minimum extent necessary to make such provision valid and enforceable.
          </li>
          <li>
            No term or provision of this License shall be deemed waived and no breach consented to unless such waiver or consent shall be in writing and signed by the party to be charged with such waiver or consent.
          </li>
          <li>
            This License constitutes the entire agreement between the parties with respect to the Work licensed herein. There are no understandings, agreements or representations with respect to the Work not specified herein. The Author shall not be bound by any additional provisions that may appear in any communication from You. This License may not be modified without the mutual written agreement of the Author and You
          </li>
        </ol>
      </li>
    </ol>
    <hr />
    <h2><a name="libogg" id="libogg" href="#libogg">
      libogg
    </a></h2>
    <p>
      <a href="http://www.xiph.org/ogg/">http://www.xiph.org/ogg/</a>
    </p>
    <p>
      Copyright (c) 2002, Xiph.org Foundation
    </p>
    <p>
      Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
    </p>
    <ul>
      <li>
        Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
      </li>
      <li>
        Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
      </li>
      <li>
        Neither the name of the Xiph.org Foundation nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
      </li>
    </ul>
    <p>
      THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    </p>
    <hr />
    <h2><a name="libvorbis" id="libvorbis" href="#libvorbis">
      libvorbis
    </a></h2>
    <p>
      <a href="http://www.xiph.org/vorbis/">http://www.xiph.org/vorbis/</a>
    </p>
    <p>
      Copyright (c) 2002-2004 Xiph.org Foundation
    </p>
    <p>
      Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
    </p>
    <ul>
      <li>
        Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
      </li>
      <li>
        Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
      </li>
      <li>
        Neither the name of the Xiph.org Foundation nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
      </li>
    </ul>
    <p>
      THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    </p>
    <hr />
    <h2><a name="tremolo" id="tremolo" href="#tremolo">
      Tremolo
    </a></h2>
    <p>
      <a href="http://wss.co.uk/pinknoise/tremolo/">http://wss.co.uk/pinknoise/tremolo</a>
    </p>
    <p>
      Copyright (C) 2002-2009 Xiph.org Foundation
      Changes Copyright (C) 2009-2010 Robin Watts for Pinknoise Productions Ltd
    </p>
    <p>
      Redistribution and use in source and binary forms, with or without
      modification, are permitted provided that the following conditions
      are met:
    </p>
    <p>
      - Redistributions of source code must retain the above copyright
      notice, this list of conditions and the following disclaimer.
    </p>
    <p>
      - Redistributions in binary form must reproduce the above copyright
      notice, this list of conditions and the following disclaimer in the
      documentation and/or other materials provided with the distribution.
    </p>
    <p>
      - Neither the name of the Xiph.org Foundation nor the names of its
      contributors may be used to endorse or promote products derived from
      this software without specific prior written permission.
    </p>
    <p>
      THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
      ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
      LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
      A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION
      OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
      SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
      LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
      DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
      THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
      (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
      OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    </p>
    <hr />
    <h2><a name="tremor" id="tremor" href="#tremor">
      Tremor
    </a></h2>
    <p>
      <a href="http://wiki.xiph.org/index.php/Tremor">http://wiki.xiph.org/index.php/Tremor</a>
    </p>
    <p>
      Copyright (c) 2002, Xiph.org Foundation
    </p>
    <p>
      Redistribution and use in source and binary forms, with or without
      modification, are permitted provided that the following conditions
      are met:
    </p>
    <p>
      - Redistributions of source code must retain the above copyright
      notice, this list of conditions and the following disclaimer.
    </p>
    <p>
      - Redistributions in binary form must reproduce the above copyright
      notice, this list of conditions and the following disclaimer in the
      documentation and/or other materials provided with the distribution.
    </p>
    <p>
      - Neither the name of the Xiph.org Foundation nor the names of its
      contributors may be used to endorse or promote products derived from
      this software without specific prior written permission.
    </p>
    <p>
      THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
      ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
      LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
      A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION
      OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
      SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
      LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
      DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
      THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
      (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
      OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    </p>
    <hr />
    <h2><a name="mersennetwister" id="mersennetwister" href="#mersennetwister">
      Mersenne Twister
    </a></h2>
    <p>
      <a href="http://www.math.sci.hiroshima-u.ac.jp/~m-mat/MT/MT2002/CODES/mt19937ar.c">http://www.math.sci.hiroshima-u.ac.jp/~m-mat/MT/MT2002/CODES/mt19937ar.c</a>
    </p>
    <p>
      Copyright (C) 1997 - 2002, Makoto Matsumoto and Takuji Nishimura,<br />
      All rights reserved.
    </p>
    <p>
      Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
    </p>
    <ol>
      <li>
        Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
      </li>
      <li>
        Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
      </li>
      <li>
        The names of its contributors may not be used to endorse or promote products derived from this software without specific prior written permission.
      </li>
    </ol>
    <p>
      THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    </p>
    <hr />
    <h2><a name="zlib" id="zlib" href="#zlib">
      zlib
    </a></h2>
    <p>
      <a href="http://www.zlib.net/">http://www.zlib.net/</a>
    </p>
    <p>
      zlib.h -- interface of the 'zlib' general purpose compression library version 1.2.3, July 18th, 2005
    </p>
    <p>
      Copyright (C) 1995-2004 Jean-loup Gailly and Mark Adler
    </p>
    <p>
      This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.
    </p>
    <p>
      Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:
    </p>
    <ol>
      <li>
        The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.
      </li>
      <li>
        Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
      </li>
      <li>
        This notice may not be removed or altered from any source distribution.
      </li>
    </ol>
    <p>
      Jean-loup Gailly <a href="mailto:jloup@gzip.org">jloup@gzip.org</a>, Mark Adler <a href="mailto:madler@alumni.caltech.edu">madler@alumni.caltech.edu</a>
    </p>
    <hr />
    <h2><a name="curl" id="curl" href="#curl">
      cURL
    </a></h2>
    <p>
      <a href="http://curl.haxx.se">http://curl.haxx.se</a>
    </p>
    <p>
      COPYRIGHT AND PERMISSION NOTICE
    </p>
    <p>
      Copyright (c) 1996 - 2011, Daniel Stenberg, &lt;daniel@haxx.se&gt;.
    </p>
    <p>
      All rights reserved.
    </p>
    <p>
      Permission to use, copy, modify, and distribute this software for any purpose
      with or without fee is hereby granted, provided that the above copyright
      notice and this permission notice appear in all copies.
    </p>
    <p>
      THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
      IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
      FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN
      NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
      DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
      OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE
      OR OTHER DEALINGS IN THE SOFTWARE.
    </p>
    <p>
      Except as contained in this notice, the name of a copyright holder shall not
      be used in advertising or otherwise to promote the sale, use or other dealings
      in this Software without prior written authorization of the
      copyright holder.
    </p>
    <hr />
    <h2><a name="cares" id="cares" href="#cares">
      c-ares
    </a></h2>
    <p>
      <a href="http://c-ares.haxx.se">http://c-ares.haxx.se</a>
    </p>
    <p>
      Copyright 1998 by the Massachusetts Institute of Technology.
    </p>
    <p>
      Permission to use, copy, modify, and distribute this software and its
      documentation for any purpose and without fee is hereby granted, provided that
      the above copyright notice appear in all copies and that both that copyright
      notice and this permission notice appear in supporting documentation, and that
      the name of M.I.T. not be used in advertising or publicity pertaining to
      distribution of the software without specific, written prior permission.
      M.I.T. makes no representations about the suitability of this software for any
     purpose.  It is provided "as is" without express or implied warranty.
    </p>
 </div>
</body>
</html>


================================================
FILE: licenses/JSON for Modern C++.txt
================================================
MIT License 

Copyright (c) 2013-2018 Niels Lohmann

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.


================================================
FILE: licenses/LibSpotify.txt
================================================
For the current terms and conditions, please read:

http://developer.spotify.com/en/libspotify/terms-of-use/


================================================
FILE: licenses/PFC.txt
================================================
Copyright (C) 2002-2019 Peter Pawlowski

This software is provided 'as-is', without any express or implied
warranty.  In no event will the authors be held liable for any damages
arising from the use of this software.

Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you must not
   claim that you wrote the original software. If you use this software
   in a product, an acknowledgment in the product documentation would be
   appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not be
   misrepresented as being the original software.
3. This notice may not be removed or altered from any source distribution.

================================================
FILE: licenses/WTL.txt
================================================
Microsoft Public License (MS-PL)

This license governs use of the accompanying software. If you use the software, you
accept this license. If you do not accept the license, do not use the software.

1. Definitions
The terms "reproduce," "reproduction," "derivative works," and "distribution" have the
same meaning here as under U.S. copyright law.
A "contribution" is the original software, or any additions or changes to the software.
A "contributor" is any person that distributes its contribution under this license.
"Licensed patents" are a contributor's patent claims that read directly on its contribution.

2. Grant of Rights
(A) Copyright Grant- Subject to the terms of this license, including the license conditions and limitations in section 3, each contributor grants you a non-exclusive, worldwide, royalty-free copyright license to reproduce its contribution, prepare derivative works of its contribution, and distribute its contribution or any derivative works that you create.
(B) Patent Grant- Subject to the terms of this license, including the license conditions and limitations in section 3, each contributor grants you a non-exclusive, worldwide, royalty-free license under its licensed patents to make, have made, use, sell, offer for sale, import, and/or otherwise dispose of its contribution in the software or derivative works of the contribution in the software.

3. Conditions and Limitations
(A) No Trademark License- This license does not grant you rights to use any contributors' name, logo, or trademarks.
(B) If you bring a patent claim against any contributor over patents that you claim are infringed by the software, your patent license from such contributor to the software ends automatically.
(C) If you distribute any portion of the software, you must retain all copyright, patent, trademark, and attribution notices that are present in the software.
(D) If you distribute any portion of the software in source code form, you may do so only under this license by including a complete copy of this license with your distribution. If you distribute any portion of the software in compiled or object code form, you may only do so under a license that complies with this license.
(E) The software is licensed "as-is." You bear the risk of using it. The contributors give no express warranties, guarantees or conditions. You may have additional consumer rights under your local laws which this license cannot change. To the extent permitted under your local laws, the contributors exclude the implied warranties of merchantability, fitness for a particular purpose and non-infringement.


================================================
FILE: licenses/fmt.txt
================================================
Copyright (c) 2012 - present, Victor Zverovich

Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

--- Optional exception to the license ---

As an exception, if, as a result of your compiling your source code, portions
of this Software are embedded into a machine-executable object form of such
source code, you may redistribute such embedded portions in such object form
without including the above copyright and permission notices.


================================================
FILE: licenses/foobar2000 SDK.txt
================================================
foobar2000 1.5 SDK
Copyright (c) 2001-2019, Peter Pawlowski
All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 
Neither the name of the author nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Note that separate less restrictive licenses apply to the included 'pfc' and 'libPPUI' libraries. See license files included in respective folders for details.


================================================
FILE: licenses/range-v3.txt
================================================
========================================================
Boost Software License - Version 1.0 - August 17th, 2003
========================================================

Permission is hereby granted, free of charge, to any person or organization
obtaining a copy of the software and accompanying documentation covered by
this license (the "Software") to use, reproduce, display, distribute,
execute, and transmit the Software, and to prepare derivative works of the
Software, and to permit third-parties to whom the Software is furnished to
do so, all subject to the following:

The copyright notices in the Software and this entire statement, including
the above license grant, this restriction and the following disclaimer,
must be included in all copies of the Software, in whole or in part, and
all derivative works of the Software, unless such copies or derivative
works are solely in the form of machine-executable object code generated by
a source language processor.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.

==============================================================================
libc++ License
==============================================================================

The libc++ library is dual licensed under both the University of Illinois
"BSD-Like" license and the MIT license.  As a user of this code you may choose
to use it under either license.  As a contributor, you agree to allow your code
to be used under both.

Full text of the relevant licenses is included below.

==============================================================================

University of Illinois/NCSA
Open Source License

Copyright (c) 2009-2014 by the contributors listed in CREDITS.TXT
http://llvm.org/svn/llvm-project/libcxx/trunk/CREDITS.TXT

All rights reserved.

Developed by:

    LLVM Team

    University of Illinois at Urbana-Champaign

    http://llvm.org

Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal with
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
of the Software, and to permit persons to whom the Software is furnished to do
so, subject to the following conditions:

    * Redistributions of source code must retain the above copyright notice,
      this list of conditions and the following disclaimers.

    * Redistributions in binary form must reproduce the above copyright notice,
      this list of conditions and the following disclaimers in the
      documentation and/or other materials provided with the distribution.

    * Neither the names of the LLVM Team, University of Illinois at
      Urbana-Champaign, nor the names of its contributors may be used to
      endorse or promote products derived from this Software without specific
      prior written permission.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
CONTRIBUTORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS WITH THE
SOFTWARE.

==============================================================================

Copyright (c) 2009-2014 by the contributors listed in CREDITS.TXT
  http://llvm.org/svn/llvm-project/libcxx/trunk/CREDITS.TXT

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.

==============================================================================
Stepanov and McJones, "Elements of Programming" license
==============================================================================

// Copyright (c) 2009 Alexander Stepanov and Paul McJones
//
// Permission to use, copy, modify, distribute and sell this software
// and its documentation for any purpose is hereby granted without
// fee, provided that the above copyright notice appear in all copies
// and that both that copyright notice and this permission notice
// appear in supporting documentation. The authors make no
// representations about the suitability of this software for any
// purpose. It is provided "as is" without express or implied
// warranty.
//
// Algorithms from
// Elements of Programming
// by Alexander Stepanov and Paul McJones
// Addison-Wesley Professional, 2009

==============================================================================
SGI C++ Standard Template Library license
==============================================================================

// Copyright (c) 1994
// Hewlett-Packard Company
//
// Permission to use, copy, modify, distribute and sell this software
// and its documentation for any purpose is hereby granted without fee,
// provided that the above copyright notice appear in all copies and
// that both that copyright notice and this permission notice appear
// in supporting documentation.  Hewlett-Packard Company makes no
// representations about the suitability of this software for any
// purpose.  It is provided "as is" without express or implied warranty.
//
// Copyright (c) 1996
// Silicon Graphics Computer Systems, Inc.
//
// Permission to use, copy, modify, distribute and sell this software
// and its documentation for any purpose is hereby granted without fee,
// provided that the above copyright notice appear in all copies and
// that both that copyright notice and this permission notice appear
// in supporting documentation.  Silicon Graphics makes no
// representations about the suitability of this software for any
// purpose.  It is provided "as is" without express or implied warranty.
//


================================================
FILE: licenses/ring-span-lite.txt
================================================
Boost Software License - Version 1.0 - August 17th, 2003

Permission is hereby granted, free of charge, to any person or organization
obtaining a copy of the software and accompanying documentation covered by
this license (the "Software") to use, reproduce, display, distribute,
execute, and transmit the Software, and to prepare derivative works of the
Software, and to permit third-parties to whom the Software is furnished to
do so, all subject to the following:

The copyright notices in the Software and this entire statement, including
the above license grant, this restriction and the following disclaimer,
must be included in all copies of the Software, in whole or in part, and
all derivative works of the Software, unless such copies or derivative
works are solely in the form of machine-executable object code generated by
a source language processor.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.


================================================
FILE: licenses/span-lite.txt
================================================
Boost Software License - Version 1.0 - August 17th, 2003

Permission is hereby granted, free of charge, to any person or organization
obtaining a copy of the software and accompanying documentation covered by
this license (the "Software") to use, reproduce, display, distribute,
execute, and transmit the Software, and to prepare derivative works of the
Software, and to permit third-parties to whom the Software is furnished to
do so, all subject to the following:

The copyright notices in the Software and this entire statement, including
the above license grant, this restriction and the following disclaimer,
must be included in all copies of the Software, in whole or in part, and
all derivative works of the Software, unless such copies or derivative
works are solely in the form of machine-executable object code generated by
a source language processor.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.


================================================
FILE: props/local_dependencies/libspotify.props
================================================
<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <ImportGroup Label="PropertySheets">
    </ImportGroup>
    <PropertyGroup>
        <_PropertySheetDisplayName>libspotify</_PropertySheetDisplayName>
    </PropertyGroup>
    <PropertyGroup Label="UserMacros">
        <LibSpotifyDirectory>$(MainDir)libspotify\</LibSpotifyDirectory>
        <LibSpotifyLibDirectory>$(LibSpotifyDirectory)lib\</LibSpotifyLibDirectory>
        <LibSpotifyIncludeDirectory>$(LibSpotifyDirectory)include\</LibSpotifyIncludeDirectory>
        <LibSpotifyDependencies>libspotify.lib</LibSpotifyDependencies>
    </PropertyGroup>
    <PropertyGroup>
        <IncludePath>$(LibSpotifyIncludeDirectory);$(IncludePath)</IncludePath>
    </PropertyGroup>
    <ItemDefinitionGroup>
        <Link>
            <AdditionalLibraryDirectories>$(LibSpotifyLibDirectory);%(AdditionalLibraryDirectories)</AdditionalLibraryDirectories>
            <AdditionalDependencies>$(LibSpotifyDependencies);%(AdditionalDependencies)</AdditionalDependencies>
        </Link>
    </ItemDefinitionGroup>
    <ItemGroup />
</Project>

================================================
FILE: props/submodules/fb2k_utils.props
================================================
<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <ImportGroup Label="PropertySheets">
  </ImportGroup>
  <PropertyGroup>
    <_PropertySheetDisplayName>fb2k_utils</_PropertySheetDisplayName>
  </PropertyGroup>
  <PropertyGroup Label="UserMacros">
    <QwrFb2kUtilsRootDir>$(SolutionDir)..\submodules\fb2k_utils\</QwrFb2kUtilsRootDir>
    <QwrFb2kUtilsPropsDir>$(QwrFb2kUtilsRootDir)props\</QwrFb2kUtilsPropsDir>
  </PropertyGroup>
  <PropertyGroup>
    <IncludePath>$(QwrFb2kUtilsRootDir)src\;$(IncludePath)</IncludePath>
  </PropertyGroup>
</Project>

================================================
FILE: props/submodules/submodules.props
================================================
<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <ImportGroup Label="PropertySheets">
  </ImportGroup>
  <PropertyGroup>
    <_PropertySheetDisplayName>submodules</_PropertySheetDisplayName>
  </PropertyGroup>
  <PropertyGroup Label="UserMacros">
    <SubmodulesDirectory>$(SolutionDir)..\submodules\</SubmodulesDirectory>
  </PropertyGroup>
  <PropertyGroup>
    <IncludePath>$(SubmodulesDirectory);$(IncludePath)</IncludePath>
  </PropertyGroup>
</Project>

================================================
FILE: scripts/README.md
================================================
### Main scripts
- setup.py - Set up everything, so that project can be built.
- pack_component.py - Pack project binaries to .fb2k-component archive.
- generate_docs.py - Generate HTML docs from JsDoc docs.

### Auxiliary scripts
- update_submodules.py - Update submodules to their latest version.
- update_gh_pages.py - Update gh-pages folder with latest generated content.


================================================
FILE: scripts/call_wrapper.py
================================================
#!/usr/bin/env python3

import traceback
import sys

class SkippedError(Exception):
     def __init__(self):
         self.message = "Skipped error"

def final_call_decorator(start_msg: str,
                         success_msg: str,
                         failure_msg: str):
    def f_decorator(f):
        def wrapper(*args, **kwds):
            print(start_msg)
            try:
                f(*args, **kwds)
                print(success_msg)
                sys.exit(0)
            except SkippedError:
                print(failure_msg, file=sys.stderr)
                sys.exit(1)
            except Exception:
                traceback.print_exc(file=sys.stderr)
                print(failure_msg, file=sys.stderr)
                sys.exit(1)

        return wrapper

    return f_decorator


================================================
FILE: scripts/download_submodules.py
================================================
#!/usr/bin/env python3

import subprocess
from pathlib import Path

import call_wrapper

def download_submodule(root_dir, submodule_name):
    print(f"Downloading {submodule_name}...")
    try:
        subprocess.check_call(f"git submodule update --init --depth=10 -- submodules/{submodule_name}", cwd=root_dir, shell=True)
    except subprocess.CalledProcessError:
        try:
            subprocess.check_call(f"git submodule update --init --depth=50 -- submodules/{submodule_name}", cwd=root_dir, shell=True)
        except subprocess.CalledProcessError:
            # Shallow copy does not honour default branch config
            subprocess.check_call("git config --add remote.origin.fetch +refs/heads/*:refs/remotes/origin/*",
                                  cwd=root_dir/"submodules"/submodule_name,
                                  shell=True)
            subprocess.check_call(f"git submodule deinit --force -- submodules/{submodule_name}", cwd=root_dir, shell=True)
            subprocess.check_call(f"git submodule update --init --force -- submodules/{submodule_name}", cwd=root_dir, shell=True)

def download():
    cur_dir = Path(__file__).parent.absolute()
    root_dir = cur_dir.parent

    subprocess.check_call("git submodule sync", cwd=root_dir, shell=True)
    subprocess.check_call("git submodule foreach git reset --hard", cwd=root_dir, shell=True)
    for subdir in [f for f in (root_dir/"submodules").iterdir() if f.is_dir()]:
        download_submodule(root_dir, subdir.name)

if __name__ == '__main__':
    call_wrapper.final_call_decorator(
        "Downloading submodules",
        "Downloading submodules: success",
        "Downloading submodules: failure!"
    )(download)()


================================================
FILE: scripts/pack_component.py
================================================
#!/usr/bin/env python3

import argparse
import zipfile
from pathlib import Path
from zipfile import ZipFile

import call_wrapper

def path_basename_tuple(path):
    return (path, path.name)

def zipdir(zip_file, path, arc_path):
    assert(path.exists() and path.is_dir())

    for file in path.rglob('*'):
        if (file.name.startswith('.')):
            # skip `hidden` files
            continue
        if (arc_path):
            file_arc_path = f'{arc_path}/{file.relative_to(path)}'
        else:
            file_arc_path = file.relative_to(path)
        zip_file.write(file, file_arc_path)

def pack(is_debug = False):
    cur_dir = Path(__file__).parent.absolute()
    root_dir = cur_dir.parent
    result_machine_dir = root_dir/'_result'/('Win32_Debug' if is_debug else 'Win32_Release')
    assert(result_machine_dir.exists() and result_machine_dir.is_dir())

    output_dir = result_machine_dir
    output_dir.mkdir(parents=True, exist_ok=True)

    component_zip = output_dir/'foo_spotify.fb2k-component'
    component_zip.unlink(missing_ok=True)

    with ZipFile(component_zip, 'w', compression=zipfile.ZIP_DEFLATED, compresslevel=9) as z:
        zipdir(z, root_dir/'licenses', 'licenses')

        z.write(*path_basename_tuple(root_dir/'libspotify'/'lib'/'libspotify.dll'))

        z.write(*path_basename_tuple(root_dir/'LICENSE'))
        z.write(*path_basename_tuple(root_dir/'CHANGELOG.md'))
        
        z.write(*path_basename_tuple(result_machine_dir/'bin'/'foo_spotify.dll'))

        if (is_debug):
            # Only debug package should have pdbs inside
            z.write(*path_basename_tuple(result_machine_dir/'dbginfo'/'foo_spotify.pdb'))

    print(f'Generated file: {component_zip}')

    if (not is_debug):
        # Release pdbs are packed in a separate package
        pdb_zip = output_dir/'foo_spotify_pdb.zip'
        if (pdb_zip.exists()):
            pdb_zip.unlink()

        with ZipFile(pdb_zip, 'w', zipfile.ZIP_DEFLATED) as z:
            z.write(*path_basename_tuple(result_machine_dir/'dbginfo'/'foo_spotify.pdb'))

        print(f'Generated file: {pdb_zip}')

if __name__ == '__main__':
    parser = argparse.ArgumentParser(description='Pack component to .fb2k-component')
    parser.add_argument('--debug', default=False, action='store_true')

    args = parser.parse_args()

    call_wrapper.final_call_decorator(
        'Packing component',
        'Packing component: success',
        'Packing component: failure!'
    )(
    pack
    )(
        args.debug
    )


================================================
FILE: scripts/setup.py
================================================
#!/usr/bin/env python3

import argparse
import importlib
import importlib.util
import sys
import traceback
from pathlib import Path
from typing import Union

import call_wrapper
import download_submodules

PathLike = Union[str, Path]

def call_decorator(command_name: str):
    def f_decorator(f):
        def wrapper(*args, **kwds):
            print(f'>> {command_name}: starting')
            try:
                f(*args, **kwds)
                print(f'<< {command_name}: success')
            except Exception:
                traceback.print_exc(file=sys.stderr)
                print(f'<< {command_name}: failure', file=sys.stderr)
                raise call_wrapper.SkippedError()

        return wrapper

    return f_decorator

def load_module(script_path):
    spec = importlib.util.spec_from_file_location("module.name", script_path)
    mod = importlib.util.module_from_spec(spec)
    spec.loader.exec_module(mod)
    return mod

def setup( skip_submodules_download,
           skip_submodules_patches ):
    cur_dir = Path(__file__).parent.absolute()
    root_dir = cur_dir.parent
    scripts_path = root_dir/'submodules'/'fb2k_utils'/'scripts'

    if (not skip_submodules_download):
        call_decorator('Downloading submodules')(download_submodules.download)()
        if (not skip_submodules_patches):
            call_decorator('Patching fb2k submodules')(
                load_module(scripts_path/'patch_fb2k_submodules.py').patch
            )(
                root_dir=root_dir
            )

    call_decorator('Version header generation')(
        load_module(scripts_path/'generate_version_header.py').generate_header_custom
    )(
        repo_dir=root_dir,
        output_dir=root_dir/'_result'/'AllPlatforms'/'generated',
        component_prefix='SPTF'
    )
    call_decorator('Commit hash header generation')(
        load_module(scripts_path/'generate_commit_hash_header.py').generate_header_custom
    )(
        repo_dir=root_dir,
        output_dir=root_dir/'_result'/'AllPlatforms'/'generated',
        component_prefix='SPTF'
    )
    call_decorator('SourceLink configuration file generation'
    )(
        load_module(scripts_path/'generate_source_link_config.py').generate_config_custom
    )(
        repo_dir=root_dir,
        output_dir=root_dir/'_result'/'AllPlatforms'/'generated',
        repo='theqwertiest/foo_spotify'
    )
    call_decorator('3rd-party notices generation'
    )(
        load_module(scripts_path/'generate_third_party.py').generate
    )(
        root_dir=root_dir,
        component_name='Spotify Integration'
    )

if __name__ == '__main__':
    parser = argparse.ArgumentParser(description='Setup project')
    parser.add_argument('--skip_submodules_download', default=False, action='store_true')
    parser.add_argument('--skip_submodules_patches', default=False, action='store_true')

    args = parser.parse_args()

    call_wrapper.final_call_decorator(
        'Preparing project repo',
        'Setup complete!',
        'Setup failed!'
    )(
    setup
    )(
        args.skip_submodules_download,
        args.skip_submodules_patches
    )


================================================
FILE: scripts/update_gh_pages.py
================================================
#!/usr/bin/env python3

import argparse
import shutil
from pathlib import Path
from typing import Union

import call_wrapper

PathLike = Union[str, Path]

def update(gh_pages_dir: PathLike):
    cur_dir = Path(__file__).parent.absolute()
    root_dir = cur_dir.parent

    gh_pages_dir = Path(gh_pages_dir).resolve()
    assert(gh_pages_dir.exists() and gh_pages_dir.is_dir())

    ghp_gen_dir = gh_pages_dir/"assets"/"generated_files"
    if (ghp_gen_dir.exists()):
        shutil.rmtree(ghp_gen_dir)
        ghp_gen_dir.mkdir(parents=True)

    shutil.copytree(root_dir/"licenses", ghp_gen_dir/"licenses", dirs_exist_ok=True)
    
    ghp_inc_dir = gh_pages_dir/"_includes"
    ghp_inc_dir.mkdir(parents=True, exist_ok=True)

    shutil.copy2(root_dir/"CHANGELOG.md", gh_pages_dir/"_includes"/"CHANGELOG.md")

if __name__ == '__main__':
    cur_dir = Path(__file__).parent.absolute()
    root_dir = cur_dir.parent
    gh_pages_dir = root_dir/"gh-pages"

    parser = argparse.ArgumentParser(description='Update GitHub Pages content')
    parser.add_argument('--gh_pages_dir', default=gh_pages_dir)

    args = parser.parse_args()

    call_wrapper.final_call_decorator(
        "Updating GitHub Pages content",
        "Updating GitHub Pages content: success",
        "Updating GitHub Pages content: failure!"
    )(
        update
    )(
        gh_pages_dir
    )


================================================
FILE: workspaces/foo_spotify.sln
================================================

Microsoft Visual Studio Solution File, Format Version 12.00
# Visual Studio Version 16
VisualStudioVersion = 16.0.30225.117
MinimumVisualStudioVersion = 10.0.40219.1
Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "foo_spotify", "..\foo_spotify\foo_spotify.vcxproj", "{FB107A12-DEFC-4782-97FB-EC155B13550C}"
EndProject
Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "foobar2000_SDK", "..\submodules\foobar2000\SDK\foobar2000_SDK.vcxproj", "{E8091321-D79D-4575-86EF-064EA1A4A20D}"
EndProject
Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "pfc", "..\submodules\pfc\pfc.vcxproj", "{EBFFFB4E-261D-44D3-B89C-957B31A0BF9C}"
EndProject
Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "foobar2000_component_client", "..\submodules\foobar2000\foobar2000_component_client\foobar2000_component_client.vcxproj", "{71AD2674-065B-48F5-B8B0-E1F9D3892081}"
EndProject
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{C179572D-BD48-46D8-98D9-3CD4354A1A6C}"
	ProjectSection(SolutionItems) = preProject
		..\foo_spotify\.clang-format = ..\foo_spotify\.clang-format
	EndProjectSection
EndProject
Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "fb2k_utils", "..\submodules\fb2k_utils\src\fb2k_utils.vcxproj", "{EE3BF4F9-2014-4CFF-96C8-44CFB85E0571}"
EndProject
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "docs", "docs", "{6A9AA2D7-2F76-4BD1-80EE-87E4B9DA70DB}"
	ProjectSection(SolutionItems) = preProject
		..\CHANGELOG.md = ..\CHANGELOG.md
		..\LICENSE = ..\LICENSE
		..\README.md = ..\README.md
	EndProjectSection
EndProject
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "submodules", "submodules", "{096E7B28-E3A6-4685-BA4F-F92FB4091EF2}"
EndProject
Global
	GlobalSection(SolutionConfigurationPlatforms) = preSolution
		Debug FB2K|Win32 = Debug FB2K|Win32
		Debug FB2K|x64 = Debug FB2K|x64
		Debug|Win32 = Debug|Win32
		Debug|x64 = Debug|x64
		Release FB2K|Win32 = Release FB2K|Win32
		Release FB2K|x64 = Release FB2K|x64
		Release|Win32 = Release|Win32
		Release|x64 = Release|x64
	EndGlobalSection
	GlobalSection(ProjectConfigurationPlatforms) = postSolution
		{FB107A12-DEFC-4782-97FB-EC155B13550C}.Debug FB2K|Win32.ActiveCfg = Debug|Win32
		{FB107A12-DEFC-4782-97FB-EC155B13550C}.Debug FB2K|Win32.Build.0 = Debug|Win32
		{FB107A12-DEFC-4782-97FB-EC155B13550C}.Debug FB2K|x64.ActiveCfg = Release|Win32
		{FB107A12-DEFC-4782-97FB-EC155B13550C}.Debug FB2K|x64.Build.0 = Release|Win32
		{FB107A12-DEFC-4782-97FB-EC155B13550C}.Debug|Win32.ActiveCfg = Debug|Win32
		{FB107A12-DEFC-4782-97FB-EC155B13550C}.Debug|Win32.Build.0 = Debug|Win32
		{FB107A12-DEFC-4782-97FB-EC155B13550C}.Debug|x64.ActiveCfg = Debug|Win32
		{FB107A12-DEFC-4782-97FB-EC155B13550C}.Release FB2K|Win32.ActiveCfg = Release|Win32
		{FB107A12-DEFC-4782-97FB-EC155B13550C}.Release FB2K|Win32.Build.0 = Release|Win32
		{FB107A12-DEFC-4782-97FB-EC155B13550C}.Release FB2K|x64.ActiveCfg = Release|Win32
		{FB107A12-DEFC-4782-97FB-EC155B13550C}.Release FB2K|x64.Build.0 = Release|Win32
		{FB107A12-DEFC-4782-97FB-EC155B13550C}.Release|Win32.ActiveCfg = Release|Win32
		{FB107A12-DEFC-4782-97FB-EC155B13550C}.Release|Win32.Build.0 = Release|Win32
		{FB107A12-DEFC-4782-97FB-EC155B13550C}.Release|x64.ActiveCfg = Release|Win32
		{E8091321-D79D-4575-86EF-064EA1A4A20D}.Debug FB2K|Win32.ActiveCfg = Debug|Win32
		{E8091321-D79D-4575-86EF-064EA1A4A20D}.Debug FB2K|Win32.Build.0 = Debug|Win32
		{E8091321-D79D-4575-86EF-064EA1A4A20D}.Debug FB2K|x64.ActiveCfg = Release|Win32
		{E8091321-D79D-4575-86EF-064EA1A4A20D}.Debug FB2K|x64.Build.0 = Release|Win32
		{E8091321-D79D-4575-86EF-064EA1A4A20D}.Debug|Win32.ActiveCfg = Debug|Win32
		{E8091321-D79D-4575-86EF-064EA1A4A20D}.Debug|Win32.Build.0 = Debug|Win32
		{E8091321-D79D-4575-86EF-064EA1A4A20D}.Debug|x64.ActiveCfg = Debug|Win32
		{E8091321-D79D-4575-86EF-064EA1A4A20D}.Release FB2K|Win32.ActiveCfg = Release|Win32
		{E8091321-D79D-4575-86EF-064EA1A4A20D}.Release FB2K|Win32.Build.0 = Release|Win32
		{E8091321-D79D-4575-86EF-064EA1A4A20D}.Release FB2K|x64.ActiveCfg = Release|Win32
		{E8091321-D79D-4575-86EF-064EA1A4A20D}.Release FB2K|x64.Build.0 = Release|Win32
		{E8091321-D79D-4575-86EF-064EA1A4A20D}.Release|Win32.ActiveCfg = Release|Win32
		{E8091321-D79D-4575-86EF-064EA1A4A20D}.Release|Win32.Build.0 = Release|Win32
		{E8091321-D79D-4575-86EF-064EA1A4A20D}.Release|x64.ActiveCfg = Release|Win32
		{EBFFFB4E-261D-44D3-B89C-957B31A0BF9C}.Debug FB2K|Win32.ActiveCfg = Debug FB2K|Win32
		{EBFFFB4E-261D-44D3-B89C-957B31A0BF9C}.Debug FB2K|Win32.Build.0 = Debug FB2K|Win32
		{EBFFFB4E-261D-44D3-B89C-957B31A0BF9C}.Debug FB2K|x64.ActiveCfg = Debug FB2K|x64
		{EBFFFB4E-261D-44D3-B89C-957B31A0BF9C}.Debug FB2K|x64.Build.0 = Debug FB2K|x64
		{EBFFFB4E-261D-44D3-B89C-957B31A0BF9C}.Debug|Win32.ActiveCfg = Debug|Win32
		{EBFFFB4E-261D-44D3-B89C-957B31A0BF9C}.Debug|Win32.Build.0 = Debug|Win32
		{EBFFFB4E-261D-44D3-B89C-957B31A0BF9C}.Debug|x64.ActiveCfg = Debug|x64
		{EBFFFB4E-261D-44D3-B89C-957B31A0BF9C}.Debug|x64.Build.0 = Debug|x64
		{EBFFFB4E-261D-44D3-B89C-957B31A0BF9C}.Release FB2K|Win32.ActiveCfg = Release FB2K|Win32
		{EBFFFB4E-261D-44D3-B89C-957B31A0BF9C}.Release FB2K|Win32.Build.0 = Release FB2K|Win32
		{EBFFFB4E-261D-44D3-B89C-957B31A0BF9C}.Release FB2K|x64.ActiveCfg = Release FB2K|x64
		{EBFFFB4E-261D-44D3-B89C-957B31A0BF9C}.Release FB2K|x64.Build.0 = Release FB2K|x64
		{EBFFFB4E-261D-44D3-B89C-957B31A0BF9C}.Release|Win32.ActiveCfg = Release|Win32
		{EBFFFB4E-261D-44D3-B89C-957B31A0BF9C}.Release|Win32.Build.0 = Release|Win32
		{EBFFFB4E-261D-44D3-B89C-957B31A0BF9C}.Release|x64.ActiveCfg = Release|x64
		{EBFFFB4E-261D-44D3-B89C-957B31A0BF9C}.Release|x64.Build.0 = Release|x64
		{71AD2674-065B-48F5-B8B0-E1F9D3892081}.Debug FB2K|Win32.ActiveCfg = Debug|Win32
		{71AD2674-065B-48F5-B8B0-E1F9D3892081}.Debug FB2K|Win32.Build.0 = Debug|Win32
		{71AD2674-065B-48F5-B8B0-E1F9D3892081}.Debug FB2K|x64.ActiveCfg = Release|Win32
		{71AD2674-065B-48F5-B8B0-E1F9D3892081}.Debug FB2K|x64.Build.0 = Release|Win32
		{71AD2674-065B-48F5-B8B0-E1F9D3892081}.Debug|Win32.ActiveCfg = Debug|Win32
		{71AD2674-065B-48F5-B8B0-E1F9D3892081}.Debug|Win32.Build.0 = Debug|Win32
		{71AD2674-065B-48F5-B8B0-E1F9D3892081}.Debug|x64.ActiveCfg = Debug|Win32
		{71AD2674-065B-48F5-B8B0-E1F9D3892081}.Release FB2K|Win32.ActiveCfg = Release|Win32
		{71AD2674-065B-48F5-B8B0-E1F9D3892081}.Release FB2K|Win32.Build.0 = Release|Win32
		{71AD2674-065B-48F5-B8B0-E1F9D3892081}.Release FB2K|x64.ActiveCfg = Release|Win32
		{71AD2674-065B-48F5-B8B0-E1F9D3892081}.Release FB2K|x64.Build.0 = Release|Win32
		{71AD2674-065B-48F5-B8B0-E1F9D3892081}.Release|Win32.ActiveCfg = Release|Win32
		{71AD2674-065B-48F5-B8B0-E1F9D3892081}.Release|Win32.Build.0 = Release|Win32
		{71AD2674-065B-48F5-B8B0-E1F9D3892081}.Release|x64.ActiveCfg = Release|Win32
		{EE3BF4F9-2014-4CFF-96C8-44CFB85E0571}.Debug FB2K|Win32.ActiveCfg = Debug|Win32
		{EE3BF4F9-2014-4CFF-96C8-44CFB85E0571}.Debug FB2K|Win32.Build.0 = Debug|Win32
		{EE3BF4F9-2014-4CFF-96C8-44CFB85E0571}.Debug FB2K|x64.ActiveCfg = Release|Win32
		{EE3BF4F9-2014-4CFF-96C8-44CFB85E0571}.Debug FB2K|x64.Build.0 = Release|Win32
		{EE3BF4F9-2014-4CFF-96C8-44CFB85E0571}.Debug|Win32.ActiveCfg = Debug|Win32
		{EE3BF4F9-2014-4CFF-96C8-44CFB85E0571}.Debug|Win32.Build.0 = Debug|Win32
		{EE3BF4F9-2014-4CFF-96C8-44CFB85E0571}.Debug|x64.ActiveCfg = Debug|Win32
		{EE3BF4F9-2014-4CFF-96C8-44CFB85E0571}.Release FB2K|Win32.ActiveCfg = Release|Win32
		{EE3BF4F9-2014-4CFF-96C8-44CFB85E0571}.Release FB2K|Win32.Build.0 = Release|Win32
		{EE3BF4F9-2014-4CFF-96C8-44CFB85E0571}.Release FB2K|x64.ActiveCfg = Release|Win32
		{EE3BF4F9-2014-4CFF-96C8-44CFB85E0571}.Release FB2K|x64.Build.0 = Release|Win32
		{EE3BF4F9-2014-4CFF-96C8-44CFB85E0571}.Release|Win32.ActiveCfg = Release|Win32
		{EE3BF4F9-2014-4CFF-96C8-44CFB85E0571}.Release|Win32.Build.0 = Release|Win32
		{EE3BF4F9-2014-4CFF-96C8-44CFB85E0571}.Release|x64.ActiveCfg = Release|Win32
	EndGlobalSection
	GlobalSection(SolutionProperties) = preSolution
		HideSolutionNode = FALSE
	EndGlobalSection
	GlobalSection(NestedProjects) = preSolution
		{E8091321-D79D-4575-86EF-064EA1A4A20D} = {096E7B28-E3A6-4685-BA4F-F92FB4091EF2}
		{EBFFFB4E-261D-44D3-B89C-957B31A0BF9C} = {096E7B28-E3A6-4685-BA4F-F92FB4091EF2}
		{71AD2674-065B-48F5-B8B0-E1F9D3892081} = {096E7B28-E3A6-4685-BA4F-F92FB4091EF2}
		{EE3BF4F9-2014-4CFF-96C8-44CFB85E0571} = {096E7B28-E3A6-4685-BA4F-F92FB4091EF2}
	EndGlobalSection
	GlobalSection(ExtensibilityGlobals) = postSolution
		SolutionGuid = {869A994B-3306-4E73-A266-A14CF217581C}
	EndGlobalSection
EndGlobal