{"id":13828756,"url":"https://github.com/Lackoftactics/facebook_data_analyzer","last_synced_at":"2025-07-09T06:32:59.344Z","repository":{"id":31899026,"uuid":"128077169","full_name":"Lackoftactics/facebook_data_analyzer","owner":"Lackoftactics","description":"Analyze facebook copy of your data with ruby language. Download zip file from facebook and get info about friends ranking by message, vocabulary,  contacts, friends added statistics and more","archived":false,"fork":false,"pushed_at":"2022-05-18T22:02:09.000Z","size":173,"stargazers_count":543,"open_issues_count":10,"forks_count":53,"subscribers_count":13,"default_branch":"master","last_synced_at":"2024-08-05T09:18:23.868Z","etag":null,"topics":["conversation","data-science","data-visualization","english-language","facebook","facebook-data","facebook-data-analyzer","ruby","ruby-gem","scraping","script","statistics"],"latest_commit_sha":null,"homepage":"https://medium.com/@przemek_/i-analyzed-my-facebook-data-and-its-story-of-shyness-loneliness-and-change-7f4e0ec3a952","language":"Ruby","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/Lackoftactics.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}},"created_at":"2018-04-04T14:49:46.000Z","updated_at":"2024-03-16T07:25:28.000Z","dependencies_parsed_at":"2022-08-07T17:00:52.672Z","dependency_job_id":null,"html_url":"https://github.com/Lackoftactics/facebook_data_analyzer","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/Lackoftactics%2Ffacebook_data_analyzer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lackoftactics%2Ffacebook_data_analyzer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lackoftactics%2Ffacebook_data_analyzer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lackoftactics%2Ffacebook_data_analyzer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Lackoftactics","download_url":"https://codeload.github.com/Lackoftactics/facebook_data_analyzer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225492420,"owners_count":17482869,"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":["conversation","data-science","data-visualization","english-language","facebook","facebook-data","facebook-data-analyzer","ruby","ruby-gem","scraping","script","statistics"],"created_at":"2024-08-04T09:03:06.855Z","updated_at":"2024-11-20T08:31:05.324Z","avatar_url":"https://github.com/Lackoftactics.png","language":"Ruby","readme":"[![CircleCI](https://circleci.com/gh/Lackoftactics/facebook_data_analyzer.svg?style=svg)](https://circleci.com/gh/Lackoftactics/facebook_data_analyzer)\n# facebook_data_analyzer\n\n\nFacebook data analyzer as seen on [I analyzed my facebook data and it's story of shyness, loneliness, and change](https://medium.com/@przemek_/i-analyzed-my-facebook-data-and-its-story-of-shyness-loneliness-and-change-7f4e0ec3a952)\n\nAnalyze Facebook copy of your data. Download zip file from Facebook and get info about friends, ranking by message, vocabulary, contacts, friends added statistics and more.\n\n# What's inside\n\n* Ranking of friends by messages (number of messages sent, who sent more, how many words, characters in conversation)\n* Your most used words in conversations, the most frequent words from English language and also Polish (my native language) are deleted. So you get quite good and interesting results.\n* Your overall statistics of messaging: total number of messages, words, characters, unique words.\n* How many messages were sent by period: month, week, year, hour. So you can easily get what type of writer you are: night owl vs. early bird. Find your most busy messaging days.\n* How your history of making friends looked like? Breakdown by month, year, weekend vs. working day, most busy days, weeks and months.\n\n# How to run\n\n**Remember you need to use english language(US) on facebook for download**\n\n It won't work if you use different language because of date formatting, different titles on pages. This script uses `nokogiri` internally to parse data.\n\n1. Go to settings on Facebook and switch to English language(US), you can later go back to your native langauge.\n2. From Facebook settings, request copy of your data.\n3. You should get an email back in about 30 minutes.\n4. Download the zip file from the link provided in email.\n5. Extract the file and then get path to catalog with copy of your data. In my case it was: `/Users/przemyslawmroczek/Downloads/facebook-przemekmroczek90/`.\n6. Clone this repository with script.\n7. You need to install `ruby`, `gem bundler`, `gem nokogiri`, `gem axlsx`. There are extensive tutorials in the web how to do it and it's beyond this readme.\n8. Go to folder where you cloned `facebook_data_analyzer`.\n9. Run `bin/facebook_data_analyzer -c path_to_catalog_with_copy_of_facebook_data` in my case this command looked like: `bin/facebook_data_analyzer -c /Users/przemyslawmroczek/Downloads/facebook-przemekmroczek90/`\n10. You will see the script running and analyzing your conversations. At the end you will see it generated new excel file `facebook_analysis.xlsx`, and html file `facebook_analysis.html`.\n\nOptional:\nIf the `DEBUG` environment variable is present, messages are getting converted as json for speed improvement.\n\n```bash\nbin/facebook_data_analyzer -v -c \u003cpath_to_catalog_with_copy_of_facebook_data\u003e\n\nParsing Messages    |Time: 00:00:01 | =======| Time: 00:00:01\nAnalyzing Messages  |Time: 00:00:04 | =======| Time: 00:00:04\n= Export facebook_analysis.xlsx\n= Export facebook_analysis.html\n```\n\n## Minimal Command\n```bash\nbin/facebook_data_analyzer -c \u003cpath_to_catalog_with_copy_of_facebook_data\u003e\n```\n\n## Available Options\n```bash\nbin/facebook_data_analyzer --help\n```\n\n```bash\nFacebookDataAnalyzer\n    -c example/facebook-monaleigh,   set directory to facebook export\n        --catalog\n    -f, --filename facebook_analysis set the name of the generated files\n    -p, --[no-]parallel              use parallel processing if set\n    -h, --[no-]html                  export html when set\n    -v, --[no-]verbose               when set displays additional information\n    -b, --[no-]benchmark             only runs the benchmark if set\n        --help                       Show this message\n    -V, --version                    Print version\n```\n\n## Default values\n```bash\ncatalog         default: 'example/facebook-monaleigh'\nfilename        default: 'facebook_analysis'\nparallel        default: true\nhtml            default: true\nverbose         default: false\nbenchmark       default: false\n```\n\n# Contributing\n\nPlease consider running your changes with\n```bash\nbin/facebook_data_analyzer --benchmark\n```\nbefore making a pull request. Changes that significantly slow this project may be rejected\n\n## Development\n\nAfter checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.\n\nTo install this gem onto your local machine, run `bundle exec rake install`.\n\n## Testing\n\nRun rspec tests with: `bundle install`, `rspec .`.\n\n**Enjoy!**\n","funding_links":[],"categories":["Ruby"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLackoftactics%2Ffacebook_data_analyzer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FLackoftactics%2Ffacebook_data_analyzer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLackoftactics%2Ffacebook_data_analyzer/lists"}