geoxor/amethyst

A cross-platform music player made with Typescript

English | 简体中文 | Русский | Polski | Türkçe | Français

Amethyst

Amethyst is an Electron-based cross-platform audio player with a node-based audio routing system, the main goal of this project is to make a music player in TypeScript to see how far the language can be stretched to prove it's possible to provide pro-level features as most DAWs / DAEs, while also providing useful tools and customizability to the end-user.

Download

Documentation

📝 Contributing

• Use Node.js v19.1.0
• Use the recommended extensions
• Have libvips installed for linux
• Have yarn installed

⌨️ Coding

• Install dependencies with yarn
• Develop with yarn dev
• Compile with yarn package, compiled files will be in the release/build folder

amethyst's Issues

Improve settings UI with new components

Darkmode

Add a darkmode option or even better a config file where you can choose settings.

Selectable audio outputs for output node

Resizeable queue?

queue that can be resized using mouse
small enhancement
people will be able to see name of long files

or change to fit smaller names

Old icon on discord presence

Unable to Play Apple Audio Codecs + Issues with Detection of Apple Codecs

What?

Inability to Play ALAC or AIFF

It is not possible to play audio files in either ALAC or AIFF formats.

(see screenshots №1 and №3)

Detection of Apple* Audio Codecs

Amethyst does not show if the file in M4A container is ALAC, AAC or other codec.

(see screenshots №1 and №2)

Why?

If Amethyst is trying to compete with Foobar2000 and other players, I believe it should support majority of the codecs too.

Foobar2000 will play Apple Lossless files
(according to Wikipedia)

How?

One probable solution would be to use libavcodec, but I have no idea how one could use it with Electron (probably either bindings to the ffmpeg, or something like libav.js).

Screenshots

The file being opened is in ALAC format in M4A container; does not play

AAC audio file in M4A container; does play

AIFF file causes uncaught exception; does not play

Dynamically render multiple channels on DbMeter

pressing space bar does more or less than needed

pressing space while searching pauses
pressing space after minimizing and going back to the window minimizes it, applying last done thing cus it is selected

lack of loop function

maybe add a looping function that would loop selected track(s)

Rerender spectrum canvas on zoom change

Add audio waveform above/below progress bar

EXAMPLE: Rekordbox

Enhancement Idea: LAN access/control (like Spotify)

Reorderable components on playback controls

make a toggle artwork option in settings please

maybe add album to the search, might be hard to impliment

either metadata search or folder names

Missing responsive design

I get vertical scroll.

Show cover art option

All covers loaded and shown with option disabled

Preferences tab not working

Opening the preferences tab opens a blank, un-closable tab. Can only close by ending amethyst task

Add the ability to select audio channel devices / mappings

enabling/disabling any node resets all nodes' positions

Music speeds up or buggy on beggining

Music speeds up or buggy on beginning when i start song that wasn't played before
Movie1
Movie2

Vectorscope depends on volume

I am usually listening to music at low volume

Enhancement: Support for metadata in playerctl and other song status showing tools

Controlling songs with playerctl works fine, but it can't tell what track is playing
This is how it looks:

$ playerctl metadata
chromium mpris:length              205139592
chromium mpris:trackid             '/org/chromium/MediaPlayer2/TrackList/TrackA3056D73A5E9766EEAE31E9CEB2D948D'
chromium xesam:artist              
chromium xesam:title               /home/otiskujawa/Downloads/Geoxor_-_Kill_Aura.mp3

And how it works on other music players:

$ playerctl metadata
spotify mpris:trackid             /com/spotify/track/1lz2rkoZbAexSOoc75hG48
spotify mpris:length              205090000
spotify mpris:artUrl              https://i.scdn.co/image/ab67616d0000b27317cea63719c243091d319b54
spotify xesam:album               Kill Aura
spotify xesam:albumArtist         Geoxor
spotify xesam:artist              Geoxor
spotify xesam:autoRating          0.48999999999999999
spotify xesam:discNumber          1
spotify xesam:title               Kill Aura
spotify xesam:trackNumber         1
spotify xesam:url                 https://open.spotify.com/track/1lz2rkoZbAexSOoc75hG48

Why i need this:
It will allow me to add amethyst to my first arch rice :yay:

`waveformRenderWorker.ts` does not exist on production version

UI unreadable sometimes

As shown in the image, with some covers the text on the bottom right is unreadable. Windows has this readability thing in the accent color menu. You cant pick some colors there, because they would cause unreadability. Maybe something like that would help?

Make the `preferences` button open a new window at /preferences

Discord RPC Song Name Integration Is Broken

The hell?

