Skip to content

Commit e9188ee

Browse files
committed
version 24.4
2 parents 194275a + b7273d3 commit e9188ee

21 files changed

+572
-349
lines changed

docs/Changelog.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,27 @@
11
# Changelog
22

3+
## version 24.4
4+
5+
Maintenance update with some improvements and bug fixes.
6+
7+
### Added: <!-- {docsify-ignore} -->
8+
9+
+ Support for #EXTALB directive in m3u playlists (discussed in [#37](https://github.com/hvianna/audioMotion.js/issues/37#issuecomment-1732597308));
10+
+ Version control to let users know when the app has been updated (the update message should start appearing with the next version).
11+
12+
### Changed & improved: <!-- {docsify-ignore} -->
13+
14+
+ **Media panel auto-hide improvements:** fixed the scrollbar on small windows ([#54](https://github.com/hvianna/audioMotion.js/issues/54)); added a small delay before triggering; avoid changing state when mouse leaves the window;
15+
+ Song metadata is now saved to the stored playqueue and playlists;
16+
+ **Added instructions on how to install the app in the [Getting started](README.md#getting-started) section;**
17+
+ Added links to the docs website and changelog (click the version number) on the Help panel.
18+
19+
### Fixed: <!-- {docsify-ignore} -->
20+
21+
+ File explorer stalling on "Loading..." when folder was not found ([#55](https://github.com/hvianna/audioMotion.js/issues/55));
22+
+ Built-in background images not loading.
23+
24+
325
## version 24.3
426

527
📢 **audioMotion** is now an [online web app](https://audiomotion.app) that can play **music and video** directly from your device! No download necessary.

docs/README.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,11 @@ Click the button below to open the web app:
2828
<a href="https://audiomotion.app" target="_blank"><img src="https://img.shields.io/badge/audioMotion.app-ff3e37?style=flat" height="48"></a>
2929

3030
**Use a Chromium-based browser to be able to play media files from your hard drive.**<br>
31-
Works on Chrome, Opera and Edge by default. On Brave you'll need to enable this feature in `chrome://flags/#file-system-access-api`.
31+
Works on Chrome, Opera and Edge by default. On Brave, access `chrome://flags/#file-system-access-api` to enable this feature.
32+
33+
**You can install audioMotion on your PC by clicking the install icon in the browser's address bar, shown below:**
34+
35+
![browser-install](img/browser-install.png)
3236

3337
If you don't have any music files at hand, the app also includes a few songs and some online radio streams.<br>
3438
Click the [**Switch to Server**](users-manual.md#media-panel) button to browse server-hosted content.

docs/changelog.html

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
<!DOCTYPE html>
2+
<html>
3+
<head>
4+
<meta charset="utf-8">
5+
<meta http-equiv="refresh" content="0; URL=/docs/#/Changelog">
6+
</head>
7+
</html>

docs/img/browser-install.png

10.5 KB
Loading

docs/img/config-general-settings.png

-170 Bytes
Loading

docs/users-manual.md

Lines changed: 49 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,7 @@ The **File Explorer** allows you to navigate through folders and files on your d
6868
**Add from URL** | Load a remote audio file or stream from an URL
6969
**Upload file** | Play individual music files from your device. Uploaded files can't be queued or saved to playlists.<br>*(Only displayed on browsers that do not support local file access)*
7070

71-
**Double-click** a file to quickly add it to the play queue.
71+
**Double-click** a file to quickly add it to the play queue. If the player is stopped, the newly added file will start playing.
7272

7373
Hold *Ctrl* to select multiple files, or *Shift* to select a range of files, then **drag and drop** selected files into the play queue, or use the **Add selected** button.
7474

@@ -79,11 +79,11 @@ Supported file extensions are:
7979
+ for music: **flac**, **m4a**, **mp3**, **ogg** and **wav**;
8080
+ for video: **mkv**, **mpg**, **webm**, **mp4**, **avi** and **mov**;
8181
+ for images: **jpg**, **jpeg**, **webp**, **avif**, **png**, **gif** and **bmp**;
82-
+ for playlists: **m3u** and **m3u8**.
82+
+ for playlists: **m3u** and **m3u8** *(supports `#EXTINF` and `#EXTALB` directives of the [Extended M3U format](https://en.wikipedia.org/wiki/M3U#Extended_M3U)).*
8383

8484
*Actual codec support may vary depending on browser and operating system.*
8585

86-
### Using the play queue and playlists
86+
### Play queue and saved playlists
8787

8888
Double-click a queued song to play it.
8989

@@ -107,7 +107,7 @@ Select a playlist and click one of the buttons:
107107
**Load** | Load the selected playlist, **adding** its contents to the end of the current queue
108108
**Delete** | Permanently delete the selected playlist
109109

110-
!> Playlists are saved to the browser's storage and will only be accessible in the same browser they were saved.
110+
!> Saved playlists are stored in the browser's internal storage and will only be accessible in the same browser they were saved.
111111

112112
## Settings Panel
113113

@@ -240,8 +240,8 @@ Selects the analyzer background.
240240
<sup>**( 1 )**</sup> Album covers will be preferably retrieved from the file's metadata. When a picture is not found in the metadata, **audioMotion** will look for image files
241241
in the song's folder, and will pick any image which filename contains the words *cover*, *folder* or *front* (in this order), or the first image found otherwise.
242242

243-
<sup>**( 2 )**</sup> The web app includes a few built-in background images and videos. **You can select your own backgrounds folder in [Config - General settings](#general-settings).**
244-
You can also customize how many files will be directly available in the selection box, but for large amounts of files use the *Random image* and *Random video* options to randomly choose among **all** files found in the backgrounds folder.
243+
<sup>**( 2 )**</sup> The web app includes a few built-in background images and videos. **You can select your own backgrounds folder in [Config - General settings](#background-media-source).**
244+
You can also customize [how many files will be directly available](#background-media-max-items) in the selection box, but for large amounts of files use the *Random image* and *Random video* options to randomly choose among **all** files found in the backgrounds folder.
245245

246246
See also [Background Image Fit](#background-image-fit) and [Background Dim](#background-dim) settings for additional options for background images and videos.
247247

@@ -369,7 +369,7 @@ Switches toggle additional effects and alternative measurement, informational an
369369
**SCALE&nbsp;Y** | Toggle display of scale on the vertical axis (level/volume) | **LINEAR** | Switch between linear scale and decibels (logarithmic) to represent bar amplitudes
370370
**ANSI** | Switch between [ANSI/IEC preferred frequencies](https://archive.org/details/gov.law.ansi.s1.11.2004) and [equal-tempered scale](http://hyperphysics.phy-astr.gsu.edu/hbase/Music/et.html) to generate octave bands | **FPS** | Toggle display of current frame rate at the top right corner
371371
**FLAT** | Switch between outlined (on) or shadowed (off) text for messages displayed on canvas | **LO-RES** | Toggle low resolution mode *(may improve performance, especially on 4K+ displays)*
372-
**ALPHA** | Toggle variable bar transparency - the higher the bar amplitude the more opaque it is | **LUMI** | Toggle luminance bars effect - similar to ALPHA, but all analyzer bars are displayed at full-height *(no effect with RADIAL)*
372+
**ALPHA** | Toggle variable bar transparency - when active, the higher the bar amplitude the more opaque it is | **LUMI** | Toggle luminance bars effect - similar to ALPHA, but all analyzer bars are displayed at full-height *(no effect with RADIAL)*
373373
**LEDS** | Toggle LED effect for the analyzer bars *(bands modes only, no effect with RADIAL)* | **OUTLINE** | Toggle bar outline mode - see [Line width and Fill opacity](#line-width-and-fill-opacity) settings *(bands modes only)*
374374
**RADIAL** | Toggle display of circular spectrum analyzer with radial bars. **This option disables both LEDS and LUMI effects.** | **ROUND** | Toggle rounded corners at the top of analyzer bars *(bands modes only)*
375375

@@ -422,42 +422,69 @@ So if you want to randomize only among your custom presets, uncheck everything e
422422

423423
![config-general-settings](img/config-general-settings.png)
424424

425-
**Background files listed (max)** controls the maximum number of media files that can be directly selected in the [Background](#background) setting.
425+
#### Background media source
426426

427-
**Backgrounds folder location** selects the source for images and videos that can be used as [Background](#background) options, or disables external background media.
427+
Choose the source for [Background](#background) images and videos, or disable this feature.
428428

429-
Only files found in the selected folder will be loaded - subfolders are ignored.<br>
430-
Loading backgrounds from the local device requires support for the *File System Access API*, which is [currently only available on Chromium-based browsers](known-issues.md).
429+
Only files in the selected folder will be loaded - subfolders are ignored.<br>
430+
Loading backgrounds from a local folder requires support for the *File System Access API*, which is [currently only available on Chromium-based browsers](known-issues.md).
431431

432-
**FFT size** is the number of samples used for the [Fast Fourier Transform](https://en.wikipedia.org/wiki/Fast_Fourier_transform) performed by the analyzer.
432+
#### Background media max items
433+
434+
Choose the maximum number of media files that can be directly selected in the [Background](#background) setting.
435+
436+
If your backgrounds folder contains more files, the remaining ones will only be selectable via the *Random image* or *Random video* options.
437+
438+
#### FFT size
439+
440+
Number of samples used for the [Fast Fourier Transform](https://en.wikipedia.org/wiki/Fast_Fourier_transform) performed by the analyzer.
433441

434442
Higher values provide greater detail in the frequency domain (especially for low frequencies), but less detail in the time domain (slower response to changes).
435443
The default value of **8192** usually provides the best cost/benefit ratio for both domains.
436444

437-
**FFT smoothing over time** is the averaging factor used to smooth FFT data between analysis frames.
445+
#### FFT smoothing over time
446+
447+
Averaging factor used to smooth FFT data between analysis frames.
438448

439449
Lower values make the analyzer react faster to changes, and may look better with faster tempo songs and/or larger FFT sizes.
440450
Increase it if the analyzer animation looks too "jumpy".
441451

442-
**Fullscreen height (%)** adjusts the height of the analyzer when in fullscreen. This can be used to provide a wider look to the analyzer.
452+
#### Fullscreen height (%)
453+
454+
Height of the analyzer when in fullscreen. This can be used to provide a wider look to the fullscreen analyzer.
443455

444456
You can also use the **Shift** + **Up** and **Down** arrows to adjust the analyzer height during fullscreen visualization.
445457

446-
**Maximum frame rate (FPS)** controls the maximum animation frame rate, in frames per second.
447-
'Unlimited' will try to match your monitor's refresh rate, but may increase CPU usage.
458+
#### Maximum frame rate (FPS)
459+
460+
Maximum desired animation frame rate, in frames per second.
461+
462+
*'Unlimited'* will try to match your monitor's refresh rate, but may increase CPU usage.
448463

449-
**On-screen display font size** controls the font size used for information displayed on canvas.
464+
#### On-screen display font size
465+
466+
Base font size used for information displayed on canvas.
467+
468+
#### PIP window aspect ratio
469+
470+
Choose the aspect ratio of the Picture-In-Picture window.
450471

451-
**PIP window aspect ratio** selects the aspect ratio of the Picture-In-Picture window.
452472
After entering PIP, the window can be resized and the selected aspect ratio will be preserved.
453473

454-
**Auto-hide media panel on analyzer hover** automatically hides the media panel (file explorer and play queue) when you move the mouse cursor over the analyzer.
474+
#### Auto-hide media panel on analyzer hover
475+
476+
Automatically hides the [Media Panel](#media-panel) when you move the mouse cursor over the analyzer area.
477+
478+
Move the cursor to the bottom of the window, or click the [**Settings** button](#top-panel-buttons) to show the panel again.
479+
480+
#### Remember last music folder
481+
482+
Start the file explorer in the last previously used folder the next time you open audioMotion.
455483

456-
**Remember last music folder** makes the file explorer open in the last previously used folder after starting audioMotion.
484+
#### Remember play queue contents
457485

458-
**Remember play queue contents** automatically restores the contents of the play queue the next time you open audioMotion.
486+
Automatically restores the contents of the play queue the next time you open audioMotion.
459487

460-
The **Reset to defaults** button will reset all settings above to their default values.
461488

462489
### Sensitivity presets
463490

package.json

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "audioMotion",
3-
"version": "24.3.0",
3+
"version": "24.4",
44
"private": true,
55
"author": "Henrique Vianna <hvianna@gmail.com> (https://henriquevianna.com)",
66
"license": "AGPL-3.0",
@@ -18,7 +18,7 @@
1818
"devDependencies": {
1919
"audiomotion-analyzer": "^4.4.0",
2020
"buffer": "^6.0.3",
21-
"css-loader": "^6.10.0",
21+
"css-loader": "^6.11.0",
2222
"css-minimizer-webpack-plugin": "^6.0.0",
2323
"idb-keyval": "^6.2.1",
2424
"mini-css-extract-plugin": "^2.8.1",
@@ -29,11 +29,11 @@
2929
"readline-sync": "^1.4.10",
3030
"semver": "^7.6.0",
3131
"sortablejs": "^1.15.2",
32-
"webpack": "^5.90.3",
32+
"webpack": "^5.91.0",
3333
"webpack-cli": "^5.1.4"
3434
},
3535
"dependencies": {
36-
"express": "^4.18.3",
36+
"express": "^4.19.2",
3737
"serve-index": "^1.9.1"
3838
}
3939
}

public/audioMotion.js

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)