{"id":26615588,"url":"https://github.com/arnobt78/facebook-statustapper--andriodapp","last_synced_at":"2025-07-19T15:07:16.281Z","repository":{"id":252231775,"uuid":"839785180","full_name":"arnobt78/Facebook-StatusTapper--AndriodApp","owner":"arnobt78","description":"StatusTapper is an R\u0026D mobile app for a client, where one can update their status on Facebook by uploading a photo in character mode that includes editable text.","archived":false,"fork":false,"pushed_at":"2025-04-12T18:09:43.000Z","size":12298,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-31T22:08:45.150Z","etag":null,"topics":["andriod-app","android-java","java","mobile-app","xml"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/arnobt78.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-08-08T10:15:24.000Z","updated_at":"2025-04-12T18:09:47.000Z","dependencies_parsed_at":"2024-08-25T17:04:20.803Z","dependency_job_id":"0b956f84-cf15-4602-a8e6-e94a45b63be6","html_url":"https://github.com/arnobt78/Facebook-StatusTapper--AndriodApp","commit_stats":null,"previous_names":["arnobt78/facebook-statustapper","arnobt78/facebook-statustapper-andriodapp","arnobt78/facebook-statustapper--andriodapp"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/arnobt78/Facebook-StatusTapper--AndriodApp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arnobt78%2FFacebook-StatusTapper--AndriodApp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arnobt78%2FFacebook-StatusTapper--AndriodApp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arnobt78%2FFacebook-StatusTapper--AndriodApp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arnobt78%2FFacebook-StatusTapper--AndriodApp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arnobt78","download_url":"https://codeload.github.com/arnobt78/Facebook-StatusTapper--AndriodApp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arnobt78%2FFacebook-StatusTapper--AndriodApp/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261945352,"owners_count":23234234,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["andriod-app","android-java","java","mobile-app","xml"],"created_at":"2025-03-24T06:11:49.408Z","updated_at":"2025-07-19T15:07:16.273Z","avatar_url":"https://github.com/arnobt78.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Facebook Status Tapper - Android App\n\n![background](https://github.com/user-attachments/assets/37b1d79c-b208-4462-a9ed-951b8a7b324e) ![check_in](https://github.com/user-attachments/assets/a4aaba33-be8a-4908-9c49-737a8196fbb9) ![boy_button](https://github.com/user-attachments/assets/321ee03b-0b7d-4349-bc8f-57b75ddc2e23) ![emb_happy](https://github.com/user-attachments/assets/8c893d2f-ca3d-4b98-b939-fdf070af7bc9) ![emb_angry](https://github.com/user-attachments/assets/9ddc77d6-d009-4e68-af09-b8a4807324ed) ![emb_bored](https://github.com/user-attachments/assets/d8efbf9e-3940-463a-8daa-b5d62eb27118) ![emb_sad](https://github.com/user-attachments/assets/18904b08-c1c4-4c07-bbf3-eb6c3aebea22) ![emb_surprised](https://github.com/user-attachments/assets/e2fe11b3-2769-4aed-b736-74ad73ef7182) ![girl_button](https://github.com/user-attachments/assets/e8ac3d66-2206-4f27-86b2-4da85b959a16) ![emg_happy](https://github.com/user-attachments/assets/2ee12612-0f57-4f48-9925-0ef5b81de23b) ![emg_angry](https://github.com/user-attachments/assets/1c0cf1ca-dd6a-4040-8ed3-6f96580e4759) ![emg_bored](https://github.com/user-attachments/assets/d8fcfcbc-978b-4fbe-a46d-c5ada96bb40c) ![emg_inlove](https://github.com/user-attachments/assets/d32a9134-6b6f-4d30-b29b-46c2f9e4b6dc) ![emg_sad](https://github.com/user-attachments/assets/59662dc0-8780-4006-ad0b-4b59a4df8368) ![laststage](https://github.com/user-attachments/assets/762e5e4d-fe3b-4d44-8562-44319b9ff2c3)\n\n---\n\n## Project Summary\n\n**Facebook-StatusTapper-AndroidApp** is a hands-on Android demo project that lets users tap their mood, snap or pick a photo, and post a custom status—complete with character overlays—directly to Facebook. Designed as a research and demonstration tool, the app showcases UI/UX, image editing, and seamless Facebook SDK integration for social sharing.\n\nThis project is ideal for:\n- Android learners exploring social media integration,\n- Developers wanting to understand user-driven status sharing,\n- Teams seeking a template for quick demo or R\u0026D Android apps.\n\n---\n\n## Table of Contents\n\n1. [Project Summary](#project-summary)\n2. [Features](#features)\n3. [Technology Stack](#technology-stack)\n4. [Project Structure](#project-structure)\n5. [How to Run / Usage Instructions](#how-to-run--usage-instructions)\n6. [Functional Walkthrough](#functional-walkthrough)\n7. [Key Components \u0026 APIs](#key-components--apis)\n8. [Learning Notes](#learning-notes)\n9. [Examples \u0026 Code Snippets](#examples--code-snippets)\n10. [Keywords](#keywords)\n11. [Contribution](#contribution)\n12. [License](#license)\n13. [Maintainer](#maintainer)\n14. [Conclusion](#conclusion)\n\n---\n\n## Features\n\n- **Facebook Status Update:** Instantly post photos and custom status messages to Facebook.\n- **Character Mode:** Choose between 'boy' or 'girl' avatars for a personalized overlay.\n- **Mood Embellishments:** Add emoji overlays (happy, angry, etc.) to express your feelings.\n- **Editable Caption:** Input and edit your own status text before posting.\n- **Intuitive UI:** Clean interface for effortless navigation and quick status sharing.\n- **Image Preview:** See exactly how your status and photo will look before posting.\n- **Demo Screenshots:** Visual walkthrough included above.\n\n---\n\n## Technology Stack\n\n- **Platform:** Android (app module)\n- **Programming Language:** Java\n- **UI Layout:** XML\n- **Build System:** Gradle\n- **Key Libraries:** Facebook Android SDK\n- **Other:** AndroidX, custom drawables, and utility classes\n\n---\n\n## Project Structure\n\n```\nFacebook-StatusTapper--AndriodApp/\n├── app/\n│   ├── src/\n│   │   ├── main/\n│   │   │   ├── java/\n│   │   │   │   └── [package_name]/\n│   │   │   │       ├── MainActivity.java\n│   │   │   │       ├── CharacterSelectionActivity.java\n│   │   │   │       └── ... (other activities, utils)\n│   │   │   ├── res/\n│   │   │   │   ├── layout/\n│   │   │   │   ├── drawable/\n│   │   │   │   └── values/\n│   │   │   └── AndroidManifest.xml\n│   └── build.gradle\n└── README.md\n```\n\n- **Activities:** Handle user interaction, navigation, and Facebook integration logic.\n- **Layouts:** XML-based UI for each screen (character picker, editor, preview, etc).\n- **Drawables:** Contains assets (buttons, avatars, emoji overlays).\n- **Utils:** Helper code for image composition and SDK handling.\n\n---\n\n## How to Run / Usage Instructions\n\n1. **Clone the Repository**\n    ```\n    git clone https://github.com/arnobt78/Facebook-StatusTapper--AndriodApp.git\n    cd Facebook-StatusTapper--AndriodApp\n    ```\n\n2. **Open in Android Studio**\n    - Start Android Studio.\n    - Choose \"Open an existing project\" and select this folder.\n\n3. **Configure Facebook SDK**\n    - Create a Facebook App via [Facebook for Developers](https://developers.facebook.com/).\n    - Add your App ID to `AndroidManifest.xml` and follow the [official SDK setup guide](https://developers.facebook.com/docs/facebook-login/android/).\n    - Set up Facebook login permissions if needed.\n\n4. **Build and Run**\n    - Connect an Android device or start an emulator.\n    - Press \"Run\" in Android Studio.\n\n5. **Using the App**\n    - Pick your avatar (boy/girl).\n    - Select your mood/emoji overlay.\n    - Take or select a photo.\n    - Write your status message.\n    - Preview, then post directly to Facebook!\n\n---\n\n## Functional Walkthrough\n\n1. **Character Selection:** Choose your avatar on the main screen.\n2. **Mood Selection:** Tap an emoji overlay to reflect your mood.\n3. **Photo Upload:** Snap a new photo or choose one from your gallery.\n4. **Text Edit:** Enter a custom status message.\n5. **Preview:** Review your composite image and status.\n6. **Facebook Post:** Tap \"Post\" to share on your Facebook timeline.\n\n---\n\n## Key Components \u0026 APIs\n\n- **MainActivity.java:** App entry point and navigation handler.\n- **CharacterSelectionActivity.java:** Lets users select their avatar.\n- **ImageEditorUtils.java:** Overlays emoji/mood icons onto photos.\n- **Facebook SDK Integration:** Handles authentication and posting.\n- **AndroidManifest.xml:** Declares permissions and SDK settings.\n\n**Key Android Concepts Used:**\n- Activities \u0026 Intents\n- Custom Views and Drawables\n- Runtime Permissions (Camera, Storage)\n- Third-Party SDK integration\n\n---\n\n## Learning Notes\n\n- **Facebook SDK Integration:** A great example of how to use third-party SDKs in an Android project.\n- **Image Composition:** Learn how to overlay graphics (emoji, characters) on user photos.\n- **Activity Navigation:** Experience managing separate flows for avatar, mood, and status editing.\n- **UI Design:** The layouts and resource files show how to make user-friendly, visually engaging apps.\n- **Permissions:** See how to request and handle runtime permissions for camera and storage.\n\n---\n\n## Examples \u0026 Code Snippets\n\n**Posting an Image to Facebook (Pseudo-Java):**\n```java\n// Setup Facebook SDK and callback\nCallbackManager callbackManager = CallbackManager.Factory.create();\nSharePhoto photo = new SharePhoto.Builder()\n    .setBitmap(composedBitmap)\n    .build();\nSharePhotoContent content = new SharePhotoContent.Builder()\n    .addPhoto(photo)\n    .build();\nShareDialog.show(this, content);\n```\n\n**Overlaying Mood Emoji (Pseudo-Java):**\n```java\nBitmap original = ... // User-selected image\nBitmap overlay = ... // Selected emoji\nCanvas canvas = new Canvas(original);\ncanvas.drawBitmap(overlay, left, top, null);\n```\n\n---\n\n## Keywords\n\nAndroid, Java, XML, Facebook SDK, Status Update, Character Mode, Mood, Emoji, Mobile App, Demo, R\u0026D\n\n---\n\n## Contribution\n\nThis project is a demo and proof-of-concept. Feedback, suggestions, and PRs are welcome! Please open an issue or submit a pull request for improvements.\n\n---\n\n## License\n\nThis project is for demonstration purposes and may include proprietary elements. Contact the owner for licensing details.\n\n---\n\n## Maintainer\n\n**[arnobt78](https://github.com/arnobt78)**\n\n*All screenshots and images above retained from the original README as requested.*\n\n---\n\n## Conclusion\n\nThis project is a great starting point for Android developers who want to explore user-driven social sharing, image composition, and third-party SDK integration. Use it to learn, experiment, or as a template for your own creative mobile projects.\n\n---\n\n## Happy Coding! 🎉\n\nThank you!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farnobt78%2Ffacebook-statustapper--andriodapp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farnobt78%2Ffacebook-statustapper--andriodapp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farnobt78%2Ffacebook-statustapper--andriodapp/lists"}