diff --git a/buildMetadata.js b/buildMetadata.js
new file mode 100644
index 0000000..70a087b
--- /dev/null
+++ b/buildMetadata.js
@@ -0,0 +1,175 @@
+const fs = require('fs');
+const { promisify } = require('util');
+const fetch = require('node-fetch');
+const dayjs = require('dayjs');
+
+require('draftlog').into(console);
+
+process.on('unhandledRejection', error => {
+  console.log('unhandledRejection', error.message);
+});
+
+if (!process.env.TOKEN) {
+  throw new Error('no github token found');
+}
+
+// --- ENV VAR ---
+const BATCH_SIZE = parseInt(process.env.BATCH_SIZE, 10) || 10;
+const DELAY = parseInt(process.env.DELAY, 10) || 3000;
+// --- FILENAME ---
+const README = 'README.md';
+const GITHUB_METADATA_FILE = `data/${dayjs().format(
+  'YYYY-MM-DDTHH.mm.ss',
+)}-fetched_repo_data.json`;
+const GITHUB_REPOS = 'data/list_repos.json';
+const METADATA_TABLE = 'data/table.md';
+// --- HTTP ---
+const API = 'https://api.github.com/';
+const options = {
+  method: 'GET',
+  headers: {
+    'User-Agent': 'awesome-docker script listing',
+    'Content-Type': 'application/json',
+    Authorization: `token ${process.env.TOKEN}`,
+  },
+};
+
+const removeHost = x => x.slice('https://github.com/'.length, x.length);
+const readFile = promisify(fs.readFile);
+const writeFile = promisify(fs.writeFile);
+const printError = err => err && console.error('❌ ERROR', err);
+const barLine = console.draft('Starting batch...');
+
+const delay = ms =>
+  new Promise(resolve => {
+    setTimeout(() => resolve(), ms);
+  });
+
+const get = (path, opt) =>
+  fetch(`${API}repos/${path}`, {
+    ...options,
+    ...opt,
+  })
+    .catch(printError)
+    .then(response => {
+      if (response.ok) return response.json();
+      throw new Error('Network response was not ok.');
+    })
+    .catch(printError);
+
+const fetchAll = batch => Promise.all(batch.map(async path => get(path)));
+
+const extractAllRepos = markdown => {
+  const re = /https:\/\/github\.com\/([a-zA-Z0-9-._]+)\/([a-zA-Z0-9-._]+)/g;
+  const md = markdown.match(re);
+  return [...new Set(md)];
+};
+
+const ProgressBar = (i, batchSize, total) => {
+  const progress = Math.round((i / total) * 100);
+  const units = Math.round(progress / 2);
+  return barLine(
+    `[${'='.repeat(units)}${' '.repeat(50 - units)}] ${progress}%  -  # ${i}`,
+  );
+};
+
+const getLastUpdate = updated => {
+  const updt = Number(dayjs(updated).diff(dayjs(), 'days'));
+  if (updt < 0) {
+    if (Math.abs(updt) === 1) return `1 day ago`;
+    return `${Math.abs(updt)} days ago`;
+  } else if (updt === 0) return 'today';
+  return updated;
+};
+
+const createLine = data => {
+  const {
+    name,
+    html_url: repoURL,
+    description,
+    homepage,
+    stargazers_count: stargazers,
+    updated_at: updated,
+    language,
+    license,
+    owner,
+  } = data;
+  if (!data || !name) return '|ERROR |';
+
+  const lineData = [
+    `[${name}](${repoURL})`,
+    description || '-',
+    homepage || '-',
+    stargazers,
+    getLastUpdate(updated),
+    language,
+    license && `[${license.name}](${license.url})`,
+    owner && `[${owner.login}](${owner.html_url})`,
+  ];
+  return `|${lineData.join('|')}|`;
+};
+
+async function batchFetchRepoMetadata(githubRepos) {
+  const repos = githubRepos.map(removeHost);
+
+  const metadata = [];
+  /* eslint-disable no-await-in-loop */
+  for (let i = 0; i < repos.length; i += BATCH_SIZE) {
+    const batch = repos.slice(i, i + BATCH_SIZE);
+    if (process.env.DEBUG) console.log({ batch });
+    const res = await fetchAll(batch);
+    fs.appendFile(
+      GITHUB_METADATA_FILE,
+      JSON.stringify(res, null, 2),
+      printError,
+    );
+    metadata.push(...res);
+    ProgressBar(i, BATCH_SIZE, repos.length);
+    // poor's man rate limiting so github don't blacklist us
+    // also the file has the time to append the data
+    await delay(DELAY);
+  }
+  ProgressBar(repos.length, BATCH_SIZE, repos.length);
+  return metadata;
+}
+
+const convertToTable = data => {
+  const header = `
+# Repository Metadata
+
+| Name        | Description | Homepage | Star | Updated | Language | License | Author |
+| ----------- | ----------- | -------- | ---- | ------- | -------- | :---:   | ------:|`;
+  const table = [header]
+    .concat(
+      data
+        .sort((a, b) => Number(b.stargazers_count) - Number(a.stargazers_count))
+        .map(createLine),
+    )
+    .join('\n');
+
+  return writeFile(METADATA_TABLE, table);
+};
+
+async function main() {
+  try {
+    const markdown = await readFile(README, { encoding: 'utf8' });
+    const githubRepos = extractAllRepos(markdown);
+    await writeFile(
+      GITHUB_REPOS,
+      JSON.stringify(githubRepos, null, 2),
+      printError,
+    );
+
+    const metadata = batchFetchRepoMetadata(githubRepos);
+
+    console.log('✅ fetching metadata');
+
+    await convertToTable(metadata);
+
+    console.log('✅ writing metadata table');
+  } catch (err) {
+    printError(err);
+  }
+}
+
+main();