Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/erengy/anitomy
Anime video filename parser
https://github.com/erengy/anitomy
anime
Last synced: 5 days ago
JSON representation
Anime video filename parser
- Host: GitHub
- URL: https://github.com/erengy/anitomy
- Owner: erengy
- License: mpl-2.0
- Created: 2014-05-18T17:16:19.000Z (over 10 years ago)
- Default Branch: develop
- Last Pushed: 2024-10-14T15:46:37.000Z (2 months ago)
- Last Synced: 2024-12-03T18:32:44.778Z (19 days ago)
- Topics: anime
- Language: C++
- Homepage:
- Size: 462 KB
- Stars: 279
- Watchers: 22
- Forks: 21
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Anitomy
[](https://github.com/erengy/anitomy/blob/master/LICENSE)
[](https://github.com/sponsors/erengy)
Anitomy is a C++ library and a command-line tool for parsing anime video filenames.
> [!IMPORTANT]
> The library is currently being rewritten in the `develop` branch. The documentation below may be out of date.
## Example
[TaigaSubs]_Toradora!_(2008)_-_01v2_-_Tiger_and_Dragon_[1080p_H.264_FLAC][BAD7A16A].mkv
Element|Value
:------|:----
Release group|`TaigaSubs`
Title|`Toradora!`
Year|`2008`
Episode|`01`
Release version|`2`
Episode title|`Tiger and Dragon`
Video resolution|`1080p`
Video term|`H.264`
Audio term|`FLAC`
File checksum|`BAD7A16A`
File extension|`mkv`
## Usage
### Library
Requires a compiler that supports [C++23](https://en.cppreference.com/w/cpp/compiler_support). Currently only tested with the latest version of MSVC.
```cpp
#include
#include
int main() {
auto elements = anitomy::parse("[Ouroboros] Fullmetal Alchemist Brotherhood - 01");
for (auto [kind, value, _] : elements) {
std::println("{:<16}{}", kind, value);
}
return 0;
}
```
```
release_group Ouroboros
title Fullmetal Alchemist Brotherhood
episode 01
```
### CLI
Use `--help` to see available options.
```bash
anitomy --format=json --pretty "[Ouroboros] Fullmetal Alchemist Brotherhood - 01"
```
```json
{
"episode": "01",
"release_group": "Ouroboros",
"title": "Fullmetal Alchemist Brotherhood"
}
```
## FAQ
> **How does it work?**
Anitomy makes some educated guesses on how filenames are formed. In more technical terms, the input is split into a sequence of tokens, and the tokens are inspected for various keywords and patterns to extract the elements.
> **What should I do if a filename is not being parsed correctly?**
Please report the issue, though it may not be possible to resolve a terribly ambiguous naming scheme.
> **Can I use it for other media such as movies or TV series?**
It should work to some extent, but the library is mostly optimized for anime.
> **Can I use it on Unicode filenames?**
Yes, just make sure your input is UTF-8 encoded and preferably in composed form.
> **Can I use it in another programming language?**
See [other repositories](https://github.com/search?q=anitomy&type=repositories) for related projects.
## Migration
### v2.0 *(WIP)*
- Building the library now requires a compiler with C++23 support.
- The library is now located inside the `include` directory and used with `#include `.
- Library internals (anything not mentioned below) are moved to `anitomy::detail` namespace.
- The library now uses UTF-8 encoded `std::string`. You no longer need to convert from/to `std::wstring`.
- Removed `anitomy::Anitomy` class. You can use the free `anitomy::parse` function instead.
- Removed `allowed_delimiters` and `ignored_strings` options.
- Removed `anitomy::Elements` class. Parser now returns `std::vector` instead.
- `ElementCategory` enum is replaced with `ElementKind` enum class.
- Parsed elements are now ordered according to their position in the input.
## License
Anitomy is licensed under [Mozilla Public License 2.0](https://www.mozilla.org/en-US/MPL/2.0/FAQ/).