Project

rsssf

0.0
A long-lived project that still receives updates
rsssfrsssf/scriptsHomepageDocumentationSource CodeBug Tracker
rsssf - tools 'n' scripts for RSSSF (Rec.Sport.Soccer Statistics Foundation) archive data
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Popularity
Downloads
7,253
Stars
2
Forks
0
Watchers
1
 Releases
Current version
0.3.0
Total releases
4
First release
2015-09-15
Latest release
2026-05-08
 Development
Primary Language
Ruby
Licenses
Public Domain
Average date of last 50 commits
2026-07-03
Reverse Dependencies
0

 Dependencies

Development

rdoc
>= 4.0, < 7
hoe
~> 4.2

Runtime

cocos
>= 0
season-formats
>= 0
webget
>= 0
 Project Readme

football.db RSSSF (Rec.Sport.Soccer Statistics Foundation) tools & scripts

command line tools

mirror

use mirror to mirror the complete rsssf.org website (about 40 000+ .html pages - about 800 MB) by following (and recording) all internal links. the command will download (and cache all .html pages converted to utf-8) and build-up a local (sqlite) mirror.db (about 20 MB) with the link structure (ingoing and outgoing) & titles using a pages and links table.

for more, see /mirror ยป

prepare

use prepare to download (if not cached or forced) and convert tables (in .html to .txt)

Usage: prepare/prepare.rb [options] <config slug>
    -u, --update                     turn on update; write to production repo (default: false)
        --force                      force download; do NOT use cached version if available (default: false)
        --offline, --cached          no downloads; always use cached version (default: false)

pass in a pages config (e.g. eng, de, worldcup, etc.) with a list of table files in a comma-separated values (csv) file.

$ ruby prepare/prepare.rb eng
$ ruby prepare/prepare.rb --force eng       ## (force) redownload all

note - the web pages get (by default) cached in ./cache and the converted tables (in .txt ) get written to the default outdir ../tables

tip: see https://github.com/rsssf/tables for a public online copy / mirror of converted tables in .txt (preserving the original format).

fmtfix

use fmtfix to convert .txt tables (original format only in .txt) to .txt pages (applied "autofixes" for football.txt parsing)

Usage: fmtfix/fmtfix.rb [options] <.txt files> or <config slugs>
    -u, --update                     turn on update; write to production repo (default: false)

pass in (i) individual table files e.g eng2010.txt or 34f.txt or (ii) a pages config (e.g. eng, de, worldcup, etc.) with a list of table files in a comma-separated values (csv) file.

$ ruby fmtfix/fmtfix.rb eng2010.txt eng2011.txt
$ ruby fmtfix/fmtfix.rb eng

note - the outdir for pages config default to ./tmp-<slug> e.g. eng becomes ./tmp-eng and so on; for individual table files the outdir defaults to ./tmp-fmtfix

tip: see https://github.com/rsssf/clubs, https://github.com/rsssf/world, for public online copies / mirrors for .txt pages with applied "autofixes" for football.txt parsing (look inside the /pages directories).