1
0
mirror of https://github.com/tiyn/wiki.git synced 2026-07-26 04:21:34 +02:00

QMapShack: Added Manual/Automatic Routing; Fixed Error

This commit is contained in:
2026-07-16 00:20:25 +02:00
parent 99083a2c02
commit b3009233d8
2 changed files with 47 additions and 37 deletions

View File

@@ -6,23 +6,23 @@ depending on your needs.
This entry describes how to handle audio data.
Music and Audiobooks can be obtained by buying the digital files or by
[extracting them off of a CD](#extract-audio-files-from-cds).
Podcasts need a so called Podcatcher.
A Podcatcher is used to subscribe to podcasts and download them automatically.
Podcasts need a podcast client.
A podcast client is used to subscribe to podcasts and download them automatically.
For Linux specific music software navigate to the corresponding
[wiki entry](/wiki/linux/audio.md).
[wiki entry](/wiki/linux/audio_%28linux%29.md).
For voice based communication, social platforms or messengers navigate to the
[communication article](/wiki/communication.md) and the corresponding
[section](/wiki/communication.md#social-platforms-messengers-and-voip-services).
For headphones navigate to the [headphones article](/wiki/headphones.md):
And for headphones navigate to the [headphones article](/wiki/headphones.md):
## Speech Recognition and Synthesis
[Speech recognition and synthesis](/wiki/speech_recognition_and_synthesis.md) describe processes to
understand and convert spoken language to text aswell as the reverse process.
understand and convert spoken language to text as well as the reverse process.
## Technical Specifications
This section aswell as its subsections address all technical things about audio, like connections,
This section as well as its subsections address all technical things about audio, like connections,
cables and devices.
The most frequently used audio formats are also addressed.
@@ -30,13 +30,13 @@ The most frequently used audio formats are also addressed.
Unbalanced audio uses a wire for the positive signal for audio transmission and one for ground.
This is the most frequently used type of cable bound audio transmission.
Usually they are connected with jack connections like 3.5mm and 6.25mm.
Usually they are connected with jack connections like 3.5 mm and 6.25 mm.
Balanced audio uses one wire for the positive signal, one for negative and another one for the
ground.
Due to this extra cable a balanced connection can cancel out noise that entered the cable and
affected both the positive and the negative signal.
Balanced uses connectors like 4-pin XLR aswell as 2.5mm and 4.4mm jacks
Balanced uses connectors like 4-pin XLR as well as 2.5 mm and 4.4 mm jacks
### Audio Formats and Encoding
@@ -72,20 +72,20 @@ These can be created when the
Usually this appears together with a single file for the whole CD.
The audio file can then be split according to the `.cue` file.
For splitting of `.flac` files on a Linux system check the
[a flac (package) entry](/wiki/linux/flac_%28package%29.md#splitting-flac-file-according-to-cue-file)
for further informations.
[flac (package) entry](/wiki/linux/flac_%28package%29.md#splitting-flac-file-according-to-cue-file)
for further information.
## Media Software
If you want to keep your system clean of much data, you can use this kind of
setup.
There are differences depending on your preffered software interface.
There are differences depending on your preferred software interface.
### Import Playlist to Spotify
Importing a playlist to Spotify can be challenging.
An easy way to do it is using [Spotlistr](https://www.spotlistr.com/search/textbox) using the
Textbox function.
text box function.
A List of Songs can be input and after connecting to Spotify, it will be imported automatically.
### Digital Audio Workstations and Recording Software
@@ -101,20 +101,19 @@ produce audio files.
### Software for Music/Podcasts/Audiobooks
The following is a list of server software, that is featured in this wiki.
The corresponding client software is handled in the server softwares wiki entry.
The corresponding client software is handled in the server software wiki entry.
- [Subsonic](/wiki/subsonic.md) is a media streamer for music, podcasts and
audiobooks.
Subsonic is self-hostable.
Subsonic that can be dockerized and has a web-interface aswell as several
It is self-hostable and can be dockerized and has a web-interface as well as several
clients that can be used.
There are also the free and open-source implementations that feature all the
same features and using its API named [Airsonic](/wiki/airsonic.md) (no longer
maintained) and its inofficial successor [Airsonic-advanced](/wiki/airsonic.md).
maintained) and its unofficial successor [Airsonic-Advanced](/wiki/airsonic.md).
### Software for Podcasts
- [Podgrab](/wiki/podgrab.md) is a free and open-source podcatcher that can also be
- [Podgrab](/wiki/podgrab.md) is a free and open-source podcast client that can also be
used to listen to them.
It is self-hostable and can be dockerized.
It has a web-interface and does not feature client software.
@@ -124,7 +123,7 @@ The corresponding client software is handled in the server softwares wiki entry.
[YouTube](/wiki/youtube.md) features a wide variety of uploaded music and audiobooks.
Using programs like [yt-dl](/wiki/youtube.md#downloading-youtube-videos) they can be downloaded.
[Audible](https://www.audible.de/) is a popular service that makes sells audibooks.
[Audible](https://www.audible.de/) is a popular service that makes sells audiobooks.
After purchasing an audiobook it can be downloaded directly from Audible after navigating to the
`Library` tab and selecting `Download`.
Another option is to use [OpenAudible](/wiki/openaudible.md).
@@ -137,24 +136,24 @@ An account on any of these services or any account at all is not require
## Digitalizing and Analyzing Physical Mediums
This section focusses on physical audio mediums like CDs, their digitalization to a digital audio
This section focuses on physical audio mediums like CDs, their digitalization to a digital audio
file of [specific format](#audio-formats-and-encoding) and conversions between them.
### Detect Bad Conversions
The bitrate, format and the sample rate can be usually checked with simple
The bit rate, format and the sample rate can be usually checked with simple
tools.
For Linux a simple software solution for this is the `file` command.
Running it will display these features of a given audio file.
This will however only display the format features.
Bad convserions as described in
Bad conversions as described in
[the previous section](#audio-formats-and-encoding) can not
be detected by this.
A spectral analysis can detect bad conversions.
For this a audio analyzer like
For this an audio analyzer like
[Sonic Visualizer](https://www.sonicvisualiser.org/) is needed.
Select a audio file and press `Add Spectogram` under `Layer`.
This will display a spectogram.
Select an audio file and press `Add Spectogram` under `Layer`.
This will display a spectogramm.
Music off of a retail CD and lossless songs have frequencies that extend up to
22kHz and can extend even further for hi-res music.
If the frequency extends up to at least 22kHz the file is lossless for sure.
@@ -168,9 +167,9 @@ This way you don't have to search for your CDs all the time.
- [Exact Audio Copy](https://www.exactaudiocopy.de) for windows can rip music
and automatically tag it with the help of a list of databases.
- [fre:ac](https://freac.org/downloads-mainmenu-33) is a free cross-platform
- [The fre:ac project](https://freac.org/downloads-mainmenu-33) is a free cross-platform
audio converter and CD ripper with support for various popular formats.
- [metaflac](/wiki/linux/flac_%28package%29.md) for [Linux](/wiki/linux.md) is a program to edit
- [The metaflac package](/wiki/linux/flac_%28package%29.md) for [Linux](/wiki/linux.md) is a program to edit
the tags of [flac](/wiki/flac_%28codec%29.md) files from the command line.
It is bundled in the `flac` package for [Debian](/wiki/linux/debian.md) and arch based systems.
- [MusicBrainz Picard](/wiki/picard.md) for [Linux](/wiki/linux.md) is a graphical user interface
@@ -180,12 +179,12 @@ This way you don't have to search for your CDs all the time.
While deciding on what version of an album is the best visit
[Dynamic Range DB](https://dr.loudness-war.info).
It shows dynamic range scorings of each version.
It shows dynamic range scores of each version.
### Get Additional Data to an Album/Single
If additional information for an album is needed, visit [Discogs](https://www.discogs.com).
Discogs has tracklists, dates and more information to nearly all versions of albums and singles.
Discogs has track lists, dates and more information to nearly all versions of albums and singles.
### Naming Convention
@@ -193,14 +192,14 @@ It is suggested to place the audio files in a directory named after the album th
These album directories are placed in directories named after the album artist.
Files can be named in the following scheme.
- music: `[<discnumber>.]<tracknumber>._<artist>_-_<title>`
- audiobooks: `[<discnumber>.]<tracknumber>._<artist>_-_<album>_<tracknumber>`
- Music: `[<discnumber>.]<tracknumber>._<artist>_-_<title>`
- Audiobooks: `[<discnumber>.]<tracknumber>._<artist>_-_<album>_<tracknumber>`
### Sheet Music
Music has moved more and more into the computer realm.
An easy and intuitive software that can be used for this is [MuseScore.org](https://musescore.org/)
which features notating music aswell as a wide catalogue of available sheet music.
which features notating music as well as a wide catalog of available sheet music.
MuseScore is free and open-source and is cross-platform.
On [Linux based systems](/wiki/linux.md) it is available on most distributions via the `musescore`
package or their [website](https://musescore.org/download) and can be run with the command `mscore`.
@@ -208,7 +207,7 @@ For Windows visit the [download section of the MuseScore website](https://musesc
Another option for music notation is [LilyPond](https://lilypond.org/).
It is free software and also features
[a plugin](https://github.com/martineausimon/nvim-lilypond-suite) for [NeoVIM](/wiki/linux/vim.md).
[a plugin](https://github.com/martineausimon/nvim-lilypond-suite) for [Neovim](/wiki/linux/vim.md).
From the `.ly` files typical for LilyPond `.midi` files can automatically be generated.
These can in turn be played using [FluidSynth](https://www.fluidsynth.org/).

View File

@@ -87,3 +87,14 @@ Projects, routes and tracks can be exported as [GPX](/wiki/navigation.md#gpx).
Select the corresponding object and export it after right-clicking it as a `.gpx` file.
The resulting file can be imported into
[mobile navigation applications](/wiki/navigation.md#mobile-navigation).
### Manual and Automatic Routing
QMapShack supports both automatic and manual route creation.
These options are dependent on the [routing engine](#routing-engine).
Automatic routing follows the configured routing engine and can be enabled with `Ctrl+A` or disabled
by pressing the shortcut again.
Manual routing places route segments exactly as clicked without automatic path calculation and can
be toggled with `Ctrl+M`.
Both modes are independent and can be switched on or off at any time using their respective keyboard
shortcuts.