edit Documentation

JavaScript freemediaheckyeah repository by @fmhy. Model Context Protocol (MCP) server & tools with 11k stars.

11,088 stars JavaScript JavaScript 1 file Β· ~6,472 tokens #fmhy#freemediaheckyeah
RAW Doc

File: api/README.md

This is the API for the website and other related services.

Licensed under the Apache License v2.0, see LICENSE for more information.


File: docs/other/contributing.md


title: Contributing next: false prev: false


File: docs/other/selfhosting.md


title: Selfhosting FMHY

Selfhosting

:::warning
Do note that you must differentiate your instance from the official site (fmhy.net) to avoid confusion. Steps to do so are given in step 4.
:::

This guide will help you set up and run your own instance of FMHY locally.

Docker (Experimental)

To run a local instance, you will need to install Docker and Docker Compose.

After installing both, run the following commands:

bash
git clone https://github.com/fmhy/edit.git
cd edit
sudo docker compose up --build

It might take a few minutes to build the image and start the container, running at port 4173.

Nix Flake

You can use nix to set up a development environment, we have a flake that setups nodejs and pnpm.

  1. Fork the repository and clone it to your local machine with git clone https://github.com/fmhy/edit.git.
  2. Run nix flake update to update the flake lock file.
  3. Run nix develop to enter the development environment.
  4. Make your changes.
  5. Exit the development environment by running exit.

Manually

You will need to install the following:

Step 1: Clone the Repository

bash
git clone https://github.com/fmhy/edit.git
cd edit

Step 2: Install Dependencies

Install project dependencies using pnpm:

bash
pnpm install

Step 3: Development Mode

To run the project in development mode:

bash
# Start the documentation site in dev mode
pnpm docs:dev

# Start the API in dev mode (if needed)
pnpm api:dev

The development server will start at http://localhost:5173 by default.

Step 4: Building for Production

You will need to update:

  • meta: Constant in docs/.vitepress/constants.ts
    • name: Name of your instance
    • hostname: Your domain
    • description: Description of your instance
    • tags: Opengraph tags
    • build: Build options (can be configured with Environment Variables)
  • docs/index.md
    • title
    • description
    • hero.name
    • hero.tagline

To build the project for production:

bash
# Build the documentation site
pnpm docs:build

# Build the API (if needed) using the Node.js preset
NITRO_PRESET=node pnpm api:build

Step 5: Preview Production Build

To preview the production build locally:

bash
# Preview the documentation site
pnpm docs:preview

# Preview the API (if needed)
pnpm api:preview

Step 6: Deploy

See the VitePress deployment guide for more info.

API Deployment

If you want to deploy the API component (feedback system), you'll need to set up Cloudflare Workers and KV storage.

Prerequisites

Step 1: Configure Wrangler

Update wrangler.toml with your Cloudflare account information:

  1. Get your account ID from the Cloudflare dashboard (found in the right sidebar)
  2. Replace the account_id value in wrangler.toml with your account ID
  3. If you're using a custom domain, keep workers_dev = false and update the routes section
  4. If you're deploying to *.workers.dev, set workers_dev = true and remove the routes section

Step 2: Create KV Namespace

Create a KV namespace for data storage:

bash
npx wrangler kv:namespace create STORAGE

This command will return a namespace ID. Copy this ID and replace the id value in the [[kv_namespaces]] section of wrangler.toml (line 14).

Note: If you want to deploy without running Wrangler locally (e.g., in CI/CD), you'll need to:

  1. Create the KV namespace manually in the Cloudflare dashboard
  2. Update both the account_id and id values in wrangler.toml in your fork

Step 3: Build and Deploy

Build and deploy the API:

bash
# Build the API
pnpm api:build

# Deploy to Cloudflare Workers
pnpm api:deploy

The API will be deployed to your configured domain or *.workers.dev subdomain.

Rate Limiting (Optional)

The rate limiter binding requires setup through the Cloudflare dashboard. You can skip this for basic deployments or configure it later through the Workers dashboard under the "Rate limiting" section.

Environment Variables

Build-time Variables (for Documentation)

These variables control what gets included when building the documentation site:

  • FMHY_BUILD_NSFW - Enable NSFW sidebar entry (experimental)
  • FMHY_BUILD_API - Enable API component for feedback system

Runtime Variables (for API Worker)

These variables are used by the deployed Cloudflare Worker API:

  • WEBHOOK_URL - Discord webhook URL for posting feedback messages (required for API feedback functionality)

Troubleshooting

  1. If you encounter Node.js version issues, ensure you're using Node.js 21+
  2. For pnpm-related issues, ensure you're using pnpm 9+
  3. If you encounter build issues, try clearing cache:
    bash
    # Linux
    rm -rf docs/.vitepress/cache
    
    # PowerShell
    rm -r -fo docs/.vitepress/cache

Reverse Proxy

You should be able to use any reverse proxy with this vitepress website, but find a reasonable config for an nginx server in the repo here


File: docs/other/wallpapers.md


title: Wallpapers next: false prev: false

