voicy

README

Voicy

A simple way to play music on Discord using Golang

📚 Requirements

• Voicy only supports arikawa for now.
• You need to have ffmpeg installed on your system.

📋 Example

package main

import (
	"context"

	"github.com/ItsClairton/voicy"
	"github.com/diamondburned/arikawa/v3/discord"
	"github.com/diamondburned/arikawa/v3/gateway"
	"github.com/diamondburned/arikawa/v3/state"
	"github.com/kkdai/youtube/v2"
)

var (
	token   = "Your bot token here"
	channel = discord.ChannelID(806346482134417433) // Voice channel ID here
	client  = youtube.Client{}
)

func main() {
	session := state.NewWithIntents("Bot "+token, gateway.IntentGuilds, gateway.IntentGuildVoiceStates)
	if err := session.Open(context.Background()); err != nil {
		panic(err)
	}

	defer session.Close()

	voice, err := voicy.New(context.Background(), session, channel)
	if err != nil {
		panic(err)
	}

	video, err := client.GetVideo("https://www.youtube.com/watch?v=LNuVDtUUmd4")
	if err != nil {
		panic(err)
	}

	stream, err := client.GetStreamURL(video, &video.Formats.WithAudioChannels()[0])
	if err != nil {
		panic(err)
	}

	if err := voice.PlayURL(stream, false); err != nil {
		panic(err)
	}
}

❓ Questions or bugs?

Don't hesitate to create an issue or a PR.

Documentation

Index

• Constants
• Variables
• type Session
  • func New(context context.Context, state *state.State, ChannelID discord.ChannelID) (*Session, error)
  • func (s *Session) Destroy()
  • func (s *Session) Pause()
  • func (s *Session) PlayURL(source string, isOpus bool) error
  • func (s *Session) PlaybackPosition() time.Duration
  • func (s *Session) Resume()
  • func (s *Session) Seek(pos time.Duration)
  • func (s *Session) State() int
  • func (s *Session) Stop()

Constants

const (
	DestroyedState = iota
	StoppedState
	ChangingState
	PausedState
	PlayingState
)

Variables

var (
	ErrDestroyed      = errors.New("this session has been destroyed and can no longer be used")
	ErrAlreadyPlaying = errors.New("something is already playing")
)

Types

type Session

type Session struct {
	// contains filtered or unexported fields
}

func New

func New(context context.Context, state *state.State, ChannelID discord.ChannelID) (*Session, error)

func (*Session) Destroy

func (s *Session) Destroy()

func (*Session) Pause

func (s *Session) Pause()

func (*Session) PlayURL

func (s *Session) PlayURL(source string, isOpus bool) error

func (*Session) PlaybackPosition

func (s *Session) PlaybackPosition() time.Duration

func (*Session) Resume

func (s *Session) Resume()

func (*Session) Seek

func (s *Session) Seek(pos time.Duration)

func (*Session) State

func (s *Session) State() int

func (*Session) Stop

func (s *Session) Stop()