{"id":27949329,"url":"https://github.com/gesiscss/datadonationworkshop2025lmu","last_synced_at":"2026-07-02T20:31:38.686Z","repository":{"id":284073780,"uuid":"953735349","full_name":"gesiscss/DataDonationWorkshop2025LMU","owner":"gesiscss","description":"Data Donation Workshop 25.03 - 26.03.2025 @ IfKW, LMU Munich","archived":false,"fork":false,"pushed_at":"2025-03-25T22:53:17.000Z","size":40003,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-10-19T13:57:53.930Z","etag":null,"topics":["datadonation","whatsapp"],"latest_commit_sha":null,"homepage":"","language":"HTML","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/gesiscss.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":"2025-03-24T01:48:17.000Z","updated_at":"2025-03-28T09:41:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"d1e7508e-fa35-4c25-aad1-68665c4cd8de","html_url":"https://github.com/gesiscss/DataDonationWorkshop2025LMU","commit_stats":null,"previous_names":["gesiscss/datadonationworkshop2025lmu"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gesiscss/DataDonationWorkshop2025LMU","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gesiscss%2FDataDonationWorkshop2025LMU","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gesiscss%2FDataDonationWorkshop2025LMU/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gesiscss%2FDataDonationWorkshop2025LMU/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gesiscss%2FDataDonationWorkshop2025LMU/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gesiscss","download_url":"https://codeload.github.com/gesiscss/DataDonationWorkshop2025LMU/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gesiscss%2FDataDonationWorkshop2025LMU/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281391764,"owners_count":26492903,"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-10-28T02:00:06.022Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","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":["datadonation","whatsapp"],"created_at":"2025-05-07T15:27:00.723Z","updated_at":"2025-10-28T05:41:19.329Z","avatar_url":"https://github.com/gesiscss.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Data Donation Workshop 25.03 - 26.03.2025 @ IfKW, LMU Munich\n\nThese are the data and materials for the workshop \"Collecting and Analyzing WhatsApp Data Donations\".\nIt consists of both a presentation and some hands-on-sessions to code along.\n\nThe workshop builds both on the WhatsR R-package ([https://github.com/gesiscss/WhatsR](https://github.com/gesiscss/WhatsR)) and the ChatDashboard R-shiny webapp ([https://github.com/gesiscss/ChatDashboard](https://github.com/gesiscss/ChatDashboard)) for data donations.\n\n**Goal:**\nSemi-ineractive Walk-through of the process for **preprocessing**, **collecting**, and **analyzing** donated WhatsApp Chat Log data.\n\n## Schedule\n\n| Time             | Block                                                                    |\n|------------------|--------------------------------------------------------------------------|\n| 09:00 - 09:15    | Presentation: Overview of WhatsApp Chat Log Data                         |\n| 09:15 - 09:45    | **Code along:** Exporting \u0026 Parsing WhatsApp Chat Log Data               |\n| 09:45 - 09:55    | Presentation: Anonymization \u0026 Consent Checking                           |\n| 09:55 - 10:10    | **Code along:** Anonymization \u0026 Consent Checking                         |\n| 10:10 - 10:20    | Presentation: ChatDashboard for Data Donation Studies                    |\n| 10:20 - 10:45    | **Code along:** Installing and adapting ChatDashboard                    |\n| 10:45 - 11:00    | Discussion, Q\u0026A                                                          |\n\n\u003cbr\u003e\u003cbr\u003e\n\n# Installing System Dependencies\n\nWe will use some R-packages that rely on specific system dependencies that you might need to install manually if your are using Linux or MacOS\n\n### Windows\n\nIf you are using Windows, you should not have to install any system dependencies manually\n\n### Linux\n\nThis should be run in the Terminal, not RStudio\n\n```bash\nsudo apt-get update\nsudo apt-get install -y \\\n  libxml2-dev \\\n  libpng-dev \\\n  libsodium-dev \\\n  libcurl4-openssl-dev \\\n  libmagick++-dev \\\n  libharfbuzz-dev \\\n  libfribidi-dev \\\n  libjpeg-dev \\\n  default-jre \\\n  default-jdk \\\n  gfortran \\\n  libblas-dev \\\n  liblapack-dev \\\n  libgdal-dev\n```\n### MacOS\n\nThis should be run in the Terminal, not RStudio\n\n```bash\nbrew update\nbrew install \\\n  libxml2 \\\n  libpng \\\n  libsodium \\\n  curl \\\n  imagemagick \\\n  harfbuzz \\\n  fribidi \\\n  jpeg \\\n  gcc \\\n  openblas \\\n  lapack \\\n  gdal\n\n# Install Java (both JRE and JDK) using Homebrew Cask:\nbrew install --cask temurin\n```\n\n# Installing R Packages\n\nChatDashboard uses several additional R-packages on top of WhatsR to display data, make it interactive, and ensure encryption. Let's install these;\n\n```\n# Installing WhatsR package from GitHub\nlibrary(devtools)\ndevtools::install_github(\"gesiscss/WhatsR\")\n\n# Installing ChatDashboard Dependencies\nChatdashboard_dep \u003c- c(\"anytime\",\n                       \"crosstalk\",\n                       \"cyphr\",\n                       \"digest\",\n                       \"DT\",\n                       \"fontawesome\",\n                       \"ggplot2\",\n                       \"ggwordcloud\",\n                       \"keyring\",\n                       \"readODS\",\n                       \"rsconnect\",\n                       \"shiny\",\n                       \"shinymanager\",\n                       \"shinythemes\",\n                       \"shinyjs\",\n                       \"shinyalert\",\n                       \"shinyTime\",\n                       \"shinyWidgets\",\n                       \"slickR\",\n                       \"waiter\",\n                       \"fs\")\n                       \nChatdashboard_new \u003c- Chatdashboard_dep[!(Chatdashboard_dep %in% installed.packages()[,\"Package\"])]\nif(length(Chatdashboard_new)) install.packages(Chatdashboard_new)\n\n```\n\u003cbr\u003e\u003cbr\u003e\n\n## Whatsapp Chat Logs\n\nTo fully participate in the workshop, participants need WhatsApp chat logs to analyze. these can be obtained in different ways:\n\n### Export your own chat log\n\nWe recommend to export the chat files using the `without media` option and by sending it to a private Email address.\n\n#### Android\n\n![](./Images/DataExport_Guide_Android.png)\n\n\u003cbr\u003e\n\n#### iOS\n\n![](./Images/WhatsApp_DataExport_iOS.png)\n\n\u003cbr\u003e\u003cbr\u003e\n\n### Create a dummy chat log file\n\nParticipants can also use the WhatsR package to create a dummy chat log file themselves\n\n```\n# loading library\nlibrary(WhatsR)\n\n# checking documentation\n??create_chatlog\n\n# creating a dummy chat log\ncreate_chatlog()\n\n```\n\n### Use the Example Chat logs provided in this repo\n\nThis repository contains multiple pre-generated example chat log files that can be used as well. Participants can find them in the `data` folder.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgesiscss%2Fdatadonationworkshop2025lmu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgesiscss%2Fdatadonationworkshop2025lmu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgesiscss%2Fdatadonationworkshop2025lmu/lists"}