Skip to content

mihaiolteanu/vuiet

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 

Repository files navigation

Vuiet

melpa

Vuiet is a music player and explorer for Emacs users. It is similar in scope to lastfm on which it is based. All tracks are played from youtube using mpv in the background and music info taken from last.fm. Vuiet supports the "discovery mode", where it lets you create your own playlists based on artist, genre or your loved songs similarities. Or, you can specify single tracks, top tracks from a given artist, known albums, etc. There is also a lyrics database that is optionally updated with each track you play and this database can be searched interactively and played from.

Table of Contents

(Table of contents generated with markdown-toc)

Overview

Music Browser

Browse artists, genres or albums with Emacs,

(vuiet-tag-info "progressive rock")
(vuiet-album-info "steven wilson" "to the bone")
(vuiet-artist-info "steven wilson")
...

image

Music Player

Play an artist top songs, sequentially or randomly,

(vuiet-play-artist '("steven wilson"))

or tracks from similar artists, whole albums, loved tracks, or whole genres,

(vuiet-play-artist-similar '("lost in kiev"))
(vuiet-play-album "anathema" "one last goodbye")
(vuiet-play-tag-similar '("classic rock" "80s" "progressive"))
...

Play by Lyrics

Display the lyrics and search the saved lyrics database for a song to play,

(vuiet-play-track-by-lyrics "secret")

image

Other Features

  • Display the currently playing song in the mode-line,

mode-line

  • Seek forward, backward, replay, play/pause, open currently playing song on youtube (details),
(vuiet-seek-forward 15)
(vuiet-playing-track-continue-on-youtube)
...
  • Scrobble songs to your last.fm profile and add songs to your list of last.fm loved songs.

  • Search interactively for songs, artists or even albums (fill out part of the artist name -> TAB -> select the artist -> select the album -> album is now playing)

call vuiet-play-album give artist name tab for similar artists select album

Installation Requirements

  • vuiet
  • yt-dlp
  • lastfm account plus an API key (see lastfm.el README for details)
  • lastfm.el (follow the instruction on the lastfm.el README page)
  • mpv

Complete functionality

Playlists

vuiet-play songs (random nil)

Play everyting in the SONGS list, randomly or sequentially.
SONGS is a list of type ((artist1 song1) (artist2 song2) ...).

vuiet-play-artist artist random

Play the ARTIST top tracks, RANDOM or sequentially.

vuiet-play-playing-artist random

Play the currently playing artist's top tracks.

vuiet-play-playing-track-album

Play the full album of the currently playing track.

vuiet-info-playing-track-album

Open an info buffer for the currently playing track album.

vuiet-play-album artist album

Play the whole ALBUM of the given ARTIST.
If called interactively, the album can be picked interactively
from the ARTIST's top albums.

vuiet-play-artist-similar artists

Play tracks from artists similar to ARTISTS.
ARTISTS is a list of strings of the form '(artist1 artist2 etc.)
If called interactively, multiple artists can be provided in the
minibuffer if they are sepparated by commas.

vuiet-play-playing-artist-similar

Play tracks from artists similar to the playing artist.
This function is similar to `vuiet-play-artist-similar', only the
list of artists is limited to the artist of the currently playing
track.

vuiet-play-tag-similar tags

Play tracks from artists similar to TAGS.
TAGS is a list of strings of the form '(tag1 tag2 etc.)
If called interactively, multiple tags can be provided in the
minibuffer if they are sepparated by commas.

vuiet-play-playing-tags-similar

Play tracks from artists with similar tags as the current tags.
Play tracks from random artists that have tags equal to one of
the tags of the currently playing artist.

vuiet-play-track artist name

Play the song NAME from the given ARTIST.
If called interactively, let the user select and play one of the
ARTIST's top songs, where ARTIST is given in the minibuffer.

vuiet-play-track-search track

Search TRACK and play the selected item.
Similar to `vuiet-play-track', but search for TRACK on last.fm
first and then let the user select one of the results.

vuiet-play-track-by-lyrics lyrics

Search a track by LYRICS and play it.

vuiet-play-loved-track

Select a track from the user loved tracks and play it.
The user loved tracks list is the one associated with the
username given in the setup of the lastfm.el package.

vuiet-play-loved-tracks (random nil)

Play all the tracks from the user loved tracks.
If RANDOM is t, play the tracks at random, indefinitely.
The user loved tracks list is the one associated with the
username given in the setup of the lastfm.el package.

vuiet-play-artist-loved-tracks artist random

Play all the ARTIST tracks found in the user loved tracks.
Similar to `vuiet-play-loved-tracks', but play only the tracks
from the given ARTIST.

vuiet-play-recent-track

Play one of the recent listened tracks.

vuiet-play-loved-tracks-similar

Play tracks based on artists similar to loved tracks artists.
Play tracks from random artists similar to a random artist from
the list of user loved tracks.

Browser

vuiet-artist-info artist

Display info about ARTIST in a new buffer.

p   play all the artist songs, sequentially.
s   select and display info for a similar artist with ivy.
l   visit the artist's lastfm page.

vuiet-artist-info-search artist

Search ARTIST and display info about the selected item.
Similar to `vuiet-artist-info', but search for ARTIST on last.fm
first and then display the info about it.

vuiet-tag-info tag

Display info about TAG in a new buffer.

vuiet-loved-tracks-info (page 1) (n 50)

Display N tracks from the user loved tracks in a new buffer.
If the user has more than N loved tracks, PAGE can be used to show
the next PAGE * N tracks.

<enter>  On a song entry, plays that song only.
i        Display the next PAGE * N songs.
u        Display the previous PAGE * N songs, if N > 1
s        Choose a song to play, with ivy.

vuiet-album-info artist album

Display info about the ARTIST's ALBUM in a new buffer.

s   choose a song with ivy.
a   pick another album with ivy.
p   play all songs from the album.
l   save lyrics for this album.

vuiet-album-info-search artist

Search all albums from ARTIST and display the selected one.
The album is displayed in a dedicated buffer.  See
`vuiet-album-info' for details regarding the active keybindings
inside this buffer.

Player Interaction

vuiet-stop

Stop playing and clear the mode line.

vuiet-playing-artist

Return the currently playing artist.

vuiet-playing-track-name

Return the currently playing track name.

vuiet-playing-track-str

Return the playing TRACK as a human-readable string.

vuiet-next

Skip the currently playing track and play the next.

vuiet-peek-next

Display the next track in the mode-line for a few seconds.

vuiet-previous

Replay the previous track.

vuiet-replay

Play the currently playing track from the beginning.

vuiet-seek-backward (arg)

Seek backward the given number of ARG.  ARG defaults to 5 seconds.

vuiet-seek-forward (arg)

Seek forward the given number of ARG.  ARG defaults to 5 seconds.

vuiet-seek-backward-rate (arg)

Seek backward ARG% of the track.  ARG defaults to 10%.

vuiet-seek-forward-rate (arg)

Seek forward ARG% of the track.  ARG defaults to 10%.

vuiet-play-pause

Toggle the play/pause status.

vuiet-player-volume

Get the music player volume, between 0% and 100%.

vuiet-player-volume-inc (arg)

Increase the music player volume by ARG percent.  ARG defaults to 10%.

vuiet-player-volume-dec (arg)

Decrease the music player volume by ARG percent.  ARG defaults to 10%.

vuiet-playing-artist-info

Display info for the currently playing artist in a new buffer.

vuiet-playing-track-search-youtube

Open a youtube search for the currently playing track.

vuiet-playing-track-continue-on-youtube

Pause vuiet and continue playing on youtube.

vuiet-playing-track-continue-with-mpv

Pause vuiet and continue playing with mpv as a new process.

vuiet-artist-lastfm-page artist

Visit the ARTIST lastfm page."

vuiet-playing-artist-lastfm-page

Visit he currently playing artist lastfm page.

vuiet-love-track

Add the currently playing track to the user loved songs.

vuiet-unlove-track

Remove the currently playing track from the user loved songs.

vuiet-playing-track-lyrics

Display the lyrics for the currently playing track in a new buffer.
See `versuri-display' for the active keybindings inside this buffer.

vuiet-enable-automatic-lyrics

Enable saving the lyrics for all listened tracks to the db.
See `vuiet-automatic-lyrics' for details.

vuiet-disable-automatic-lyrics

Disable saving the lyrics for all listened tracks to the db.
See `vuiet-automatic-lyrics' for details.

vuiet-toggle-automatic-lyrics

Toggle saving the lyrics for all listened tracks to the db.
See `vuiet-automatic-lyrics' for details.

vuiet-update-mode-line

Update the mode line.

Customization

vuiet-scrobble-timeout 30

Time, in seconds, for the same song to play before scrobbling it.

vuiet-scrobble-enabled t

Enable/disable last.fm scrobbling.
Decide if the currently playing track should appear in your list
of recently played tracks on last.fm.

vuiet-automatic-lyrics nil

Enable/disable the saving of lyrics to the db for all tracks.
If t, download the lyrics for every listened track and save them
to db.  This is useful if you're listening to artists and tracks
you already know and like.  If nil, the lyrics are only saved
manually, on request, with the `vuiet-playing-track-lyrics'.
This is useful if you're listening to new tracks, some of which
you might not like.  Adding the lyrics of such tracks to the db
would only mean adding garbage that you can do without.

vuiet-update-mode-line-automatically t

Enable/disable the automatic update of the mode-line.
If enabled, the mode-line is automatically updated after
`vuiet-update-mode-line-interval' seconds. More specifically,
`vuiet-update-mode-line' is called periodically while a track is
playing to update it's current playback position.

vuiet-update-mode-line-interval 10

Timeout, in seconds, after which to update the mode-line.
See the `vuiet-update-mode-line-automatically' custom variable
for details.

vuiet-artist-similar-limit 15

Number of artists similar to the given artist.
When considering artists similar to a given artist, take as many
into consideration as this limit.  A lower value might mean
artists and tracks you already know and love.  A higher value
increases the chances you'll discover something totally new.

vuiet-artist-tracks-limit 15

Number of tracks for the given artist.
When considering the top tracks for a given artist, take as many
into consideration as this limit.  A lower value might mean
tracks from this artist that you already know and love.  A higher
value increases the chances you'll discover something totally new
but it also increases the chances that you'll get wrongly
scrobbled songs and youtube will find something totally unrelated
as a result.

vuiet-artist-top-albums-limit 10

Number of top albums for the given artist.
This value is also used in the artist info page (called by
`vuiet-artist-info') to display the number of top albums.

vuiet-artist-info-show-top-albums nil

Display the artist top albums in the artist info
buffer (created when calling `vuiet-artist-info'). This adds an
extra call to last.fm which, depending on your system, you might
feel it like an unnecessary lag.

vuiet-tag-artists-limit 15

Number of artists for the given tag.
When considering the top artists for a given tag, take as many
into consideration as this limit.

vuiet-loved-tracks-limit 500

Number of tracks to take into consideration when playing user loved tracks.
A number higher than your actual lastfm loved tracks, will take
all of them into consideration.  A lower values is useful for
taking into consideration only the most recently loved tracks.

vuiet-youtube-dl-command "youtube-dl"

The youtube-dl command.