search

arnaud-neny / rePlayer

another multi-formats music player
Other
55 stars 4 forks source link
audio audio-player chiptune chiptune-player chiptunes demoscene emulator fasttracker imgui impulsetracker libopenmpt mp3 music music-player playlist protracker screamtracker uade vgm

readme

rePlayer (another multi-formats music player)

Getting started - The deck - The library - The song editor - The playlist - The settings - The tray icon
Web sites - Third Parties

With this piece of software, you can play a lot of oldschool music format from the old times, such as the Amiga (which was the original purpose of this player), Atari, C64, Nintendo, Sega...
But why doing that when you already have other softwares like xmplay, foobar, vlc... ? Well, nowadays, you download your music package from websites like Amiga Music Preservation, The Mod Archive, Modland... and drop your files in the software.
As a maniac collector, it started to get very annoyed to keep up to date with newer songs from an artist, check for songs duplicates, and also some missing playback functionalities.
So I started to write my own player, first to play default modules from the amiga using ImGui (for the interface), OpenMPT (to play amiga modules) and libcurl (to handle the downloads from the websites).
I've improved it in my spare time, adding more playable formats, a way to handle my database(s), some features I've always wanted in other software...

So now, it's time for me to release it as I think some people can have interest in it.
Oh, and occasionally, you can use it as a normal player as it can also play mowadays formats (mp3, wav, ogg...).

Getting started

The first time, download the lastest release, unzip it and start rePlayer.exe
The software will try to auto-update itself each time you start it, so you won't have to download it again.
If you want to play your own files, just drag and drop them into the playlist. Or if you want to download new ones in the library, just click on import and select what you want it from (songs, artist or files), then search and pick your songs, you can later drag and drop from the library to the playlist. The player works only on PC with Windows 10 (x64) and later versions, and Windows 7 and 8 (x86) available here (but doesn't support transparency, and it can be slow on this system because of the multi-threaded architecture of this player).

The deck

rePlayer's Deck

The main panel where you can see your playing song, and interact with the playback:

  1. VU meter (just a fancy visualizer).
  2. Next to it is the vertical volume bar (drag and drop the slider, or use the mouse wheel or the media keys).
  3. Song title.
  4. Artist(s).
  5. Playback informations (number of channels, playback type, player).
  6. Seek bar displaying playback time and song length (and playlist position and size). It's possible you can't interact with it if the player doesn't allow it.
  7. Classic playback buttons (go to previous song in the playlist, stop, play/pause, go to next song in the playlist, toggle the playlist or endless song loop).
  8. Menu (access to settings, enable/disable other panels, close the application...).
  9. Song metadata, click to expand/fold the deck (protracker instruments, id tags, extra informations...).

The library

This where you manage all your songs and artists you've imported (or going to import), so you have there two tabs, one for songs and the other for the artists

rePlayer's Library Songs

  1. Title bar, displaying the number of filtered songs (and selected) and some extra informations of our current state of the database.
  2. Import button: click it to import files from you disk drives or artists or songs from online websites/databases.
  3. Song tab button: the current tab button for the songs
  4. Artists tab button (see next paragraph).
  5. Tags button: filter your database from the tags you've setin your songs.
  6. Combo to select the behavior of the search filter (7): all, songs or artists.
  7. Search filter: type text their and it will filter your songs list.
  8. Song list.
  9. Rating button: the rating you set to your song, from N/A (not available aka not set) and 0 to 100%.
  10. End of playback button: to define the type end you want in your song. U means undefined (the player will detect it when it will reach the end of the song); F to fade out at the end, L to loop the song once.

Double click on a song will try to play it. If you already have a song playing from the playlist, you are not going to loose its tracking: this song is "shelved" and will resume at the end of the other song or if you go to the next one.
Middle click on a song will open the song editor with this song as editable
Right click on selected songs bring a menu:

- Invert selection
- Add to playlist
- Add to artist (shortcut to assign the song to another artist)
- Tags: you can assign the tags to the songs
- Discard: remove the song from the database
- Export as WAV
- Merge songs: open a pop up where you can "merge" the songs (to remove duplicates but keep references between each other from different sources).
  In this editor, songs are by default merged if there are identical.
  Then you can do some drag and drop to force some merge.
  Double-click on a song will cancel the merge, but Ctrl+Double click will play it.
  Press F2 to rename the latest selected song.
  Press F7/F8 to focus on previous/next set of merged songs

rePlayer's Library Artists

  1. Search filter: type text their and it will filter your artists list.
  2. Artist list.
  3. Editable Artist informations.
  4. Source list where the artist has been imported from; each time you click the import button, it will automatically fetch all songs from this sources (The main purpose of this player for me).
  5. Merge With Another Artist button: when importing from a website, it will create an artist from there. So you can have the same artist duplicated in the database. This is the way to combine these artists.

The song editor

rePlayer's Song Editor

You can edit all the properties of a song there.

For some players, you can edit the song length. For that you can simply enter the length (click on the numbers or drag and drop like a slider), or use the wave editor (E) where a wave form of the song is generated. There you can left click to set your end of song marker; you can play the generated waveform and move its cursor with the right click.

The playlist

rePlayer's Playlist

Add songs from the library here (from the library context menu, or drag and drop a selection from the library there).
Or add songs from you disk drive (drag and drop).
You can select the songs and reorder these. Click on the numbered button to track the song in its database (library/playlist).
An Url button to add a list of links to the playlist.
Buttons to load, save or clear the playlist.
And a button to sort (by type, artists, duration, type or random/shuffle). If you press Ctrl, the sort will happen only for entries after the current playing one.
Note 1: if you drag and drop files in there, the playlist will have a sidebar with buttons which open a database like the library managing all these files and urls. It's almost working the same way as the library.
Note 2: while drag and dropping files, keep Ctrl pressed to force all files in the playlist (by default, they are filtered by their extension or prefix). Keep Shift pressed and the current playlist is cleared. You can also drop on the deck.
Note 3: you can drag and drop url. On load, it will download the song or stream the online radio.

The settings

rePlayer's Settings

Enable/disable the songs focus there (when a song start to play, it is focused in the playlist and/or database).
Enable/disable the auto merge when a song is download from the library.
AutoSave frequency of the rePlayer. (it will save on quit anyway).
Enable/disable the media hot keys (for playback and volume).
Transparency of the windows (not available on the win32 release).
Live log can be enabled/disabled as well as its save on the disk. The logs retention can be changed too (older log files than the retention days limit are deleted).
You can change the global settings of each players. I will not enter into the details here, I'm too lazy (I've just enabled by default my simple surround filter because I like it).

The tray icon

There is a tray icon where you can see the playing song as a bubble info.
There is a context menu (right click), to edit the windows states:

Left click will turn on/off the Visible flag.
Middle click will turn on/off the invert States flag.

The patterns

Realtime display of the current played pattern. Options are available to show or hide some parts of the patterns. (Usefull if you want to watch the Wrecklamation from Hoffman with only the colors enabled).

Web Sites

Here are the actual web sites you can import from (and thank you for all these repositories):

You can chat about some of these on the Demozoo discord server in the modland channel.

Or add some comments (and likes) there:

Third Parties

System 3rd parties:

Replays 3rd parties:

Known issues