Hidden Voice is an Android voice chat application designed specifically for students preparing for oral exams. It allows students to practice by creating or joining study rooms where one student can speak (e.g., answering exam questions) while others listen and provide feedback in real-time. The app connects to a Python-based server to relay audio, making it a perfect tool for group study sessions. Hidden Voice is compatible with Bluetooth headsets and other audio devices for a seamless experience during practice.

• Create or join study rooms with custom names to practice for oral exams.
• Join as a Speaker to simulate answering exam questions or as a Listener to provide feedback.
• User-friendly interface with call status indicators and icons.
• End call functionality with a clear UI.
• Server-side support for multiple rooms and proper audio relay.
• Compatible with Bluetooth headsets and other audio devices for hands-free practice.

The main screen allows users to enter a room name or select from a list of existing rooms and join as either a Speaker or Listener.

Main	Room

• Android device or emulator running Android 5.0 (Lollipop) or higher.
• RECORD_AUDIO and INTERNET permissions must be granted (declared in AndroidManifest.xml).

• Python 3.6 or higher.
• A publicly accessible IP address and port (e.g., 127.0.0.1:5000 in the code).
• Port forwarding if running on a local network.

1. Clone the repository:

   git clone https://github.com/ayukistudio/HiddenVoice.git
   cd HiddenVoice

2. Run the server:

   python server.py

   • The server will start on the specified HOST and PORT (default: 127.0.0.1:5000).
   • Ensure the IP and port are accessible and match the values in the Android app.

1. Open the project in Android Studio.
2. Update the Socket connection in SpeakerActivity.java and ListenerActivity.java to use the correct server IP and port if necessary:

   socket = new Socket("127.0.0.1", 5000);

3. Build and run the app on an Android device or emulator.
4. Grant the required permissions (RECORD_AUDIO and INTERNET) when prompted.

1. Start the Server:

   • Run server.py on your server machine.
   • The server will log connections and room activity.

2. Launch the App:

   • Open the Hidden Voice app on your Android device.
   • On the main screen, enter a room name (e.g., room1) or select an existing room from the dropdown.
   • Tap "Join as Speaker" to send audio or "Join as Listener" to receive audio.

3. During a Call:

   • The Speaker or Listener screen will show the room name and connection status.
   • Tap "End Call" to disconnect and return to the main screen.

• app/src/main/java/com/shadywoof/hiddenvoice/ - Android app source code.
  • MainActivity.java - Entry point for selecting or creating rooms.
  • SpeakerActivity.java - Handles audio recording and sending.
  • ListenerActivity.java - Handles audio playback.
• app/src/main/res/layout/ - XML layouts for the app.
  • activity_main.xml - Main screen layout.
  • activity_speaker.xml - Speaker screen layout.
  • activity_listener.xml - Listener screen layout.
• server.py - Python server script for handling voice chat connections.
• img/ - Directory containing screenshots for the README.

• The app currently uses a hardcoded list of rooms in the Spinner. Future updates could fetch the list dynamically from the server.
• Only one Speaker is allowed per room. Additional Speakers will be rejected by the server.
• No mute/unmute functionality (planned for future updates).
• No call duration timer (planned for future updates).

1. Fork the repository.
2. Create a new branch (git checkout -b feature/your-feature).
3. Make your changes and commit (git commit -m "Add your feature").
4. Push to your branch (git push origin feature/your-feature).
5. Open a Pull Request.

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). See the LICENSE file for details.

• @AyukiDev