{"id":17403858,"url":"https://github.com/bgreenwell/rbitmoji","last_synced_at":"2025-07-24T01:06:22.700Z","repository":{"id":56937141,"uuid":"123947707","full_name":"bgreenwell/RBitmoji","owner":"bgreenwell","description":"An R wrapper to the overly complicated Bitmoji API 😱","archived":false,"fork":false,"pushed_at":"2018-11-28T15:21:31.000Z","size":4431,"stargazers_count":24,"open_issues_count":2,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-15T19:48:14.166Z","etag":null,"topics":["api","bitmoji","emoji","r"],"latest_commit_sha":null,"homepage":"","language":"R","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/bgreenwell.png","metadata":{"files":{"readme":"README.Rmd","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}},"created_at":"2018-03-05T16:33:59.000Z","updated_at":"2024-02-06T14:05:59.000Z","dependencies_parsed_at":"2022-08-21T01:10:09.866Z","dependency_job_id":null,"html_url":"https://github.com/bgreenwell/RBitmoji","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bgreenwell/RBitmoji","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bgreenwell%2FRBitmoji","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bgreenwell%2FRBitmoji/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bgreenwell%2FRBitmoji/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bgreenwell%2FRBitmoji/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bgreenwell","download_url":"https://codeload.github.com/bgreenwell/RBitmoji/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bgreenwell%2FRBitmoji/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266775383,"owners_count":23982273,"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","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["api","bitmoji","emoji","r"],"created_at":"2024-10-16T19:08:52.230Z","updated_at":"2025-07-24T01:06:22.675Z","avatar_url":"https://github.com/bgreenwell.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\noutput:\n  md_document:\n    variant: gfm\n---\n\n```{r setup, echo = FALSE}\nknitr::opts_chunk$set(\n  cache = FALSE,\n  collapse = TRUE,\n  # dev = \"svglite\",\n  comment = \"#\u003e\",\n  fig.align = \"center\",\n  fig.path = \"tools/README-\"\n)\n```\n\n# RBitmoji: An R wrapper to the overly complicated Bitmoji API \u003cimg src=\"tools/RBitmoji-logo.png\" align=\"right\" width=\"130\" height=\"150\" /\u003e\n\n[![CRAN_Status_Badge](http://www.r-pkg.org/badges/version/RBitmoji)](https://cran.r-project.org/package=RBitmoji)\n[![Travis-CI Build Status](https://travis-ci.org/bgreenwell/RBitmoji.svg?branch=master)](https://travis-ci.org/bgreenwell/RBitmoji)\n[![AppVeyor Build Status](https://ci.appveyor.com/api/projects/status/github/bgreenwell/RBitmoji?branch=master\u0026svg=true)](https://ci.appveyor.com/project/bgreenwell/RBitmoji)\n\n\nYa, this is happening...\n\n\n## Installation\n\nYou can (try to) install the development version of `RBitmoji` from GitHub using\n```{r, eval=FALSE}\nif (!requireNamespace(\"devtools\")) {\n  install.packages(\"devtools\")\n}\ndevtools::install_github(\"bgreenwell/RBitmoji\")\n```\n\n\n## Obtaining your Bitmoji ID\n\nIn order to use `RBitmoji` you will need your unique Bitmoji ID, which can be difficult to find. Fortunately, the `get_id()` function can simplify the process! TO use this function, you must supply the email address associated with your Bitmoji account. You will then be prompted to enter your Bitmoji account password using a secure blah, blah, blah. For example:\n\n```{r get_id-01, eval=FALSE}\nlibrary(RBitmoji)\nmy_id \u003c- get_id(\"greenwell.brandon@gmail.com\")\n```\n\n```{r get_my_id-02, echo=FALSE}\nlibrary(RBitmoji)\nmy_id \u003c- \"1551b314-5e8a-4477-aca2-088c05963111-v1\"\n```\n\nIf successful, your id will be stored in the variable `my_id`. Once that is done, you can use the `plot_comic()` function to do real data science.\n\n\n## Basic usage\n\nIf you are familiar with Bitmoji, then you know that there are hundreds of comics available for your avatar, each of which is associated with a comic id and a tag. As of right now, you can only look up and plot comics by tag, but in the future, we'll add an id argument as well. Also, note that many comics are associated with multiple tags and vice versa, so use `set.seed()` for reproducibility. Below are some simple examples (the value of `my_id` was found using the `get_id()` function).\n\n```{r examples, fig.width=6, fig.asp=0.618, out.width=\"70%\"}\n# Use set.seed() to generate the same comic everytime for a particular tag\nset.seed(101)  # for reproducibility\nmy_id \u003c- \"1551b314-5e8a-4477-aca2-088c05963111-v1\"\nplot_comic(my_id, tag = \"fail\")\n\n# Another example\nplot_comic(my_id, tag = \"time magazine\")\n\n# Some tags are associated with multiple comics\npar(mfrow = c(2, 2))\nfor (i in 1:4) plot_comic(my_id, tag = \"cool\")\n\n# Overlay comics on various plots\ncomic \u003c- get_comic(my_id, tag = \"volcano\", transparent = TRUE)\nlibrary(ggplot2)\nggplot(iris, aes(x = Petal.Length, y = Petal.Width)) +\n  geom_point(aes(color = Species)) +\n  annotation_raster(comic, xmin = 1, xmax = 3, ymin = 1.5, ymax = 2.5)\n\n# You have two ids, you can also plot comics with friends\nset.seed(102)  # for reproducibility\nplot_comic(c(my_id, my_id), tag = \"vomit\")\nplot_comic(c(my_id, my_id), tag = \"drink\")\n```\n\n\n## Inspirations\n\n* https://github.com/JoshCheek/bitmoji\n\n* https://github.com/matthewnau/randmoji\n\n* https://github.com/hadley/emo\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbgreenwell%2Frbitmoji","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbgreenwell%2Frbitmoji","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbgreenwell%2Frbitmoji/lists"}