{"id":18507773,"url":"https://github.com/clubgamma/random-meme-generator-app","last_synced_at":"2025-04-09T03:31:26.194Z","repository":{"id":46209037,"uuid":"410586412","full_name":"clubgamma/Random-Meme-Generator-App","owner":"clubgamma","description":"An android app in which users can watch random funny meme images.","archived":false,"fork":false,"pushed_at":"2021-12-03T07:51:20.000Z","size":5427,"stargazers_count":4,"open_issues_count":2,"forks_count":18,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-03-23T22:37:59.552Z","etag":null,"topics":["android","hacktoberfest","java","meme","open-source","xml"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/clubgamma.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-09-26T15:17:27.000Z","updated_at":"2024-05-09T06:48:45.000Z","dependencies_parsed_at":"2022-09-08T06:02:45.674Z","dependency_job_id":null,"html_url":"https://github.com/clubgamma/Random-Meme-Generator-App","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clubgamma%2FRandom-Meme-Generator-App","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clubgamma%2FRandom-Meme-Generator-App/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clubgamma%2FRandom-Meme-Generator-App/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clubgamma%2FRandom-Meme-Generator-App/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/clubgamma","download_url":"https://codeload.github.com/clubgamma/Random-Meme-Generator-App/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247973593,"owners_count":21026699,"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":["android","hacktoberfest","java","meme","open-source","xml"],"created_at":"2024-11-06T15:12:24.191Z","updated_at":"2025-04-09T03:31:25.622Z","avatar_url":"https://github.com/clubgamma.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Random Meme Genrator app\n\nWe all love watching and sharing memes using this app user can \nwatch random memes and share memes with others.\n\n\u003cdiv align = \"center\"\u003e\n\u003cimg src = \"https://c.tenor.com/sL_CTFI38L8AAAAM/dance-seinfeld.gif\"\u003e\n  \n\u003c/div\u003e\n\n\u003cdiv align = \"center\"\u003e\n\u003cimg src = \"https://meme-api-python.herokuapp.com/static/img/bg.gif\"\u003e\n  \n\u003c/div\u003e\n\nYou can download the app from this [link!](https://drive.google.com/file/d/18QSuXShcd9MgqTbkRwpiE4ei0GZ_gtfJ/view?usp=sharing)\n\n## Features\n\n- Random meme image generation\n- Fullscreen meme image view\n- Share memes with others\n\n  \n## Tech Stack\n\n- Java\n- XML\n- Third party libraries such as Retrofit and Glide are allowed.\n\n\n## App screenshots\n\n\u003cdiv\u003e\n    \u003cimg src=\"appScreenshots/0.jpg\" width=\"150\" height=\"300\"\u003e\n    \u003cimg src=\"appScreenshots/1.jpg\" width=\"150\" height=\"300\"\u003e\n    \u003cimg src=\"appScreenshots/2.jpg\" width=\"150\" height=\"300\"\u003e\n    \u003cimg src=\"appScreenshots/3.jpg\" width=\"150\" height=\"300\"\u003e\n    \u003cimg src=\"appScreenshots/4.jpg\" width=\"150\" height=\"300\"\u003e\n    \u003cimg src=\"appScreenshots/5.jpg\" width=\"150\" height=\"300\"\u003e\n    \u003cimg src=\"appScreenshots/6.jpg\" width=\"150\" height=\"300\"\u003e\n  \n\u003c/div\u003e\n  \n## API Reference\n\nJSON API for a random meme scraped from reddit.\n\nAPI Link : [https://meme-api.herokuapp.com/gimme](https://meme-api.herokuapp.com/gimme)\n\n**Example Response:**\n\n```jsonc\n{\n  \"postLink\": \"https://redd.it/jiovfz\",\n  \"subreddit\": \"dankmemes\",\n  \"title\": \"*leaves call*\",\n  \"url\": \"https://i.redd.it/f7ibqp1dmiv51.gif\",\n  \"nsfw\": false,\n  \"spoiler\": false,\n  \"author\": \"Spartan-Yeet\",\n  \"ups\": 3363,\n\n  // preview images of the meme sorted from lowest to highest quality\n  \"preview\": [\n    \"https://preview.redd.it/f7ibqp1dmiv51.gif?width=108\u0026crop=smart\u0026format=png8\u0026s=02b12609100c14f55c31fe046f413a9415804d62\",\n    \"https://preview.redd.it/f7ibqp1dmiv51.gif?width=216\u0026crop=smart\u0026format=png8\u0026s=8da35457641a045e88e42a25eca64c14a6759f82\",\n    \"https://preview.redd.it/f7ibqp1dmiv51.gif?width=320\u0026crop=smart\u0026format=png8\u0026s=f2250b007b8252c7063b8580c2aa72c5741766ae\",\n    \"https://preview.redd.it/f7ibqp1dmiv51.gif?width=640\u0026crop=smart\u0026format=png8\u0026s=6cd99df5e58c976bc115bd080a1e6afdbd0d71e7\"\n  ]\n}\n```\n\n### Custom Endpoints\n\n#### Specify count (MAX 50)\n\nIn order to get multiple memes in a single request specify the count with the following endpoint.\n\nEndpoint: [/gimme/{count}](https://meme-api.herokuapp.com/gimme/2)\n\nExample: [https://meme-api.herokuapp.com/gimme/2](https://meme-api.herokuapp.com/gimme/2)\n\nResponse:\n\n```jsonc\n{\n  \"count\": 2,\n  \"memes\": [\n    {\n      \"postLink\": \"https://redd.it/jictqq\",\n      \"subreddit\": \"dankmemes\",\n      \"title\": \"Say sike\",\n      \"url\": \"https://i.redd.it/j6wu6o9ncfv51.gif\",\n      \"nsfw\": false,\n      \"spoiler\": false,\n      \"author\": \"n1GG99\",\n      \"ups\": 72823,\n      \"preview\": [\n        \"https://preview.redd.it/j6wu6o9ncfv51.gif?width=108\u0026crop=smart\u0026format=png8\u0026s=3b110a4d83a383b7bfebaf09ea60d89619cddfb3\",\n        \"https://preview.redd.it/j6wu6o9ncfv51.gif?width=216\u0026crop=smart\u0026format=png8\u0026s=ba5808992b3245a6518dfe759cbe4af24e042f2d\",\n        \"https://preview.redd.it/j6wu6o9ncfv51.gif?width=320\u0026crop=smart\u0026format=png8\u0026s=7567bb64e639223e3603236f774eeca149551313\"\n      ]\n    },\n    {\n      \"postLink\": \"https://redd.it/jilgdw\",\n      \"subreddit\": \"dankmemes\",\n      \"title\": \"I forgot how hard it is to think of a title\",\n      \"url\": \"https://i.redd.it/jk12rq8nrhv51.jpg\",\n      \"nsfw\": false,\n      \"spoiler\": false,\n      \"author\": \"TheRealKyJoe01\",\n      \"ups\": 659,\n      \"preview\": [\n        \"https://preview.redd.it/jk12rq8nrhv51.jpg?width=108\u0026crop=smart\u0026auto=webp\u0026s=d5d3fe588ccff889e61fca527c2358e429845b80\",\n        \"https://preview.redd.it/jk12rq8nrhv51.jpg?width=216\u0026crop=smart\u0026auto=webp\u0026s=b560b78301afd8c173f8c702fbd791214c1d7f61\",\n        \"https://preview.redd.it/jk12rq8nrhv51.jpg?width=320\u0026crop=smart\u0026auto=webp\u0026s=3cd427240b2185a3691a818774214fd2a0de124d\",\n        \"https://preview.redd.it/jk12rq8nrhv51.jpg?width=640\u0026crop=smart\u0026auto=webp\u0026s=1142cc19a746b8b5d8335679d1d36127f4a677b9\"\n      ]\n    }\n  ]\n}\n```\n\n#### Specify Subreddit\n\nBy default the API grabs a random meme from '_memes_', '_dankmemes_', '_me_irl_' subreddits. To provide your own custom subreddit use the following endpoint.\n\nEndpoint: [/gimme/{subreddit}](https://meme-api.herokuapp.com/gimme/wholesomememes)\n\nExample: [https://meme-api.herokuapp.com/gimme/wholesomememes](https://meme-api.herokuapp.com/gimme/wholesomememes)\n\nResponse:\n\n```json\n{\n  \"postLink\": \"https://redd.it/jhr5lf\",\n  \"subreddit\": \"wholesomememes\",\n  \"title\": \"Every time I visit\",\n  \"url\": \"https://i.redd.it/hsyyeb87v7v51.jpg\",\n  \"nsfw\": false,\n  \"spoiler\": false,\n  \"author\": \"pak_choy\",\n  \"ups\": 1660,\n  \"preview\": [\n    \"https://preview.redd.it/hsyyeb87v7v51.jpg?width=108\u0026crop=smart\u0026auto=webp\u0026s=b76ddb91f212b2e304cad2cd9c5b71a6ddca832c\",\n    \"https://preview.redd.it/hsyyeb87v7v51.jpg?width=216\u0026crop=smart\u0026auto=webp\u0026s=2bd0b104fd0825afc15d9faa7977c6801e6dae0b\",\n    \"https://preview.redd.it/hsyyeb87v7v51.jpg?width=320\u0026crop=smart\u0026auto=webp\u0026s=7625c69e144c9cb187dd0be88f541918aca5cedd\",\n    \"https://preview.redd.it/hsyyeb87v7v51.jpg?width=640\u0026crop=smart\u0026auto=webp\u0026s=e933f956e01d62810e68f12ed8b26a8178ecbb0f\"\n  ]\n}\n```\n\n#### Specify Subreddit Count (MAX 50)\n\nIn order to get a custom number of memes from a specific subreddit provide the name of the subreddit and the count in the following endpoint.\n\nEndpoint: [/gimme/{subreddit}/{count}](https://meme-api.herokuapp.com/gimme/wholesomememes/2)\n\nExample: [https://meme-api.herokuapp.com/gimme/wholesomememes/2](https://meme-api.herokuapp.com/gimme/wholesomememes/2)\n\nResponse:\n\n```json\n{\n  \"count\": 2,\n  \"memes\": [\n    {\n      \"postLink\": \"https://redd.it/ji1riw\",\n      \"subreddit\": \"wholesomememes\",\n      \"title\": \"It makes me feel good.\",\n      \"url\": \"https://i.redd.it/xuzd77yl8bv51.png\",\n      \"nsfw\": false,\n      \"spoiler\": false,\n      \"author\": \"polyesterairpods\",\n      \"ups\": 306,\n      \"preview\": [\n        \"https://preview.redd.it/xuzd77yl8bv51.png?width=108\u0026crop=smart\u0026auto=webp\u0026s=9a0376741fbda988ceeb7d96fdec3982f102313e\",\n        \"https://preview.redd.it/xuzd77yl8bv51.png?width=216\u0026crop=smart\u0026auto=webp\u0026s=ee2f287bf3f215da9c1cd88c865692b91512476d\",\n        \"https://preview.redd.it/xuzd77yl8bv51.png?width=320\u0026crop=smart\u0026auto=webp\u0026s=88850d9155d51f568fdb0ad527c94d556cd8bd70\",\n        \"https://preview.redd.it/xuzd77yl8bv51.png?width=640\u0026crop=smart\u0026auto=webp\u0026s=b7418b023b2f09cdc189a55ff1c57d531028bc3e\"\n      ]\n    },\n    {\n      \"postLink\": \"https://redd.it/jibifc\",\n      \"subreddit\": \"wholesomememes\",\n      \"title\": \"It really feels like that\",\n      \"url\": \"https://i.redd.it/vvpbl29prev51.jpg\",\n      \"nsfw\": false,\n      \"spoiler\": false,\n      \"author\": \"lolthebest\",\n      \"ups\": 188,\n      \"preview\": [\n        \"https://preview.redd.it/vvpbl29prev51.jpg?width=108\u0026crop=smart\u0026auto=webp\u0026s=cf64f01dfaca5f41c2e87651e4b0e321e28fa47c\",\n        \"https://preview.redd.it/vvpbl29prev51.jpg?width=216\u0026crop=smart\u0026auto=webp\u0026s=33acdf7ed7d943e1438039aa71fe9295ee2ff5a0\",\n        \"https://preview.redd.it/vvpbl29prev51.jpg?width=320\u0026crop=smart\u0026auto=webp\u0026s=6a0497b998bd9364cdb97876aa54c147089270da\",\n        \"https://preview.redd.it/vvpbl29prev51.jpg?width=640\u0026crop=smart\u0026auto=webp\u0026s=e68fbe686e92acb5977bcfc24dd57febd552afaf\",\n        \"https://preview.redd.it/vvpbl29prev51.jpg?width=960\u0026crop=smart\u0026auto=webp\u0026s=1ba690cfe8d49480fdd55c6daee6f2692e9292e7\",\n        \"https://preview.redd.it/vvpbl29prev51.jpg?width=1080\u0026crop=smart\u0026auto=webp\u0026s=44852004dba921a17ee4ade108980baab242805e\"\n      ]\n    }\n  ]\n}\n```\n\n\n  ## Building\n\n#### With Gradle\n\nThis project requires the [Android SDK](http://developer.android.com/sdk/index.html)\nto be installed in your development environment. In addition you'll need to set\nthe `ANDROID_HOME` environment variable to the location of your SDK. For example:\n\n    export ANDROID_HOME=/home/\u003cuser\u003e/tools/android-sdk\n\nAfter satisfying those requirements, the build is pretty simple:\n\n* Run `./gradlew build installDevelopmentDebug` from the within the project folder.\nIt will build the project for you and install it to the connected Android device or running emulator.\n\nThe app is configured to allow you to install a development and production version in parallel on your device.\n\n#### With Android Studio\nThe easiest way to build is to install Android Studio\nwith Gradle([Installation video](https://www.youtube.com/watch?v=0zx_eFyHRU0\u0026t=8s)).\n \nOnce installed, then you can import the project into Android Studio:\n\n1. Open `File`\n2. Import Project\n3. Select `build.gradle` under the project directory\n4. Click `OK`\n\nThen, Gradle will do everything for you.\n## Contributing\n\nContributions are always welcome!\n\nSee [CONTRIBUTING.md](https://github.com/clubgamma/Random-Meme-Generator-App/blob/main/CONTRIBUTING.md) for ways to get started.\n\nPlease adhere to this project's [Code of Conduct](https://github.com/clubgamma/code-of-conduct).\n\n  \n## Things to keep in mind\n\n- **Before creating any Pull Request, please register yourself at [Hacktoberfest's Official Website](https://hacktoberfest.digitalocean.com/)**\n- **If a maintainer reports behavior that’s not in line with the project’s code of conduct, then you will be ineligible to participate.**\n- **To get Digital Ocean swags, you just have to make minimum 4 PRs to any open source projects on GitHub**\n- **If a maintainer reports your pull request as spam, it will not be counted towards your participation in Hacktoberfest.**\n\n  \n## Contact us\n\n**To know more about us, visit [official website](https://clubgamma.github.io/) of Club Gamma.**\n\n**To know more about how Club Gamma is going to celebrate Hacktoberfest, click [here](https://clubgamma.github.io/hacktoberfest2021/)**\n\n\u003cbr\u003e\n\n\u003cdiv align = \"center\"\u003e\n\u003cimg src = \"https://c.tenor.com/iBFCLOOUxn8AAAAC/phoebe-buffay-friends.gif\"\u003e\n\u003c/div\u003e\n\n\n\u003cdiv align=\"center\"\u003e  \n\u003ci\u003eIf you want to add any feature or if you found a bug, feel free to open an issue\u003c/i\u003e\u003cbr\u003e\u003cbr\u003e\n\n![](https://img.shields.io/badge/Star-If_Liked-%23FF0000.svg?\u0026style=flat\u0026logoColor=white\u0026color=white)\n![](https://img.shields.io/badge/Fork-If_you_found_interesting-%23FF0000.svg?\u0026style=flat\u0026logoColor=white\u0026color=white)\u003cbr\u003e\n\u003ca \u003e\u003cimg src=\"https://img.shields.io/badge/Query-Ask_Us_Anything-blue\"/\u003e\u003c/a\u003e\u003cbr\u003e\n\u003cbr\u003e\n\n\u003c/div\u003e\n\n  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclubgamma%2Frandom-meme-generator-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fclubgamma%2Frandom-meme-generator-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclubgamma%2Frandom-meme-generator-app/lists"}