goosebumps

Description:

goosebumps

A totally not useless Flutter package for randomly playing horror-themed sounds.

Overview #
The goosebumps package provides a simple way to randomly generate horror-themed sounds in your Flutter app (very crucial stuff for your app if you ask me. Absolutely not useless🙃.). It also lets you control the frequency at which the audio clips are played and provides an option to disable the sound by shaking the device (nifty, that.😌).
Requirements #
On Android:


Include the VIBRATE permission in AndroidManifest.xml:
<uses-permission android:name="android.permission.VIBRATE"/>
copied to clipboard


Set compileSDKVersion to 33 in android\app\build.gradle.


Usage #
Import the goosebumps package:
import 'package:goosebumps/goosebumps.dart';
copied to clipboard
Initialize horror sounds generation:
Horror.init();
copied to clipboard
This initializes the horror sound generator with the default settings. The audio clips will be played at a very low frequency.
You can call Horror.init() at any point in your code for execution, be it within a function, constructor, or other places. However, if you want it initialized immediately after launching the app, call it within the main() function.
void main() {
Horror.init();
runApp(MyApp());
}
copied to clipboard
Setting The Frequency
You can customize the frequency using the Frequency class. The smaller the frequency value, the fewer times the audio clip is played. The Frequencies class provides some predefined frequency constants:

Frequencies.veryLow
Frequencies.low
Frequencies.medium
Frequencies.high
Frequencies.veryHigh

You can also pass a Frequency object to the init() method to set a custom frequency:
// That's really low by the way.
Horror.init(frequency: Frequency(milliHertz: 2));
copied to clipboard
Shake To Disable/Enable
By default, shaking the device will toggle the sound generation on or off. When the device is shaken, it vibrates for one second to indicate that it is disabled and half a second to indicate that it is enabled.
If you want to disable this feature, you can set the shakeToDisable parameter of the init() function to false:
Horror.init(shakeToDisable: false);
copied to clipboard
Camouflage API
For an even better chance at keeping the code hidden (should you want that), you can use the below API instead of Horror.init():
WidgetFlutterBinding.ensureInitialized();
copied to clipboard
It looks just like WidgetsFlutterBinding.ensureInitialized() from flutter. It even shows the same docs! And since WidgetsFlutterBinding.ensureInitialized() is already called inside Horror.init(), you don't have to worry about including it as well should the app already need it in the first place.
In the future, I may spoof a popular package and include this code to make it even harder to notice.
Contribution #
Contributions to the goosebumps package are welcome! If you find any issues, have suggestions for improvements, or would like to add new features, feel free to contribute. Here's how you can get involved:

Fork the repository on GitHub.
Create a new branch with a descriptive name for your feature or bug fix.
Make your changes and ensure that the code follows the project's style guidelines.
Write tests to cover your changes and ensure that existing tests pass.
Commit your changes and push the branch to your forked repository.
Submit a pull request to the main repository, describing your changes in detail.

Please ensure that your pull request adheres to the following guidelines:

Provide a clear and descriptive title for your pull request.
Include a detailed description of the changes you have made.
If your pull request addresses an existing issue, reference it in the description using the #issue_number format.
Ensure that your code is well-documented, follows best practices, and is properly formatted.
Include relevant tests for the changes you have made.

By contributing to the goosebumps package, you agree that your contributions will be licensed under the project's LICENSE.
Thank you for your interest in improving the goosebumps package! Your contributions are greatly appreciated.
License #
This package is licensed under the BSD-2 License. See the LICENSE file for more details.
Issues and Feedback #
Please file issues to send feedback or report a bug. Thank you!