Skip to content

Commit 8aa52ea

Browse files
committed
updated README.md
1 parent 9175579 commit 8aa52ea

File tree

1 file changed

+152
-2
lines changed

1 file changed

+152
-2
lines changed

README.md

Lines changed: 152 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,152 @@
1-
# -frontend-sdl2-rust
2-
Rust | SDL2-based standalone application that turns your desktop audio into awesome visuals.
1+
<a id="readme-top"></a>
2+
3+
<div align="center">
4+
5+
[![Contributors][contributors-shield]][contributors-url]
6+
[![Forks][forks-shield]][forks-url]
7+
[![Stargazers][stars-shield]][stars-url]
8+
[![Issues][issues-shield]][issues-url]
9+
[![License][license-shield]][license-url]
10+
11+
<br />
12+
13+
<h3 align="center">Frontend-SDL2-Rust</h3>
14+
15+
<p align="center">
16+
Example rust app, utilizing the <a href="https://crates.io/crates/projectm-rs" target="_blank">projectm-rs</a> crate
17+
<br />
18+
<br />
19+
<a href="https://github.com/projectM-visualizer/frontend-sdl2-rust/issues" target="_blank">Report Bug</a>
20+
·
21+
<a href="https://github.com/projectM-visualizer/frontend-sdl2-rust/issues" target="_blank">Request Feature</a>
22+
</p>
23+
</div>
24+
25+
<br />
26+
27+
<!-- TABLE OF CONTENTS -->
28+
<details>
29+
<summary>Table of Contents</summary>
30+
<ol>
31+
<li>
32+
<a href="#getting-started">Getting Started</a>
33+
<ul>
34+
<li><a href="#prerequisites">Prerequisites</a></li>
35+
</ul>
36+
</li>
37+
<li><a href="#usage">Usage</a></li>
38+
<li><a href="#contributing">Contributing</a></li>
39+
<li><a href="#license">License</a></li>
40+
<li><a href="#support">Support</a></li>
41+
<li><a href="#contact">Contact</a></li>
42+
</ol>
43+
</details>
44+
45+
<br />
46+
47+
<!-- GETTING STARTED -->
48+
## Getting Started
49+
50+
To get this crate up and running properly, you'll need to install some prerequisites.
51+
52+
### Prerequisites
53+
54+
Depending on the OS/distribution and packaging system, libraries might be split into separate packages with binaries and
55+
development files. To build projectM, both binaries and development files need to be installed.
56+
57+
#### General build dependencies for all platforms:
58+
59+
* [**Rust**](https://www.rust-lang.org/tools/install)
60+
* A working build toolchain.
61+
* [**CMake**](https://cmake.org/): Used to generate platform-specific build files.
62+
* **OpenGL**: 3D graphics library. Used to render the visualizations.
63+
* or **GLES3**: OpenGL libraries for embedded systems, version 3. Required to build projectM on Android devices,
64+
Raspberry Pi, Emscripten and the Universal Windows Platform.
65+
* [**glm**](https://github.com/g-truc/glm): OpenGL Mathematics library. Optional, will use a bundled version with
66+
autotools or if not installed.
67+
* [**SDL2**](https://github.com/libsdl-org/SDL): Simple Directmedia Layer. Version 2.0.5 or higher is required to build
68+
the test UI.
69+
* [**LLVM**](https://llvm.org/): Low-Level Virtual Machine. Optional and **experimental**, used to speed up preset
70+
execution by leveraging the LLVM JIT compiler.
71+
72+
#### Only relevant for Windows:
73+
74+
* [**vcpkg**](https://github.com/microsoft/vcpkg): C++ Library Manager for Windows. _Optional_, but recommended to
75+
install the aforementioned library dependencies.
76+
* [**GLEW**](http://glew.sourceforge.net/): The OpenGL Extension Wrangler Library. Only required if using CMake to
77+
configure the build, the pre-created solutions use a bundled copy of GLEW.
78+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
79+
80+
81+
<!-- USAGE EXAMPLES -->
82+
## Usage
83+
84+
```
85+
// run app
86+
cargo run
87+
88+
// build app
89+
cargo build
90+
```
91+
92+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
93+
94+
95+
96+
<!-- CONTRIBUTING -->
97+
## Contributing
98+
99+
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
100+
101+
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
102+
Don't forget to give the project a star! Thanks again!
103+
104+
1. Fork the Project
105+
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
106+
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
107+
4. Push to the Branch (`git push origin feature/AmazingFeature`)
108+
5. Open a Pull Request
109+
110+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
111+
112+
113+
114+
<!-- LICENSE -->
115+
## License
116+
117+
Distributed under the LGPL-2.1 license. See `LICENSE` for more information.
118+
119+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
120+
121+
<!-- SUPPORT -->
122+
## Support
123+
124+
[![Discord][discord-shield]][discord-url]
125+
126+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
127+
128+
<!-- CONTACT -->
129+
## Contact
130+
131+
Blaquewithaq (Discord: SoFloppy#1289) - [@anomievision](https://twitter.com/anomievision) - [email protected]
132+
133+
<p align="right">(<a href="#readme-top">back to top</a>)</p>
134+
135+
<!-- MARKDOWN LINKS & IMAGES -->
136+
<!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->
137+
[contributors-shield]: https://img.shields.io/github/contributors/projectM-visualizer/projectm-rs.svg?style=for-the-badge
138+
[contributors-url]: https://github.com/projectM-visualizer/frontend-sdl2-rust/graphs/contributors
139+
[forks-shield]: https://img.shields.io/github/forks/projectM-visualizer/projectm-rs.svg?style=for-the-badge
140+
[forks-url]: https://github.com/projectM-visualizer/frontend-sdl2-rust/network/members
141+
[stars-shield]: https://img.shields.io/github/stars/projectM-visualizer/projectm-rs.svg?style=for-the-badge
142+
[stars-url]: https://github.com/projectM-visualizer/frontend-sdl2-rust/stargazers
143+
[issues-shield]: https://img.shields.io/github/issues/projectM-visualizer/projectm-rs.svg?style=for-the-badge
144+
[issues-url]: https://github.com/projectM-visualizer/frontend-sdl2-rust/issues
145+
[license-shield]: https://img.shields.io/github/license/projectM-visualizer/projectm-rs.svg?style=for-the-badge
146+
[license-url]: https://github.com/projectM-visualizer/frontend-sdl2-rust/blob/master/LICENSE
147+
[crates-shield]: https://img.shields.io/crates/v/projectm-rs?style=for-the-badge
148+
[crates-url]: https://crates.io/crates/projectm-rs
149+
[crates-dl-shield]: https://img.shields.io/crates/d/projectm-rs?style=for-the-badge
150+
[crates-dl-url]: https://crates.io/crates/projectm-rs
151+
[discord-shield]: https://img.shields.io/discord/737206408482914387?style=for-the-badge
152+
[discord-url]: https://discord.gg/7fQXN43n9W

0 commit comments

Comments
 (0)