https://github.com/qyful/awcmaster

Easy-to-use, graphical solution for Audio Wave Container (AWC) creation for GTA 5 native audio
https://github.com/qyful/awcmaster

audio ffmpeg fivem gta5 py python

Last synced: 8 days ago
JSON representation

Easy-to-use, graphical solution for Audio Wave Container (AWC) creation for GTA 5 native audio

• Host: GitHub
• URL: https://github.com/qyful/awcmaster
• Owner: qyful
• License: gpl-3.0
• Created: 2024-08-17T10:08:19.000Z (6 months ago)
• Default Branch: main
• Last Pushed: 2024-09-02T17:00:22.000Z (5 months ago)
• Last Synced: 2025-01-18T06:43:27.505Z (14 days ago)
• Topics: audio, ffmpeg, fivem, gta5, py, python
• Language: Python
• Homepage:
• Size: 33.6 MB
• Stars: 11
• Watchers: 1
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
![alt text](gh_banner.png)

# AWCMaster

![GitHub License](https://img.shields.io/github/license/qyful/AWCMaster)

![GitHub commit activity](https://img.shields.io/github/commit-activity/w/qyful/awcmaster)

[![Version](https://img.shields.io/github/v/release/qyful/awcmaster)](https://github.com/qyful/awcmaster/releases)

[![Issues](https://img.shields.io/github/issues/qyful/awcmaster)](https://github.com/qyful/awcmaster/issues)

[![Forks](https://img.shields.io/github/forks/qyful/awcmaster)](https://github.com/qyful/awcmaster/network/members)

[![Stars](https://img.shields.io/github/stars/qyful/awcmaster)](https://github.com/qyful/awcmaster/stargazers)

[![Discord](https://dcbadge.limes.pink/api/server/https://discord.gg/pYSYtYWwbF?style=flat)](https://discord.gg/yefSA3uzDz)

## Overview

**AWCMaster** is an open-source GUI-based tool designed to help you create and edit native audio files for Grand Theft Auto V and FiveM. With an easy-to-use interface and powerful features, this tool simplifies the process of customizing audio for your scripts and mods.

## Dependencies

To use AWCMaster, you must first download [Codewalker](https://www.gta5-mods.com/tools/codewalker-gtav-interactive-3d-map) to import the XML files generated by the program.

## Usage

**Install the latest Windows release** from [here](https://github.com/qyful/AWCMaster/releases/) or download the source files:

```console

$ git clone https://github.com/qyful/AWCMaster.git

```

Then, navigate to the newly-created folder:

```console

$ cd AWCMaster/src

```

and run the `main.py` file:

```console

$ python main.py

```

**Then you're ready!** There are some more advanced features such as flags, however the defaults are more than enough to get started creating your own native sounds for GTA V.

## Contribution Guidelines

We welcome contributions from the community! To ensure a smooth collaboration process, please follow these guidelines:

1. **Fork the repository** and create your branch from `main`.

2. **Open an issue** before working on significant changes to discuss your ideas.

3. **Commit messages** should be descriptive. Follow the convention of using the present tense, e.g., "Add feature" or "Fix bug."

4. **Submit a pull request** after making your changes. Make sure to reference any related issues in your PR.

5. **Ensure the code adheres to the [PEP 8 guidelines](https://peps.python.org/pep-0008/)** before submitting your PR.

6. **Respect the community** and the work of others. Collaboration is key!

## License

This project is licensed under the GPLv3 License. See the [LICENSE](https://github.com/qyful/AWCMaster/blob/main/LICENSE)

## Contact

For any questions or feedback, feel free to [open an issue](https://github.com/qyful/awcmaster/issues) or reach out directly via [this discord](https://discord.gg/pYSYtYWwbF).

---

*This project is not affiliated with or endorsed by Rockstar Games, Grand Theft Auto V, FiveM, or CFX.re.*