aboutsummaryrefslogtreecommitdiffstats
path: root/README
blob: 9427d94a9f10f2400d4905baef4f16bcd32809c7 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
NAME
	metar - Trivial whether report

SYNOPSIS
	metar get
	metar print
	metar set STATION
	metar list
	metar closest LATITUDE LONGITUDE [LIST]

DESCRIPTION
	metar is a simple utility for find whether stations (hence referred to
	as METAR stations,) get and raw METAR reports. Most METAR stations are
	airports.

ACTIONS
	get
		Gets the most recent weather report from the selected METAR
		station. The first line in the report will contain the station's
		name, country, code, and location.

	print
		Print the code of the selected METAR station, the station
		from which weather reports are retrieved. This is equivalent
		to running

		(cat ~/.config/metar || cat /etc/metar) 2> /dev/null | head -n 1

	set STATION
		Stores the STATION as the METAR station from which weather
		reports shall be retrieved. STATION shall be the stations's
		code. This is equivalent to running

		echo STATION > ~/.config/metar

	list
		Print all METAR stations. This can take a very long time. You
		are strongly encouraged to store the output to a file.

		Each station is will be printed on a line, containing the its
		name, country, code, and location. The code is in parenthesis.

	closest LATITUDE LONGITUDE [LIST]
		Given a LATITUDE and LONGITUDE in decimal format, print the
		code of the closest METAR station. If you have already created
		a list of all stations using the action list, specify the
		filename of that list as the LIST argument.

FILES
	~/.config/metar
		Contains a the code for the selected weather station, and
		nothing else, except an LF at the end. This will never change.
		Other programs are encouraged to use this file too.

		If the file contains more than one line, only the first line,
		even if it is empty, is used.

	/etc/metar
		Fallback file use if ~/.config/metar is missing. Other
		programs are encouraged to use this file too.

NOTES
	US Americans, remember, you are one the western hemisphere. Therefore,
	you should specify a negative longitude when using the action closest.

SEE ALSO
	xpybar(1), localeme(1)