Coder Social home page Coder Social logo

michaelachmann / tidal-tales-plugin Goto Github PK

View Code? Open in Web Editor NEW

This project forked from digitalmethodsinitiative/zeeschuimer

0.0 1.0 0.0 36.53 MB

A firefox extension to collect Instagram stories while browsing.

Home Page: https://tidaltal.es

License: Other

JavaScript 98.41% HTML 1.59%
computational-social-science instagram instagram-stories social-media-analysis

tidal-tales-plugin's Introduction

๐Ÿ’พ Tidal Tales Plugin - Local-Only Real-Time Instagram Stories Capture with Firefox

DOI

A screenshot of Tidal Tales Plugin Pop Up

The Tidal Tales Plugin is a modified version of the original Zeeschuimer project designed to capture Instagram Stories. The project is based on the research and work done by Stijn Peeters for the Digital Methods Initiative.

Usage

Download the latest version of the Tidal Tales Plugin and install the extension using Firefox. Once the plugin is installed, start browsing stories. The media files and metadata are downloaded while browsing and stored in your downloads location. When done with the data collection, open the pop-up menu of our plugin and click Export as CSV to save a CSV file with all metadata in your download location. The CSV file includes the relative file locations for images and videos.

Original Zeeschuimer

The original Zeeschuimer is a browser extension that monitors internet traffic while you are browsing a social media site and collects data about the items you see in a platform's web interface for later systematic analysis. It was primarily intended for researchers who wished to systematically study content on social media platforms that resist conventional scraping or API-based data collection. To learn more about the original Zeeschuimer project, see the original GitHub repository.

Modifications for Real-Time Data Capture

We removed the 4CAT backend by instantly downloading and saving ephemeral stories (metadata, images, and videos) directly to the local disk using only Firefox. This approach ensures that researchers only store their data on their local machine, avoiding concerns about server-based data protection and removing the need for any additional software.

Future Work

This research software has been developed rapidly to meet the demands of an ongoing project, and while it may not be perfect, it effectively handles data locally using only Firefox. Since everything runs locally, there's no need for user management or additional backend services. Users are welcome to clone and modify the project to suit their own needs.

License

The Tidal Tales plugin is licensed under the Mozilla Public License Version 2.0. Refer to the LICENSE file for more information.

Credits

We acknowledges the research and development efforts by Stijn Peeters for the original Zeeschuimer project. The modifications made for implementing the real-time data capture mechanism were carried out by Michael Achmann-Denkler to support his PhD project and teaching at the University of Regensburg.

Citation

Michael Achmann-Denkler. (2024). michaelachmann/tidal-tales-plugin: First Tidal Tales Release (v2.0.0). Zenodo. https://doi.org/10.5281/zenodo.13383206

tidal-tales-plugin's People

Contributors

stijn-uva avatar michaelachmann avatar dale-wahl avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.