Miniflux automatically refresh feeds

Automatically refreshes Miniflux feeds

Verzia zo dňa 28.10.2025. Pozri najnovšiu verziu.

Na nainštalovanie skriptu si budete musieť nainštalovať rozšírenie, ako napríklad Tampermonkey, Greasemonkey alebo Violentmonkey.

Na nainštalovanie skriptu si budete musieť nainštalovať rozšírenie, ako napríklad Tampermonkey, % alebo Violentmonkey.

Na nainštalovanie skriptu si budete musieť nainštalovať rozšírenie, ako napríklad Tampermonkey, % alebo Violentmonkey.

Na nainštalovanie skriptu si budete musieť nainštalovať rozšírenie, ako napríklad Tampermonkey alebo Userscripts.

Na inštaláciu tohto skriptu je potrebné nainštalovať rozšírenie, ako napríklad Tampermonkey.

Na inštaláciu tohto skriptu je potrebné nainštalovať rozšírenie správcu používateľských skriptov.

(Už mám správcu používateľských skriptov, nechajte ma ho nainštalovať!)

Na inštaláciu tohto štýlu je potrebné nainštalovať rozšírenie, ako napríklad Stylus.

Na inštaláciu tohto štýlu je potrebné nainštalovať rozšírenie, ako napríklad Stylus.

Na inštaláciu tohto štýlu je potrebné nainštalovať rozšírenie, ako napríklad Stylus.

Na inštaláciu tohto štýlu je potrebné nainštalovať rozšírenie správcu používateľských štýlov.

Na inštaláciu tohto štýlu je potrebné nainštalovať rozšírenie správcu používateľských štýlov.

Na inštaláciu tohto štýlu je potrebné nainštalovať rozšírenie správcu používateľských štýlov.

(Už mám správcu používateľských štýlov, nechajte ma ho nainštalovať!)

// ==UserScript==
// @name         Miniflux automatically refresh feeds
// @namespace    https://reader.miniflux.app/
// @version      31
// @description  Automatically refreshes Miniflux feeds
// @author       Tehhund
// @match        *://*.miniflux.app/*
// @icon         https://www.google.com/s2/favicons?sz=64&domain=miniflux.app
// @run-at       document-start
// ==/UserScript==

/* jshint esversion: 8 */

// Refresh the page every hour to keep feeds updating.
setTimeout(() => { location.reload(); }, 3600000);

let apiKey = ''; // Put your API key from Miniflux here.
const rateLimit = 43200000; // Only refresh twice per day. 43200000 miliseconds = 12 hours. If a feed has an error (e.g., too many requests) its checked_at datetime still gets updated so we won't hit the feeds with too many requests.