Wallpapers

Elevate yourself to the next level with our beautiful wallpapers.

All of these wallpapers were made by taskylizard.




File: docs/posts/april-2023.md


title: Monthly Updates [April]
date: 2023-04-01
next: false

prev: false

:::info
These update threads only contain major updates. If you're interested
in seeing all minor changes you can follow our
Commits Page on GitHub or
Updates Channel in Discord.
:::

Wiki Updates


Stars Added ⭐

  • Starred ChatPDF in AI Chatbots. AI that turns any book
    into a chatbot.

  • Starred Foogle in Video Download.
    Fast, single-click video downloads.

  • Starred JustChill in Streaming Sites.
    Nice UI, fast 1080p.

  • Starred movie-web in Streaming Sites. Nice UI,
    fast 1080p.

  • Starred Primewire in Streaming Sites.
    Primewire has started adding links to pirated content again.

  • Starred Wotaku in Indexes. Awesome Japanese
    piracy index.

  • Starred RLSLOAD in Software Sites.
    Software site with single-click downloads.

  • Starred Flameshot in Screenshot Tools. Some
    people like this more than ShareX.


Things Removed

  • Removed FTUApps. FTU got caught with malware by
    /r/Piracy.

  • Removed star from FileCR. They added new anti-adblock measures recently, and
    adblock defenders are no longer working for many users.

  • Removed anti-anti-copy userscript. Script enables F7 "Caret Browsing mode"
    without telling the user it's been enabled, or how to turn it off.


File: docs/posts/april-2024.md


title: Monthly Updates [April]
date: 2024-04-01
next: false

prev: false

:::info
These update threads only contain major updates. If you're interested
in seeing all minor changes you can follow our
Commits Page on GitHub or
Updates Channel in Discord.
:::

Wiki Updates


Stars Added ⭐

  • Starred Streamed in Live
    Sports. Fast streams, no ads.

  • Starred Poke in
    YouTube Frontends. Nice UI, download support, no ads.

  • Starred Motrix in Download
    Managers. Some people prefer this over Jdownloader / IDM.

  • Starred Openlib in
    Android Reading. Anna’s Archive app.

  • Starred Stacher in
    YouTube Downloaders. Modern YT-DL GUI.

  • Starred DeepLX in Translators.
    Unlimited DeepL.

  • Starred Claude in Online Chatbots.
    Works better than things like Gemini.

  • Starred Soft98 in
    Software Sites. Big library, single click DDL.

  • Starred JellyPlayer in Jellyfin
    Tools. Modern Jellyfin client.

  • Starred UniGetUI in Package
    Managers. Nice user interface for Winget.

  • Starred Zipline in Screenshot
    Tools. Self-hosted, feature-rich ShareX server.

  • Starred WSABuilds in
    Android Emulators. Pre-built WSA binaries that will continue to be
    updated.

  • Starred SmartImage in
    Reverse Image Search. Multi-site reverse image search tool.


Things Removed

  • Removed free-mp3-download as they've shut down.

  • Removed HolyUnblocker as they've
    shut down.

  • Removed WSA as support for it has been dropped.

  • Unstarred FlixHQ in Streaming. This used to be good but seems to be a lot
    slower recently.


File: docs/posts/april-2025.md


title: Monthly Updates [April]
date: 2025-04-01
next: false

prev: false

:::info
These update threads only contain major updates. If you're interested
in seeing all minor changes you can follow our
Commits Page on GitHub or
Updates Channel in Discord.
:::

Wiki Updates

  • Added a Guide to set up and run your own instance of FMHY locally.

  • Added a Userscript version of the FMHY Safeguard.

  • You can now choose custom text colors for the site using the icons in the sidebar + updated the feedback system to be more prominent.

  • Cleaned up Drama Streaming section, removed dead / bad sites, and starred a few that seemed to work the best, before vs after.

  • Cleaned up Japanese Learning section, note that no sites were removed, just moved, before vs after.

  • Added usage limit tags to the AI Video Generators.

  • Better organized font section + split into Generators and Customization.

  • Added a few New Criteria to our streaming site grading system.


Stars Added ⭐

  • Starred DAB Music Player in Audio DDL. Single-click FLAC album downloads, has web app + desktop apps for Windows, Mac, and Linux, with Android support coming soon.

  • Starred IronFox in Android Privacy Browsers. Firefox-based browser with a focus on privacy / security. Feature-rich, recommended by the LibreWolf dev team, and our community seems to really like it.

  • Starred AdGuardExtra in Twitch Adblockers. This seems to be the best way to block them now.

  • Starred AMP4 in YouTube Video Downloaders, ad-free, supports playlists and 3-hour long videos.

  • Starred JustDeleteMe in Web Privacy. Directory of links to more easily delete your accounts from web services.

  • Starred PocketCasts in Podcast Streaming. Popular iOS podcast player that recently added both desktop + web apps.

  • Starred ADS-B Exchange in Flights section, one of the only sites that doesn't lock features behind paywalls.

  • Replaced star for xManager with ReVanced Manager in Ad-Free Spotify as it has more features, fewer issues, and xManager itself recommends it.

  • Removed star for Bark as it's limited, and star for Tortoise TTS as it doesn't sound good, and instead starred TTS Online, which sounds better and has a 10k daily character limit.


