Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jonthysell/musicbeeasciitools
A MusicBee plugin which provides functionality for converting text to ASCII.
https://github.com/jonthysell/musicbeeasciitools
ascii musicbee musicbee-plugin unicode
Last synced: 9 days ago
JSON representation
A MusicBee plugin which provides functionality for converting text to ASCII.
- Host: GitHub
- URL: https://github.com/jonthysell/musicbeeasciitools
- Owner: jonthysell
- License: mit
- Created: 2022-09-27T00:46:50.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2022-09-27T00:48:12.000Z (over 2 years ago)
- Last Synced: 2024-11-15T08:13:25.429Z (2 months ago)
- Topics: ascii, musicbee, musicbee-plugin, unicode
- Language: C#
- Homepage:
- Size: 301 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# ASCII Tools #
ASCII Tools is a plugin for [MusicBee](https://getmusicbee.com/) which provides functionality for converting text to ASCII.
It relies on [AnyAscii](https://github.com/anyascii/anyascii) to perform the transliteration of characters from Unicode to ASCII.
## Installation ##
1. Download the latest release zip file from https://github.com/jonthysell/MusicBeeAsciiTools/releases/latest
2. Extract the zip file
3. Make sure MusicBee is closed
4. Place the `mb_AsciiTools.dll` file into MusicBee's `Plugins` folder
5. Start MusicBee
6. Enable the plugin under `Preferences > Plugins`
## Usage ##
ASCII Tools provides a single custom function: TransliterateToAscii
This function will take any Unicode text passed to it and transliterate the text into ASCII characters. It can be used anywhere custom functions can be used, though its primary use is for (re)naming files when ripping CDs, syncing to devices, etc., where the target filesystem does not support Unicode filenames.
For example given a track with the following Unicode metadata:
* **Artist:** Israel Kamakawiwoʻole
* **Title:** Lā ʻElima
and setting the naming template to:
```
$TransliterateToAscii() - $TransliterateToAscii()
```
you would get the ASCII filename:
```
Israel Kamakawiwo`ole - La `Elima.flac
```
**Note:** The function drops spaces between multiple tags. I.e. the template:
```
$TransliterateToAscii( - )
```
will produce:
```
Israel Kamakawiwo`ole-La `Elima.flac
```
So it's best to wrap each tag you want to transliterate with its own call to the function.
## Errata ##
ASCII Tools is open-source under the MIT license.
Copyright (c) 2022 Jon Thysell
MusicBee Copyright (c) 2008-2022, Steven Mayall
AnyAscii Copyright (c) 2020-2022, Hunter WB