Talk-A-Meme Bird App

A "Talking Tom" style Flutter application featuring a central Angry Bird character (Red) that listens to the user and responds with the iconic Angry Bird scream. The character visually responds when listening and animates its beak when speaking.

Step 1: Placing the Assets

Before running the application, you need to place the image and audio assets in the correct directories that were generated for you.

Images

Place the following image files into the assets/images directory in the root of the project:

• red_default.png: The default state character with a closed beak.
• red_listening.png: Upward/Curious look to indicate listening.
• red_speaking_closed.png: Identical to default, used for mouth movement.
• red_speaking_open.png: Identical to default, wide-open beak.
• app_background.png: The main background image.

Audio

Place the following audio file into the assets/audio directory:

• red_scream.mp3: A high-quality MP3 recording of the iconic Angry Bird "aaaaahehaaaan" scream sound.

Step 2: System Permissions Layout

Because this app uses the microphone to detect "listening", you must configure Android and iOS permission wrappers depending on which device you are testing with.

Android

Open android/app/src/main/AndroidManifest.xml and ensure the following permission is within the <manifest> tag, above the <application> tag:

<uses-permission android:name="android.permission.RECORD_AUDIO" />

iOS

Open ios/Runner/Info.plist and add the following key-string pair inside the main <dict> block:

<key>NSMicrophoneUsageDescription</key>
<string>This app requires microphone access to listen to you before speaking.</string>

(Note: Depending on the record package version you may also want to ensure your Podfile configuration targets a minimum iOS version of 11.0).

Step 3: Run the Application

If you haven't already, please connect your Android or iOS device to your PC or start a simulator/emulator.

1. Get Packages In the root of the project d:\talking_angry_bird, run:

   flutter pub get

2. Run the App With your target device connected, execute:

   flutter run

3. App Instructions Once the app launches on your phone/emulator:
   • Tap and hold the Mic icon at the bottom of the screen.
   • Grant the microphone permission if it prompts.
   • Watch as Red changes to his red_listening.png state.
   • Release the Mic icon. Red will play red_scream.mp3 while rapidly alternating between red_speaking_closed.png and red_speaking_open.png.

Step 4: Customizing App Identity (Name & Icon)

To change the app's display names and icon as requested:

1. Changing the App Name (Home Screen / App Drawer)

Android: Open android/app/src/main/AndroidManifest.xml and change the android:label attribute under the <application> tag:

<application
    android:label="Your New App Name"

iOS: Open ios/Runner/Info.plist and change the value under CFBundleDisplayName and CFBundleName:

<key>CFBundleDisplayName</key>
<string>Your New App Name</string>

2. Changing the Name Inside the App

There are two places to update the internal text:

1. Main Screen Title: Open lib/screens/main_screen.dart and locate Text('Talk-A-Meme Bird') around line 28. Change the text string passed there.
2. App Background Process Title: Open lib/main.dart and locate the title: 'Talk-A-Meme Bird' parameter within the MaterialApp widget.

3. Changing the App Icon

The easiest ad safest way to generate icons for both iOS and Android simultaneously is using the flutter_launcher_icons community package.

1. Add your new icon image (e.g. icon.png) to your assets/images/ folder.
2. Run this command in your terminal:

   flutter pub add dev:flutter_launcher_icons

3. Open pubspec.yaml and add the following at the very bottom of the file:

   flutter_launcher_icons:
     android: "launcher_icon"
     ios: true
     image_path: "assets/images/icon.png"

4. Finally, run the generator tool in your terminal:

   flutter pub run flutter_launcher_icons

This will automatically crop and scale your image into all the necessary App Icon sizes for both Android and iOS!