Skip to content

thedoggybrad/mastofetch

Repository files navigation

android-chrome-192x192_on3vfq

Mastofetch

Mastofetch is your anonymized feed retriever for the Mastodon network. This project feeds the public posts posted across the entire Mastodon network to your web browser.
Mastofetch can retrieve posts from 235 Mastodon Instances. Though, 5 posts will initially appear then the rest will load as you scroll (lazyloading) to prevent overloading the server.

mastofetch-screenshot

Try it!

Visit https://mastofetch.vercel.app to try Mastofetch today!

Terms of Service
Privacy Policy
Vision
Mission
Short History
Self-Hosting

Terms of Service for Mastofetch

Effective Date: December 25, 2025

Welcome to Mastofetch ("we," "us," or "our"). These Terms of Service ("Terms") govern your use of the Mastofetch website and services (the "Service"). By accessing or using the Service, you agree to be bound by these Terms. If you do not agree to these Terms, please refrain from using the Service.

  1. Description of Service
    Mastofetch aggregates and displays public posts (also known as "toots") from various Mastodon instances using their publicly available APIs. The content you see is fetched directly from those instances and presented in real-time or near real-time.
    This service is not owned or operated by Mastodon gGmbH, nor is it affiliated with Mastodon gGmbH in any official capacity. Instead, it is operated by TheDoggyBrad Software Labs.

  2. No User Accounts
    We do not require user registration, login, or account creation. You may browse the aggregated content anonymously.

  3. Public Content
    All posts shown via Mastofetch are public content made available by their original authors on Mastodon instances. We do not host, modify, or republish this content beyond what is necessary for display purposes.

  4. Use of the Service
    You agree to use Mastofetch for lawful purposes only and in accordance with these Terms. You may not:
    -Attempt to disrupt or overload our servers.
    -Use the Service to scrape or store large volumes of content.
    -Misrepresent the origin of the content.
    -Use the Service in a way that violates the rights of others.


  5. Intellectual Property
    All trademarks, logos, and brand names used in Mastofetch are the property of their respective owners. Mastofetch does not claim ownership over any content retrieved from third-party Mastodon instances. Additionally, Mastofetch does not claim ownership of the logos, assets, or trademarks of Mastodon or any of its affiliated services. All such trademarks and assets are the sole property of Mastodon or its respective owners.

  6. Disclaimer of Warranties
    The Service is provided "as is" and "as available" without warranties of any kind. We make no guarantees about the accuracy, reliability, or completeness of the content displayed.

  7. Limitation of Liability
    To the fullest extent permitted by law, Mastofetch and its operators shall not be liable for any indirect, incidental, special, consequential, or punitive damages resulting from your use of or inability to use the Service.

  8. Changes to the Terms
    We may update these Terms at any time. Changes will be effective immediately upon posting. Continued use of the Service constitutes your acceptance of any revised Terms.

  9. Governing Law
    These Terms are governed by and construed in accordance with the laws of your country, without regard to its conflict of laws principles.

  10. Contact
    For questions, feedback, or legal inquiries, please contact us at:
    https://github.com/thedoggybrad/mastofetch/issues

Privacy Policy for Mastofetch

Effective Date: December 25, 2025

Thank you for using Mastofetch. Your privacy is important to us. This Privacy Policy explains what data we collect, how we use it, and your rights regarding your information.

  1. Information We Collect
    We do not collect any personal data from you.
    When you use Mastofetch:
    -We do not require registration.
    -We do not track your IP address or location.
    -We do not set cookies.
    -We do not log your usage activity.

  2. Public Data from Mastodon
    Mastofetch fetches publicly available posts (toots) from various Mastodon instances via their public APIs. This data may include:
    -Public display names and usernames
    -Profile images
    -Post content and media (images/videos)
    -Timestamps of posts
    This data is publicly accessible on the respective Mastodon instances and is not stored on our servers. We display it in real-time when you access the site.

  3. No User Tracking
    We do not use:
    -Analytics (e.g., Google Analytics)
    -Tracking pixels
    -Fingerprinting techniques
    Your visit remains anonymous and we will never collect data that can identify you.

  4. Data Storage
    We do not store any data about our visitors or the fetched posts. All data is retrieved live from public sources and discarded after it is displayed.

  5. Third-Party Services
    Mastofetch accesses public APIs from Mastodon instances. These instances are independently operated, and each has its own privacy policy. You can refer to each instance’s website for more details about how they handle data.

  6. Contact
    If you have any questions or concerns about this privacy policy, please contact us at:
    https://github.com/thedoggybrad/mastofetch/issues

  7. Changes to This Policy
    We may update this Privacy Policy from time to time. Changes will be posted on this page with an updated effective date.

    By using Mastofetch, you agree to this Privacy Policy.

Vision of Mastofetch

To enhance accessibility, discoverability, and transparency in the decentralized social web, offering an ethical, seamless gateway to the diverse voices of the Fediverse.

Mission of Mastofetch

Mastofetch strives to empower developers, researchers, and curious users by providing an open-source, privacy-focused tool that retrieves and organizes public Mastodon content from across instances. Our goal is to foster interoperability, openness, and user empowerment in the evolving landscape of federated networks.

Short History of Mastofetch

•During the early years of Mastoget, it was terribly slow, because it loads every post it fetches before showing to the user. And it happens that 12 seperate renderers are created to avoid exceeding the limits of each endpoints. It was partially solved by just showing posts from a single instance but it was not enough.

•On May 25, 2025, "TheDoggyBrad Software Labs" fixed the major problem with Mastoget, which is slow loading as it loads everything before it shows the page to the user with lazyload. Posts from every instance can now be seen without too much delay on the initial page load.
Then, it was seen that the 12 seperate load balancing renderers of Mastoget are no longer needed after the changes.

•On May 26, 2025, "The Mastoget Organization" shutted down and passed its operations to TheDoggyBrad Software Labs as "Mastofetch". Therefore, all the 12 seperate load balancing renderers was consolidated into this one site in a single server.

•On December 25, 2025, the initial posts that are loaded in the first load of the page was reduced from 5 to 3, in order to speed up the first load of the site. Still, the remaining posts are to be loaded by lazyload.

•Up to this day, the "Mastoget" source code is still the foundation of "Mastofetch" and have been enhanced over time.

Self-hosting Mastofetch

To self-host Mastofetch on your own, you have 2 main options:
A. Upload the "index.php" file located at the /api folder of this repository to your PHP-supported web hosting provider or PHP-supported self-hosting machine and it is ready to use with no setup required. Just ensure to use PHP 8 and above to avoid any issues as this project is currently designed to run under PHP 8 (There are free options but they are limited).
B. Fork this repository and then create a project in Vercel and link your fork repository to the project or directly use Vercel to clone this repository during the creation of your project there. You will need to follow some steps in order to do this but this will not require any technical knowledge to do so (This is absolutely free, unless you opted to a paid plan in Vercel).

About

Mastofetch is your anonymized feed retriever for the Mastodon network.

Topics

Resources

License

Stars

Watchers

Forks

Contributors