You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/Changelog.md
+22Lines changed: 22 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,27 @@
1
1
# Changelog
2
2
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
+
3
25
## version 24.3
4
26
5
27
📢 **audioMotion** is now an [online web app](https://audiomotion.app) that can play **music and video** directly from your device! No download necessary.
Copy file name to clipboardExpand all lines: docs/users-manual.md
+49-22Lines changed: 49 additions & 22 deletions
Original file line number
Diff line number
Diff line change
@@ -68,7 +68,7 @@ The **File Explorer** allows you to navigate through folders and files on your d
68
68
**Add from URL** | Load a remote audio file or stream from an URL
69
69
**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)*
70
70
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.
72
72
73
73
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.
+ for music: **flac**, **m4a**, **mp3**, **ogg** and **wav**;
80
80
+ for video: **mkv**, **mpg**, **webm**, **mp4**, **avi** and **mov**;
81
81
+ 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)).*
83
83
84
84
*Actual codec support may vary depending on browser and operating system.*
85
85
86
-
### Using the play queue and playlists
86
+
### Play queue and saved playlists
87
87
88
88
Double-click a queued song to play it.
89
89
@@ -107,7 +107,7 @@ Select a playlist and click one of the buttons:
107
107
**Load** | Load the selected playlist, **adding** its contents to the end of the current queue
108
108
**Delete** | Permanently delete the selected playlist
109
109
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.
111
111
112
112
## Settings Panel
113
113
@@ -240,8 +240,8 @@ Selects the analyzer background.
240
240
<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
241
241
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.
242
242
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.
245
245
246
246
See also [Background Image Fit](#background-image-fit) and [Background Dim](#background-dim) settings for additional options for background images and videos.
247
247
@@ -369,7 +369,7 @@ Switches toggle additional effects and alternative measurement, informational an
369
369
**SCALE Y** | Toggle display of scale on the vertical axis (level/volume) | **LINEAR** | Switch between linear scale and decibels (logarithmic) to represent bar amplitudes
370
370
**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
371
371
**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)*
373
373
**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)*
374
374
**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)*
375
375
@@ -422,42 +422,69 @@ So if you want to randomize only among your custom presets, uncheck everything e
**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
426
426
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.
428
428
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).
431
431
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.
433
441
434
442
Higher values provide greater detail in the frequency domain (especially for low frequencies), but less detail in the time domain (slower response to changes).
435
443
The default value of **8192** usually provides the best cost/benefit ratio for both domains.
436
444
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.
438
448
439
449
Lower values make the analyzer react faster to changes, and may look better with faster tempo songs and/or larger FFT sizes.
440
450
Increase it if the analyzer animation looks too "jumpy".
441
451
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.
443
455
444
456
You can also use the **Shift** + **Up** and **Down** arrows to adjust the analyzer height during fullscreen visualization.
445
457
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.
448
463
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.
450
471
451
-
**PIP window aspect ratio** selects the aspect ratio of the Picture-In-Picture window.
452
472
After entering PIP, the window can be resized and the selected aspect ratio will be preserved.
453
473
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.
455
483
456
-
**Remember last music folder** makes the file explorer open in the last previously used folder after starting audioMotion.
484
+
#### Remember play queue contents
457
485
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.
459
487
460
-
The **Reset to defaults** button will reset all settings above to their default values.
0 commit comments