Afesta Tools#

PyPI Status Python Version License

Read the documentation at https://afesta-tools.readthedocs.io/ Tests Codecov

pre-commit Black

Library and tools for AFesta.tv

Features#

  • Login to Afesta/LPEG API and register as a new player/client

  • Re-use existing 4D Media Player installation + login credentials when available (Windows only)

  • Download Afesta videos via CLI (requires valid account and appropriate purchases/permissions)

  • Download and extract interlocking goods scripts from Afesta vcz archives (supports extracting scripts in both Vorze CSV and Funscript formats)

Requirements#

  • Python 3.8+

  • Valid Afesta account

Installation#

You can install Afesta Tools via pip from PyPI:

$ pip install afesta-tools

Usage#

Login to Afesta via CLI (not required on Windows if 4D Media Player is installed and logged into Afesta):

$ afesta login
Afesta username: username
Afesta password:

Download videos:

$ afesta dl m1234-0000 m1234-0000_1 m1234-0000_2 m1234-0000_3 ...

Download vcz archives:

$ afesta dl-vcz ABC123-Takumi-R1_sbs ABC123-Takumi-R2_sbs ABC123-Takumi-R3_sbs ...

Extract CSV scripts from vcz archives:

$ afesta extract-script ABC123-Takumi-R1_sbs.vcz ABC123-Takumi-R2_sbs.vcz ABC123-Takumi-R3_sbs.vcz ...

Extract Funscript scripts from vcz archives (for Piston only).

$ afesta extract-script --format=funscript ABC123-Takumi-R1_sbs.vcz ABC123-Takumi-R2_sbs.vcz ABC123-Takumi-R3_sbs.vcz ...

Please see the Command-line Reference for details.

Contributing#

Contributions are very welcome. To learn more, see the Contributor Guide.

License#

Distributed under the terms of the MIT license, Afesta Tools is free and open source software.

Issues#

If you encounter any problems, please file an issue along with a detailed description.

Credits#

This project was generated from @cjolowicz’s Hypermodern Python Cookiecutter template.