Print the next CTFTime CTFs from the command line, include important fields such as start/end date (local time), weight, duration and links.

Usage:

1$ ctf-list                        # Show all available CTFs
2$ ctf-list 01-11-2025 30-11-2025  # Show CTFs in range
3$ ctf-list now 05-05-2025         # Show CTFs in range
4$ ctf-list +5                     # Show the next N CTFs

Sample output:

1[ecomaikgolf@laptop ~/ctf-list/]$ ./ctf-list +3
2
3[100.00] PlaidCTF 2025
4       |   - Start:    Friday    04/04/2025 23:00:00 | in 4 days
5       |   - End:      Sunday    06/04/2025 23:00:00 | for 48h
6       |   - Duration: 48h
7       |   - Weight:   100.0
8       |   - Location: On-line
9       |   - CTFTime:  https://ctftime.org/event/2508
10       |   - URL:      https://plaidctf.com/
11    
12
13[ 24.25] squ1rrel CTF 2025
14       |   - Start:    Saturday  05/04/2025 01:00:00 | in 4 days
15       |   - End:      Sunday    06/04/2025 19:00:00 | for 42h
16       |   - Duration: 42h
17       |   - Weight:   24.25
18       |   - Location: On-line
19       |   - CTFTime:  https://ctftime.org/event/2708
20       |   - URL:      https://ctf.squ1rrel.dev/
21    
22
23[  0.00] Breach CTF 2025
24       |   - Start:    Saturday  05/04/2025 04:30:00 | in 4 days
25       |   - End:      Sunday    06/04/2025 04:30:00 | for 24h
26       |   - Duration: 24h
27       |   - Weight:   0.0
28       |   - Location: On-line
29       |   - CTFTime:  https://ctftime.org/event/2671
30       |   - URL:      https://www.breachers.in/
31

Source code:

1#!/usr/bin/env -S uv run --script
2# /// script
3# dependencies = [
4#   "requests"
5# ]
6# ///
7
8import requests
9from datetime import datetime
10from zoneinfo import ZoneInfo
11import sys
12import os
13
14def find_tag(st, t):
15    ln = len(f"<{t}>")
16    s = ctf.find(f"<{t}>")
17    e = ctf.find(f"</{t}>")
18    return st[s + ln:e]
19
20#
21# Timezone Handling
22#
23
24timez = os.getenv('TZ', 'Europe/Vienna')
25
26#
27# Argument parsing
28#
29
30start = None
31end   = None
32total = None
33
34if len(sys.argv) >= 2:
35    if sys.argv[1] == "now":
36        start = datetime.now().replace(tzinfo=ZoneInfo('UTC'))
37    elif sys.argv[1][0] == "+":
38        total = int(sys.argv[1][1:])
39        if total is None:
40            print(f"[!] {sys.argv[1]} couldn't be parsed as integer")
41            exit(1)
42        start = None
43    else:
44        start = datetime.strptime(sys.argv[1], "%d-%m-%Y").replace(tzinfo=ZoneInfo('UTC'))
45        if start is None:
46            print(f"[!] {sys.argv[1]} couldn't be parsed by datetime")
47            exit(1)
48if len(sys.argv) >= 3:
49    end = datetime.strptime(sys.argv[2], "%d-%m-%Y").replace(tzinfo=ZoneInfo('UTC'))
50    if end is None:
51        print(f"[!] {sys.argv[2]} couldn't be parsed by datetime")
52        exit(1)
53    if total is not None:
54        end = None
55
56#
57# RSS Request
58#
59
60n = datetime.now().replace(tzinfo=ZoneInfo('UTC')).astimezone(ZoneInfo(timez))
61
62response = requests.get('https://ctftime.org/event/list/upcoming/rss/')
63
64if response.status_code != 200:
65    print("[!] Error fetching RSS feed")
66    exit(1)
67
68raw = response.text
69raw = raw.split("<item>")[1:]
70
71#
72# CTF Parsing
73#
74
75i = 0
76for ctf in raw:
77    title = find_tag(ctf, "title")
78    guid  = find_tag(ctf, "guid")
79    url   = find_tag(ctf, "url")
80    w     = float(find_tag(ctf, "weight"))
81    sd    = find_tag(ctf, "start_date")
82    ed    = find_tag(ctf, "finish_date")
83    desc  = find_tag(ctf, "description")
84
85    loc = None
86    if "On-line" in desc:
87        loc = "On-line"
88    elif "On-site" in desc:
89        loc = "On-site"
90    else:
91        loc = "Unknown"
92
93    sd = datetime.fromisoformat(sd).replace(tzinfo=ZoneInfo('UTC'))
94    ed = datetime.fromisoformat(ed).replace(tzinfo=ZoneInfo('UTC'))
95
96    if start is not None and sd < start:
97        continue
98
99    if end is not None and sd > end:
100        continue
101
102    sd = sd.astimezone(ZoneInfo(timez))
103    ed = ed.astimezone(ZoneInfo(timez))
104
105    ft_sd = sd.strftime("%d/%m/%Y %H:%M:%S")
106    ft_ed = ed.strftime("%d/%m/%Y %H:%M:%S")
107
108    fd_sd = sd.strftime("%A")
109    fd_ed = ed.strftime("%A")
110
111    rem   = round((sd - n).total_seconds() / (24 * 60 * 60))
112
113    ft_r  = ""
114    if (int(rem/7)) > 0:
115        ft_r += f"{int(rem/7)} week(s)"
116        if (rem%7) > 0:
117            ft_r += f" and {rem%7} day(s)"
118    elif (rem%7) > 0:
119        ft_r += f"{rem%7} days"
120    else:
121        ft_r += "today"
122
123    dur   = round((ed - sd).total_seconds() / (60 * 60))
124
125    print(f"""
126[{w:6.2f}] {title}
127       |   - Start:    {fd_sd:9} {ft_sd} | in {ft_r}
128       |   - End:      {fd_ed:9} {ft_ed} | for {dur}h
129       |   - Duration: {dur}h
130       |   - Weight:   {w}
131       |   - Location: {loc}
132       |   - CTFTime:  {guid}
133       |   - URL:      {url}
134    """)
135
136    i += 1
137
138    if total is not None and i >= total:
139        break
140
141# vim: filetype=python