https://github.com/jrudio/go-plex-client
A Plex.tv and Plex Media Server Go client
https://github.com/jrudio/go-plex-client
go golang media-server plex plex-client
Last synced: 12 days ago
JSON representation
A Plex.tv and Plex Media Server Go client
- Host: GitHub
- URL: https://github.com/jrudio/go-plex-client
- Owner: jrudio
- License: apache-2.0
- Created: 2016-05-22T22:11:23.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2025-01-29T08:16:06.000Z (3 months ago)
- Last Synced: 2025-03-01T09:37:33.199Z (2 months ago)
- Topics: go, golang, media-server, plex, plex-client
- Language: Go
- Homepage:
- Size: 49.4 MB
- Stars: 135
- Watchers: 7
- Forks: 62
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-repositories - jrudio/go-plex-client - A Plex.tv and Plex Media Server Go client (Go)
README
# Plex.tv and Plex Media Server client written in Go
[](https://godoc.org/github.com/jrudio/go-plex-client)
`go get -u github.com/jrudio/go-plex-client`
### Cli
You can tinker with this library using the command-line over [here](./cmd)
### Usage
```Go
plexConnection, err := plex.New("http://192.168.1.2:32400", "myPlexToken")
// Test your connection to your Plex server
result, err := plexConnection.Test()
// Search for media in your plex server
results, err := plexConnection.Search("The Walking Dead")
// Webhook handler to easily handle events on your server
wh := plex.NewWebhook()
wh.OnPlay(func(w plex.Webhook) {
fmt.Printf("%s is playing\n", w.Metadata.Title)
})
wh.OnPause(func(w plex.Webhook) {
fmt.Printf("%s is paused\n", w.Metadata.Title)
})
wh.OnResume(func(w plex.Webhook) {
fmt.Printf("%s has resumed\n", w.Metadata.Title)
})
wh.OnStop(func(w plex.Webhook) {
fmt.Printf("%s has stopped\n", w.Metadata.Title)
})
http.HandleFunc("/", wh.Handler)
http.ListenAndServe("192.168.1.14:8080", nil)
// connect to your server via websockets to listen for events
ctrlC := make(chan os.Signal, 1)
onError := func(err error) {
fmt.Println(err)
}
events := plex.NewNotificationEvents()
events.OnPlaying(func(n NotificationContainer) {
mediaID := n.PlaySessionStateNotification[0].RatingKey
sessionID := n.PlaySessionStateNotification[0].SessionKey
var title
sessions, err := plexConnection.GetSessions()
if err != nil {
fmt.Printf("failed to fetch sessions on plex server: %v\n", err)
return
}
for _, session := range sessions.MediaContainer.Video {
if sessionID != session.SessionKey {
continue
}
userID = session.User.ID
username = session.User.Title
break
}
metadata, err := plexConnection.GetMetadata(mediaID)
if err != nil {
fmt.Printf("failed to get metadata for key %s: %v\n", mediaID, err)
} else {
title = metadata.MediaContainer.Metadata[0].Title
}
fmt.Printf("user (id: %s) has started playing %s (id: %s) %s\n", username, userID, title, mediaID)
})
plexConnection.SubscribeToNotifications(events, ctrlC, onError)
// ... and more! Please checkout plex.go for more methods
```