Metadata-Version: 2.4
Name: asmr18
Version: 0.1.5
Summary: Downloader for ASMR18.fans
Home-page: https://github.com/yosefario-dev/asmr18
Author: Yosefario Dev
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Multimedia :: Video
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.31.0
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: lxml>=4.9.0
Requires-Dist: click>=8.1.0
Requires-Dist: tqdm>=4.66.0
Requires-Dist: colorama>=0.4.6
Requires-Dist: pyyaml>=6.0
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# ASMR18 Downloader

Command-line tool for downloading audio content from ASMR18.fans with metadata extraction and chapter support.

## Installation

### Quick Install (Linux/macOS)
```bash
curl -sSL https://raw.githubusercontent.com/yosefario-dev/asmr18/main/install.sh | sh
```

### Manual Install
```bash
pip install asmr18
```

## Usage

```bash
asmr18 "https://asmr18.fans/boys/rj01439456/"
```

### Options
```bash
asmr18 URL                           # Download single work
asmr18 URL -o /path/to/output        # Custom output directory
asmr18 --batch urls.txt              # Batch download from file
asmr18 URL --template "{id} {title}" # Custom filename
asmr18 --help                        # Show all options
```

## Features

* Metadata extraction (title, voice actors, circle, scenario, illustrator, genres)
* Chapter extraction and embedding
* Filename filesystem safety
* Multiple download methods (ffmpeg or manual segments)
* Batch download support
* Resume capability for interrupted downloads
* Configuration file support (~/.asmr18/config.yaml)
* Progress tracking with ETA

## Requirements

* Python 3.8+
* ffmpeg (recommended for faster downloads)

## Configuration

Create `~/.asmr18/config.yaml`:
```yaml
output_dir: ~/Downloads/ASMR
template: "[{id}] {title}"
use_ffmpeg: true
skip_existing: true
```

## Output

Downloaded files include:
* Video file with embedded chapters
* Metadata JSON file with complete work information

## Legal

This tool is for personal use only. Users must comply with:
* ASMR18.fans terms of service
* Applicable copyright laws
* Content licensing restrictions

## License

GPL-3.0 License - See LICENSE file

## Support

For issues or questions: https://github.com/yosefario-dev/asmr18/issues