Things Removed

  • Removed TorrentGalaxy, doesn't look like it's coming back anytime soon sadly.

  • Removed The Last Disaster from Audio DDL as they've shut down.

  • Removed TOTV from Live TV as every channel seems to be YouTube videos now.

  • Unstarred Plex as they've made remote streaming paid only, and increased their prices at the same time.

  • Unstarred PSArips as their download process is very annoying.

  • Unstarred Bookracy as it's been having issues for a while now.


File: docs/posts/aug-2023.md


title: Monthly Updates [August]
date: 2023-08-01
next: false

prev: false

:::info
These update threads only contain major updates. If you're interested
in seeing all minor changes you can follow our
Commits Page on GitHub or
Updates Channel in Discord.
:::

Wiki Updates


Stars Added ⭐

  • Starred Ova Games in Game Download. Big
    library, fast hosts.

  • Starred SmashyStream in Streaming Sites.
    Nice UI, fast 1080p.

  • Starred BlackPearlOrigin in Game
    Launchers. New game launcher and downloader, made by our friends.

  • Starred Androeed and Modyolo in Modded APKs.

  • Starred Skraper in Emulation. Automate
    ROM Covers / Metadata.

  • Starred ROMhacking in ROM Sites. One of the
    oldest sites for fan translations.

  • Starred FreeSports in Live Sports. A
    live sports site that isn't flooded with ads like most are.

  • Starred SoccerCatch in Sports
    Streaming. Full Match replays.

  • Starred DownloadPirate in VFX Sites. Popular site for
    video effects and software.

  • Starred SophiApp in debloaters. Gives good
    explanations for its tweaks, making it safer for new users.

  • Starred
    Actually Good Distros
    in Linux. Beginner distro guides.


Things Removed

  • Removed Bromite as they've stopped updates,
    and replaced it with Cromite which will
    continue to be updated by one of their devs.

  • Removed AI Text Detectors as they're known for
    being inaccurate.

  • Unstarred SoftArchive in Software as people have become annoyed with their
    slow hosts.

  • Unstarred LookMovie in Streaming as people don't like the fact 1080p is behind
    premium.

  • Unstarred QuickBoost in Tweaking as the app doesn't give details as to what
    each tweak actually does.

  • Unstarred Sockshare in Streaming as their original domain died, and it doesn't
    have the best UI anyway.

  • Removed AnimeKaizoku from Anime Streaming as they've shut down.

  • Removed DeepFloyd from Image Generators as it's been paused for over a month.

  • Removed Appnee from Software Sites. The MAS team found that they host many
    unsafe activators. We don't think Appnee is
    purposefully malicious; they just need to be more careful and clean things up
    before we can add them again.


File: docs/posts/aug-2024.md


title: Monthly Updates [August]
date: 2024-08-01
next: false

prev: false

:::info
These update threads only contain major updates. If you're interested
in seeing all minor changes you can follow our
Commits Page on GitHub or
Updates Channel in Discord.
:::

Wiki Updates


Stars Added ⭐

  • Starred lucida in
    Audio Ripping. Multi-site audio ripping with 320kb / FLAC support.

  • Starred Proton Docs in Text
    Tools. Proton's Google Docs alternative.

  • Starred Pikimov in Online Video
    Editors. Online Adobe After Effects alternative.

  • Starred Flowstreams in Live
    Sports. Live sports / music events.

  • Starred FullReplays in
    Sports Replays. Full soccer match replays.

  • Starred Aurora Store in
    Untouched APKs. FOSS version of the Play Store.

  • Starred No Trace in
    Privacy Indexes. In-depth privacy guides / anti-surveillance.

  • Starred
    Futo Keyboard / Voice in
    Android Keyboard Tools. Privacy-focused keyboards.

  • Starred Piko in Android
    Social Media. ReVanced patches for X.com.

  • Starred auto-mcs in
    Minecraft Server Tools. Simple Minecraft server setup.

  • Starred Vijay's Virtual Vibes in Fun
    Sites. Find random sites.

  • Starred Codeium in Coding AIs. Popular
    coding AI with unlimited GPT-3.5.

  • Starred Print Chess in Strategy
    Games. Printable paper chess set.

  • Starred both Streamflix and PrimeFlix in
    Multi Host. Both sites have improved a
    lot recently.

  • Re-added + Starred Gmailnator.
    Temp mail site with Gmail addresses.


Things Removed

  • Removed Fmovies as it's been offline for weeks. We've replaced it with
    FBOX for now.

  • Removed Cipher Files as they've shut down.

  • Removed Homeworkify as they've shut down.

  • Unstarred both Awesome Privacy and Hitchhiker’s Guide in Privacy Indexes, and
    bumped PrivacyGuides.org to the top. PrivacyGuides is high quality and updated
    more often than others.