Most of the times files display the full file path instead of file name or "artist + name" in Discord Rich Presence Integrations.

Screenshots

File №1

The displayed song name in RPC contains the full path to the file.

The Discord Rich Presence integration on the opened file	The opened file in Amethyst; all metadata is present and displayed correct

File №2

The artist name displayed in RPC is Various Artists instead of Geoxor.

The Discord Rich Presence integration on the opened file	The opened file in Amethyst; all metadata is present and displayed correct

File №3

The displayed song name in RPC contains the full path to the file.

The Discord Rich Presence integration on the opened file	The opened file in Amethyst; all metadata is present and displayed correct

File №4

Everything is fine.

The Discord Rich Presence integration on the opened file	The opened file in Amethyst; all metadata is present and displayed correct

Other Information

• App Version: v1.2.9 as of commit ada27a
• Desktop Environment: macOS 12.4

O key not usable in search bar

Something else probably hooks onto it, you cant search "joyryde", it will type "jyryde".

Metadata editor

Song Restarting Bug

Current song restarts when the it has been paused and the window has been minimized for a period of time

Stop media button starts first song

When i do playerctl stop(click stop button) amethyst starts playing first song (even if it was paused)
If first song is playing or paused, it ignores it

Unable to use media buttons to get to first and last song

System: Archlinux
Command binded to media buttons:
playerctl -p playerctld next
playerctl -p playerctld previous
Version: 1.6.8?

Song Names Are Shown Incorrectly on macOS

*at least on macOS; haven't tested on other OS, unfortunately

Description

When opening a folder (or any other file) the song name in the queue list is displaying the full path to that file on the computer, however the intended behaviour is, as far as I understand, to display filenames (with a file extension).

Screenshots

The audio file clearly has metadata tags and Amethyst shows them correctly, however the songs on the left-side bar are displaying full path to the file instead of a filename or "artist + title" name

Other Information

• App Version: v1.1.9 (as of df0711e commit) built for arm64
• Environment: macOS 12.3

Clickable high-res covers

Preferences is blank

borders near nodes element

remove this border on right or add border on left of nodes
line 98 of src/renderer/views/Home.vue

Removed:

Added on left:

Shuffling problem

when shuffling your list of songs while playing a song it shuffles but shows you are playing the song at the same index so if the song you were listening was the 5th one and you shuffle it shows you are playing whatever gets put as the 5th one even though its not.

Infinite queue scroll

Infinite scroll in the queue section.

Queue resorting makes the screen white

queue starts under the search bar and when there's one song barely visable

Add a `Check for updates` button

Figure out why the DbMeter isn't properly displaying stereo signals

As you can see its basically mono but not really

The current implementation has this line:
https://github.com/amethyst-px/amethyst/blob/master/src/renderer/components/DbMeter.vue#L47

for (let i = 0; i < sampleBuffer.length; i += CHANNELS) {
	const powerLeft = sampleBuffer[i] ** 2;
	const powerRight = sampleBuffer[i + 1] ** 2;
}

That does i + 1 to get the next bit which i assumed would be the next bit for the next channel, but apparently this just resulted into giving me 2 bars one which is 1 sample ahead of the other one

I don't understand what the skill issue is here but i hope to resolve this :forgor:

Add codec converters (ffmpeg)

Save state for volume slider on close

some songs cant play because the url generated has fucked unicode

example :
file:///G:/Soul%20Seek/complete/sTlx/Feryquitous/[2020.05.01]%20Feryquitous%20%E2%80%94%20Ideal%20%EF%BC%9A%20sub%20works%20collection%20%7Bno%20cat#}%20[WEB-FLAC]\04.%20Feryquitous%20%E2%80%94%20%E8%BB%A2%E7%9E%AC.flac

while it should be :
file:///G:/Soul%20Seek/complete/sTlx/Feryquitous/[2020.05.01]%20Feryquitous%20%E2%80%94%20Ideal%20%EF%BC%9A%20sub%20works%20collection%20%7Bno%20cat%23%7D%20[WEB-FLAC]/04.%20Feryquitous%20%E2%80%94%20%E8%BB%A2%E7%9E%AC.flac

the difference is failing to convert #} into %23%7D

button doesn't update on play/pause from system/other tools

Db meter & spectrum do not work on first song loaded

Right-click on slider to restore default value

Right-click on node slider to restore default value

or option in this menu for restoring default values

Spectrum node moves other nodes

https://cdn.discordapp.com/attachments/1018685216317001738/1034214387789086771/2022-10-24_23-18-03.mp4
yes i did little bit of speedrunning bug hunting

Does settings have scroll?

I can scroll through songs but not settings

Play audio when dragging file on top of it