const refreshFeeds = async () => {
  let toastDiv = document.createElement('div');
  toastDiv.id = 'toastDiv';
  toastDiv.style.marginBottom = "5rem";
  toastDiv.style.color = "rgb(170, 170, 170)";
  document.body.appendChild(toastDiv);
  let pageLastRefreshedNode = document.createElement('div');
  pageLastRefreshedNode.id = `pageLastRefreshed`;
  pageLastRefreshedNode.textContent = `Page last refreshed at ${new Date().toLocaleString([], { year: 'numeric', month: 'numeric', day: 'numeric', hour: '2-digit', minute: '2-digit' })}.`;
  toastDiv.appendChild(pageLastRefreshedNode);
  // setTimeout(() => { toastDiv.remove(); }, 900000); // remove after 15 minutes. // Going to leave the node for now so we can see when the page was last refreshed.
  if (!apiKey) { // If the API key isn't specified, try getting it from localstorage.
    apiKey = localStorage.getItem('miniFluxRefresherApiKey');
  } else { // If we have the API key, store it in localstorage.
    localStorage.setItem('miniFluxRefresherApiKey', apiKey);
  }
  if (!apiKey) { // Indicate if an API key was found either in the code or in localstorage.
    toastDiv.innerText = 'Refresher script: Missing API key.';
    const keyInput = document.createElement('input');
    keyInput.setAttribute('type', 'text');
    keyInput.setAttribute('placeholder', 'Enter API key here');
    keyInput.style.width = "300px";
    keyInput.style.marginLeft = "10px";
    keyInput.addEventListener("keyup", ({ key }) => {
      if (key === "Enter") {
        apiKey = keyInput.value;
        localStorage.setItem('miniFluxRefresherApiKey', apiKey);
        keyInput.remove();
        setToast('API key saved. Please refresh the page to start the feed refresh process.');
      }
    });
    toastDiv.appendChild(keyInput);
  }
  setToast('Starting feed refresh process.');
  let req = await fetch('https://reader.miniflux.app/v1/feeds', { headers: { 'X-Auth-Token': apiKey } });
  let res = JSON.parse(await req.text());
  let feedsArray = res.map(currentFeed => currentFeed); // Turn JSON into an array for sorting.
  feedsArray.sort((a, b) => { return (new Date(a.checked_at) - new Date(b.checked_at)); }); // Sort from least recently checked to most recently checked so least recent gets refreshed first.
  setToast('Got list of feeds.');
  let feedsLastRefreshedNode = document.createElement('div');
  feedsLastRefreshedNode.id = `feedsLastRefreshed`;
  feedsLastRefreshedNode.textContent = `Oldest feed last refreshed at ${new Date(feedsArray[0].checked_at).toLocaleString([], { year: 'numeric', month: 'numeric', day: 'numeric', hour: '2-digit', minute: '2-digit' })}.`;
  toastDiv.appendChild(feedsLastRefreshedNode);
  let countFeedsToRefresh = 0;
  let countFeedsToNotRefresh = 0;
  for (let [index, feed] of feedsArray.entries()) {
    let lastChecked = new Date(feed.checked_at).getTime();
    if (Date.now() - lastChecked > rateLimit) {
      countFeedsToRefresh++;
      console.log(`${feed.title} ${feed.site_url}: It's been more than 12 hours, refresh.`);
      setToast(`${feed.title} ${feed.site_url}: It's been more than 12 hours, refresh.`);
      setTimeout(
        async () => {
          let req = await fetch(`https://reader.miniflux.app/v1/feeds/${feed.id}`, { headers: { 'X-Auth-Token': apiKey } });
          let response = JSON.parse(await req.text());
          let lastChecked = new Date(response.checked_at).getTime();
          if (Date.now() - lastChecked > rateLimit) { // Since navigating, refreshing the page, or using another device could cause duplicate refreshes, double check that each feed still hasn't been refreshed recently.
            let newNode = setToast(`Fetching ${feed.title} ${feed.site_url}.`);
            let res = await fetch(`https://reader.miniflux.app/v1/feeds/${feed.id}/refresh`, {
              method: "PUT",
              headers: { 'X-Auth-Token': apiKey }
            });
            newNode.textContent += ` Complete.`;
            countFeedsToRefresh--;
            setToast(`${countFeedsToRefresh} feeds left to refresh.`);
            console.log(res);
          }
        }, 15000 * index); // Wait 15 seconds between refreshing feeds to avoid rate limiting.
    } else {
      countFeedsToNotRefresh++;
      console.log(`${feed.title}: It's been less than 12 hours, do nothing.`);
      //setToast(`${feed.title}: It's been less than 12 hours, do nothing.`);
    }
  }
  setToast(`${countFeedsToRefresh} feeds to refresh, ${countFeedsToNotRefresh} to skip.`);
};

const setToast = (text, timeout = 4000) => {
  let newNode = document.createElement('div');
  newNode.id = `feedFetchStatus`;
  newNode.textContent = text;
  document.getElementById('toastDiv').appendChild(newNode);
  setTimeout(() => { newNode.remove(); }, timeout);
  return newNode;
};

// run once when the page is loaded.
window.addEventListener("DOMContentLoaded", refreshFeeds);