METAR decoder: from raw report to plain English

Tafrob editorial team · Updated · 8 min read

Short answer

A METAR decoder splits a raw report into its groups and rewrites each one in plain language: station, time, wind, visibility, weather, clouds, temperature, dew point and pressure. The decoder on this page applies the metar-taf-parser library to the text pasted in. It shows each value with its unit and converts statute miles, inches of mercury and hectopascals. It is a reading aid, not an operational source.

Decoding runs in your browser with the open-source metar-taf-parser library (MIT). Nothing is sent to a server. Not for operational use.

Key points

  • The decoder reads one report at a time, ignores a trailing equals sign and extra spaces, and returns a table of labeled rows.
  • Parsing is done by the open-source metar-taf-parser library (version 9.1.3, MIT licence), not by custom code on this site.
  • Visibility and pressure are shown in the unit of the report plus a converted value: 1 statute mile is shown as 1.609 km and 1 inHg as 33.8639 hPa.
  • Remarks after RMK are decoded only when the library recognizes them; an unknown remark is shown as raw text.
  • A report that the parser cannot read produces an error message, never a guess.
Automated weather station beside a taxiway at Los Angeles International Airport
Photo: Famartin, CC BY-SA 4.0, via Wikimedia Commons

What the decoder does

The decoder on this page takes a raw METAR or SPECI, splits it into groups and writes each group in plain English in a table of label and text rows. It works on one report at a time. The text is cleaned first: leading and trailing spaces are trimmed, runs of spaces are collapsed to one, and a final equals sign, which marks the end of a report in bulletins, is removed. The cleaned string is then passed to the open-source metar-taf-parser library, version 9.1.3, released under the MIT licence. No decoding rule is written specifically for this site; the table is a presentation of what the library returns.

Language follows the page: the English page asks the library for English descriptions and the French page for French ones. When the text cannot be parsed at all, the library raises an error and the page shows that the weather string is invalid. It does not try to repair the report.

The rows of the table

The rows appear in the order in which the groups occur in a report, and a row is shown only when the report contains the corresponding group.

Row What it shows
Report type METAR or SPECI
Station The ICAO location indicator
Observation time Day of month and time in UTC, for example "day 19, 15:51 UTC"
AUTO A note that the report is fully automated
Wind Direction, speed and gust, or "calm" or "variable", plus any varying sector
CAVOK A fixed explanation of the code
Visibility Value and unit, converted, with "or more" and "less than" indicators
Weather Present weather phenomena spelled out
Vertical visibility Height in feet when the sky is obscured
Clouds Amount with oktas, height, and CB or TCU type
Runway visual range Per runway, with a rising or falling trend
Temperature and dew point Both in degrees Celsius
Pressure Reported unit plus the other unit
Trend NOSIG, or TEMPO and BECMG trend groups
Remarks Raw remark text and the description given by the library

The layout follows the order described on the how to read a METAR page, so each row can be traced back to the group it came from.

How each group is interpreted

The wind row reads the direction in degrees, the speed and the gust. A speed of zero is displayed as calm, and a direction the library marks as undefined is displayed as variable. A group such as 050V130 becomes a varying direction between 50 and 130 degrees. In METAR the direction is the direction the wind blows from. The wind group page explains the averaging periods and the rounding.

The visibility row keeps the unit of the report. For statute miles it adds the value in kilometers, using a factor of 1.609. A value of 9999 is shown as "10 km or more", a value in meters is shown as meters, and the library's "P" and "M" indicators are shown as "or more" and "less than". A minimum visibility with a direction and the no directional variation code are also displayed. The coding is detailed on the visibility page.

The weather row uses a dictionary of phenomena kept in the page code: intensity, descriptor and phenomenon are combined, so +TSRA is displayed as a heavy thunderstorm with rain and -RA BR as light rain and mist. Present weather is covered on the present weather page.

The clouds row gives the quantity with its oktas range, the height in feet with a thousands separator and the type when CB or TCU is attached. A vertical visibility is shown in its own row.

The temperature row shows temperature and dew point in degrees Celsius; a negative value is written with the library's "M" prefix converted to a minus sign. The pressure row shows inches of mercury with hectopascals added, or hectopascals with inches added, using 33.8639 hPa per inHg and rounding the converted value. The altimeter setting page explains the two conventions.

A worked example

The report below is a constructed US-style example, written for this page.

METAR KJFK 191551Z 28016G26KT 10SM FEW045 SCT250 08/M03 A3012 RMK AO2 SLP204 T00781028

Run through the decoder, it gives these rows:

  • Station KJFK, observed on day 19 at 15:51 UTC.
  • Wind from 280 degrees at 16 kt, gusting 26 kt.
  • Visibility 10 SM (16.1 km).
  • Clouds few (1 to 2 oktas) at 4,500 ft and scattered (3 to 4 oktas) at 25,000 ft.
  • Temperature 8 degrees Celsius and dew point minus 3 degrees Celsius.
  • Pressure 30.12 inHg (1020 hPa).
  • Remarks: AO2, then a sea level pressure of 1020.4 hPa from SLP204, then an hourly temperature of 7.8 degrees Celsius and a dew point of minus 2.8 degrees Celsius from T00781028.

The remark descriptions come straight from the library. The spread between temperature and dew point is 11 degrees, which a pilot can turn into a cloud base estimate with the cloud base calculator.

An international example

A European report exercises other branches of the parser.

METAR LFPG 190830Z 24008KT 4000 -RA BR BKN008 OVC015 09/08 Q1009 TEMPO 2000 RA

The decoder shows visibility 4000 m, light rain and mist, broken cloud at 800 ft and overcast at 1,500 ft, pressure 1009 hPa (29.80 inHg), and a TEMPO trend with visibility 2000 m and rain. A report such as EGLL 191020Z 09012KT 050V130 CAVOK 12/05 Q1021 NOSIG shows the varying sector between 50 and 130 degrees, the fixed CAVOK text, visibility of 10 km or more, and the NOSIG row. A runway visual range group such as R22/1100U is shown as 1100 m with a rising trend. A report that begins with the station and the word AUTO is displayed with a fully automated line, and a vertical visibility such as VV003 is shown as 300 ft.

How to read the result

The table is a translation, not a judgment. The values still need the context given in the reference pages: the ceiling is the lowest broken or overcast layer or the vertical visibility, not the lowest cloud, as explained on the flight categories page. A reading that looks acceptable in the table can hide a trend group, a remark about a thunderstorm or a rapidly changing pressure. The decoder prints these rows too, but it does not rank them.

Limits of automatic decoding

Several limits apply to any parser and to this one in particular.

  • Remarks: the library recognizes a defined list of remark codes. A remark outside the list is typed as unknown and appears as raw text with no interpretation. National and local remarks are common, so the Remarks row can be incomplete.
  • Flight category and ceiling: the library leaves these calculations to the application, and the decoder does not display them. The separate flight category tool applies the thresholds to values typed by hand.
  • Context: the decoder does not know the date. The day of month is shown as "day 19", without a month, because the report itself carries no month.
  • Damaged or non-standard text: a report with a missing group, a merged group or a local extension can be rejected in full or decoded with a wrong value.
  • Differences between countries: units, thresholds and optional groups vary. The US and ICAO differences page lists the main ones.

A schematic report

METAR LXXX 190750Z 24010KT 4SM BR FEW008 BKN022 12/10 A2998

The decoder returns the type METAR, the station LXXX, day 19 at 07:50 UTC, wind from 240 degrees at 10 kt, visibility 4 SM (6.4 km), mist, few clouds at 800 ft, broken clouds at 2,200 ft, temperature 12 and dew point 10 degrees Celsius, and pressure 29.98 inHg (1015 hPa). The ceiling in this report is the broken layer at 2,200 ft. The station code and the report are schematic, not a real observation.

In real reports

Real reports differ from tidy examples in a few predictable ways. A United States report usually ends with a remark section that starts with RMK and carries the type of automated station, the sea level pressure and the hourly temperature, so the Remarks row is often the longest one. An ICAO report from a European station is more likely to end with a trend, such as NOSIG, TEMPO or BECMG, and to use meters and a Q group. An automated report carries AUTO after the time and may have no cloud or weather group at all when the sensors report nothing. The strings in this article are constructed to exercise the decoder and are not live reports; the decoder on this page accepts any string pasted in.

Method and limits

The behavior of the decoder was checked by running its code on the strings above and reading the rows returned. The parsing itself is the work of metar-taf-parser 9.1.3; its project page states the MIT licence and that it parses METAR and SPECI, with locales for the descriptions of remarks. The coding rules the library implements are described in the Aeronautical Information Manual (chapter 7, section 1) for the United States and in the WMO Users' Handbook (WMO-No. 782) for international practice. The decoder code adds the cleaning step, the unit conversions (1.609 km per statute mile and 33.8639 hPa per inHg) and the wording of the labels, which are choices of this site and not a standard. The rows shown are a subset of what the library returns, so a field present in the library output may not be displayed. The site is a learning resource and is not an operational weather source.

Source code of this tool (MIT)
// Tafrob METAR/TAF decoder - MIT licence (c) Tafrob.
// Parsing is done by the open-source metar-taf-parser library (MIT, https://github.com/aeharding/metar-taf-parser).
import { parseMetar, parseTAF } from 'metar-taf-parser';
import fr from 'metar-taf-parser/locale/fr.js';
import en from 'metar-taf-parser/locale/en.js';

type Lang = 'en' | 'fr';
export type Row = [string, string];

const W: Record<string, [string, string]> = {
  '-': ['light', 'faible'], '+': ['heavy', 'fort'], VC: ['in the vicinity', 'au voisinage'],
  MI: ['shallow', 'mince'], BC: ['patches of', 'bancs de'], PR: ['partial', 'partiel'], DR: ['low drifting', 'chasse-basse de'],
  BL: ['blowing', 'chasse-haute de'], SH: ['showers of', 'averses de'], TS: ['thunderstorm', 'orage'], FZ: ['freezing', 'se congelant'],
  DZ: ['drizzle', 'bruine'], RA: ['rain', 'pluie'], SN: ['snow', 'neige'], SG: ['snow grains', 'neige en grains'], IC: ['ice crystals', 'cristaux de glace'],
  PL: ['ice pellets', 'granules de glace'], GR: ['hail', 'grêle'], GS: ['small hail / snow pellets', 'grésil'], UP: ['unknown precipitation', 'précipitation inconnue'],
  BR: ['mist', 'brume'], FG: ['fog', 'brouillard'], FU: ['smoke', 'fumée'], VA: ['volcanic ash', 'cendres volcaniques'], DU: ['widespread dust', 'poussière'],
  SA: ['sand', 'sable'], HZ: ['haze', 'brume sèche'], PY: ['spray', 'embruns'], PO: ['dust/sand whirls', 'tourbillons de poussière'], SQ: ['squalls', 'grains'],
  FC: ['funnel cloud', 'trombe'], SS: ['sandstorm', 'tempête de sable'], DS: ['duststorm', 'tempête de poussière'], NSW: ['no significant weather', 'fin du temps significatif'],
};
const Q: Record<string, [string, string]> = {
  SKC: ['sky clear', 'ciel clair'], FEW: ['few (1-2 oktas)', 'peu (1 à 2 octas)'], SCT: ['scattered (3-4 oktas)', 'épars (3 à 4 octas)'],
  BKN: ['broken (5-7 oktas)', 'fragmenté (5 à 7 octas)'], OVC: ['overcast (8 oktas)', 'couvert (8 octas)'], NSC: ['no significant cloud', 'pas de nuage significatif'],
};
const L = {
  en: { type: 'Report type', station: 'Station', time: 'Observation time', wind: 'Wind', vis: 'Visibility', wx: 'Weather', clouds: 'Clouds', vv: 'Vertical visibility', temp: 'Temperature / dew point', alt: 'Pressure', rvr: 'Runway visual range', rmk: 'Remarks', trend: 'Trend', validity: 'Validity', issued: 'Issued', calm: 'calm', variable: 'variable', from: 'from', gust: 'gusting', varies: 'direction varying between', cavok: 'CAVOK: visibility 10 km or more, no cloud below 5,000 ft or minimum sector altitude, no CB/TCU, no significant weather', ft: 'ft', base: 'at', nosig: 'NOSIG: no significant change expected in the next 2 hours', tx: 'Max temperature', tn: 'Min temperature', prob: 'probability', day: 'day', auto: 'AUTO: fully automated report', utc: 'UTC', minvis: 'minimum visibility', ndv: 'no directional variation available', more: 'or more', less: 'less than', amd: 'AMD: amended forecast', ws: 'Low-level wind shear' },
  fr: { type: 'Type de message', station: 'Station', time: 'Heure d’observation', wind: 'Vent', vis: 'Visibilité', wx: 'Temps présent', clouds: 'Nuages', vv: 'Visibilité verticale', temp: 'Température / point de rosée', alt: 'Pression', rvr: 'Portée visuelle de piste', rmk: 'Remarques', trend: 'Tendance', validity: 'Validité', issued: 'Émis', calm: 'calme', variable: 'variable', from: 'du', gust: 'rafales à', varies: 'direction variant entre', cavok: 'CAVOK : visibilité de 10 km ou plus, pas de nuage sous 5 000 ft ou l’altitude minimale de secteur, ni CB ni TCU, pas de temps significatif', ft: 'ft', base: 'à', nosig: 'NOSIG : pas de changement significatif prévu dans les 2 heures', tx: 'Température maximale', tn: 'Température minimale', prob: 'probabilité', day: 'jour', auto: 'AUTO : message entièrement automatique', utc: 'UTC', minvis: 'visibilité minimale', ndv: 'pas de variation directionnelle disponible', more: 'ou plus', less: 'moins de', amd: 'AMD : prévision amendée', ws: 'Cisaillement de basse couche' },
};
const TR: Record<string, [string, string]> = { U: ['rising', 'en hausse'], D: ['falling', 'en baisse'], N: ['no change', 'stable'] };
const p2 = (n?: number) => String(n ?? 0).padStart(2, '0');

function wind(w: any, l: Lang) {
  const t = L[l];
  if (!w) return '';
  if (w.speed === 0) return t.calm;
  const unit = w.unit === 'KT' ? (l === 'en' ? 'kt' : 'kt') : w.unit === 'MPS' ? 'm/s' : 'km/h';
  let s = w.degrees === undefined ? `${t.variable}, ${w.speed} ${unit}` : `${t.from} ${p2(w.degrees).padStart(3, '0')}° ${l === 'en' ? 'at' : 'à'} ${w.speed} ${unit}`;
  if (w.gust) s += `, ${t.gust} ${w.gust} ${unit}`;
  if (w.minVariation !== undefined) s += `; ${t.varies} ${w.minVariation}° ${l === 'en' ? 'and' : 'et'} ${w.maxVariation}°`;
  return s;
}
function vis(v: any, l: Lang) {
  const t = L[l];
  if (!v) return '';
  const val = v.unit === 'SM' ? `${v.value} SM (${(v.value * 1.609).toFixed(1)} km)` : v.value >= 9999 ? `10 km ${t.more}` : `${v.value} m`;
  let s = v.indicator === 'P' && v.value < 9999 ? `${val} ${t.more}` : v.indicator === 'M' ? `${t.less} ${val}` : val;
  if (v.min) s += `; ${t.minvis} ${v.min.value} m (${v.min.direction})`;
  if (v.ndv) s += ` (${t.ndv})`;
  return s;
}
function weather(ws: any[], l: Lang) {
  const i = l === 'en' ? 0 : 1;
  return ws
    .map((w) => {
      const desc = w.descriptive === 'TS' && w.phenomenons.length ? (l === 'en' ? 'thunderstorm with' : 'orage avec') : w.descriptive && W[w.descriptive]?.[i];
      const core = [desc, ...w.phenomenons.map((p: string) => W[p]?.[i] ?? p)].filter(Boolean).join(' ');
      if (!w.intensity) return core;
      if (w.intensity === 'VC') return `${core} ${W.VC[i]}`;
      return l === 'en' ? `${W[w.intensity][0]} ${core}` : `${core} (${W[w.intensity][1]})`;
    })
    .join('; ');
}
function clouds(cs: any[], l: Lang) {
  const i = l === 'en' ? 0 : 1;
  return cs
    .map((c) => `${Q[c.quantity]?.[i] ?? c.quantity}${c.height !== undefined ? ` ${L[l].base} ${c.height.toLocaleString(l === 'en' ? 'en-US' : 'fr-FR')} ft` : ''}${c.type ? ` ${c.type}` : ''}`)
    .join('; ');
}
function common(o: any, l: Lang, rows: Row[]) {
  const t = L[l];
  if (o.wind) rows.push([t.wind, wind(o.wind, l)]);
  if (o.cavok) rows.push(['CAVOK', t.cavok]);
  if (o.visibility && !o.cavok) rows.push([t.vis, vis(o.visibility, l)]); // CAVOK already implies 10 km or more
  if (o.windShear) rows.push([t.ws, `${o.windShear.height.toLocaleString(l === 'en' ? 'en-US' : 'fr-FR')} ft ${l === 'en' ? 'AGL' : 'sol'}: ${wind(o.windShear, l)}`]);
  if (o.weatherConditions?.length) rows.push([t.wx, weather(o.weatherConditions, l)]);
  if (o.verticalVisibility !== undefined) rows.push([t.vv, `${o.verticalVisibility} ft`]);
  if (o.clouds?.length) rows.push([t.clouds, clouds(o.clouds, l)]);
}

export function decodeMetar(raw: string, l: Lang): Row[] {
  const m: any = parseMetar(raw.trim().replace(/\s+/g, ' ').replace(/=$/, ''), { locale: l === 'fr' ? fr : en });
  const t = L[l];
  const rows: Row[] = [];
  rows.push([t.type, m.type ?? 'METAR']);
  rows.push([t.station, m.station]);
  if (m.day) rows.push([t.time, `${t.day} ${m.day}, ${p2(m.hour)}:${p2(m.minute)} ${t.utc}`]);
  if (m.auto) rows.push(['AUTO', t.auto]);
  common(m, l, rows);
  for (const r of m.runwaysInfo ?? []) {
    if (r.minRange !== undefined) rows.push([`${t.rvr} ${r.name}`, `${r.indicator === 'P' ? '> ' : r.indicator === 'M' ? '< ' : ''}${r.minRange}${r.maxRange ? `-${r.maxRange}` : ''} ${r.unit ?? 'm'}${r.trend ? ` (${TR[r.trend]?.[l === 'en' ? 0 : 1] ?? r.trend})` : ''}`]);
  }
  if (m.temperature !== undefined) rows.push([t.temp, `${m.temperature} °C / ${m.dewPoint ?? '?'} °C`]);
  if (m.altimeter) rows.push([t.alt, m.altimeter.unit === 'inHg' ? `${m.altimeter.value.toFixed(2)} inHg (${(m.altimeter.value * 33.8639).toFixed(0)} hPa)` : `${m.altimeter.value} hPa (${(m.altimeter.value / 33.8639).toFixed(2)} inHg)`]);
  if (m.nosig) rows.push(['NOSIG', t.nosig]);
  for (const tr of m.trends ?? []) rows.push([`${t.trend} ${tr.type}`, trendText(tr, l)]);
  for (const r of m.remarks ?? []) rows.push([`${t.rmk}: ${r.raw ?? ''}`, r.description ?? r.raw ?? '']);
  return rows;
}

function trendText(tr: any, l: Lang) {
  const rows: Row[] = [];
  common(tr, l, rows);
  return rows.map(([k, v]) => `${k}${l === 'fr' ? ' :' : ':'} ${v}`).join(' | ') || tr.raw;
}

export function decodeTaf(raw: string, l: Lang): Row[] {
  let txt = raw.trim().replace(/\s+/g, ' ').replace(/=$/, '');
  if (!/^TAF\b/.test(txt)) txt = 'TAF ' + txt;
  const x: any = parseTAF(txt, { locale: l === 'fr' ? fr : en });
  const t = L[l];
  const rows: Row[] = [];
  rows.push([t.station, x.station]);
  if (x.amendment) rows.push(['AMD', t.amd]);
  if (x.day) rows.push([t.issued, `${t.day} ${x.day}, ${p2(x.hour)}:${p2(x.minute)} ${t.utc}`]);
  const v = x.validity;
  if (v) rows.push([t.validity, `${t.day} ${v.startDay} ${p2(v.startHour)}:00 → ${t.day} ${v.endDay} ${p2(v.endHour)}:00 ${t.utc}`]);
  common(x, l, rows);
  if (x.maxTemperature) rows.push([t.tx, `${x.maxTemperature.temperature} °C, ${t.day} ${x.maxTemperature.day} ${p2(x.maxTemperature.hour)}:00 ${t.utc}`]);
  if (x.minTemperature) rows.push([t.tn, `${x.minTemperature.temperature} °C, ${t.day} ${x.minTemperature.day} ${p2(x.minTemperature.hour)}:00 ${t.utc}`]);
  for (const tr of x.trends ?? []) {
    const vv = tr.validity;
    const when = tr.type === 'FM'
      ? `${t.day} ${vv.startDay} ${p2(vv.startHour)}:${p2(vv.startMinutes)} ${t.utc}`
      : `${t.day} ${vv.startDay} ${p2(vv.startHour)}:00 → ${t.day} ${vv.endDay} ${p2(vv.endHour)}:00 ${t.utc}`;
    const label = `${tr.probability ? `PROB${tr.probability} ` : ''}${tr.type === 'PROB' ? '' : tr.type}`.trim();
    rows.push([`${label} (${when})`, trendText(tr, l)]);
  }
  for (const r of x.remarks ?? []) rows.push([`${t.rmk}: ${r.raw ?? ''}`, r.description ?? r.raw ?? '']);
  return rows;
}

Training and reference only. For flight planning, always use official briefing sources (your national weather service, AIS or approved provider).

Frequently asked questions

How do I decode a METAR step by step?

Read the groups in order: type and station, day and time in UTC, wind, visibility, weather, clouds, temperature and dew point, then pressure. Anything after RMK is a remark. The decoder on this page performs the same sequence and prints one labeled row for each group it finds in the pasted report.

Which METAR formats does the decoder accept?

It accepts the ICAO form and the US form, with or without the word METAR or SPECI at the start. Visibility in meters or statute miles and pressure as Q or A groups are both read. A trailing equals sign and repeated spaces are removed before parsing, so text copied from a bulletin usually works.

Why does the decoder show an error for my report?

The parser throws an error when the text does not follow the METAR structure, for example a missing station or a damaged group. The page then reports that the weather string is invalid rather than guessing. Check the group that looks different from the others, such as a merged or split visibility.

Are the decoded values safe for flight planning?

No. The decoder is an educational reading aid. Operational decisions need the official briefing from an authorized source, which also carries NOTAMs and current forecasts. A decoded line can also lose detail, because a remark the library does not recognize is shown without an interpretation.

Why is the pressure shown in two units?

Reports from the United States give the altimeter setting in inches of mercury (A group) and most other countries give QNH in hectopascals (Q group). The decoder shows the reported value and adds the other unit, using 33.8639 hectopascals per inch of mercury, rounded for display.

Sources

  1. GitHub, Alexander Harding. metar-taf-parser (source code and documentation)
  2. Federal Aviation Administration (2025). Aeronautical Information Manual, chapter 7, section 1
  3. Federal Aviation Administration (2024). Aviation Weather Handbook (FAA-H-8083-28A)
  4. World Meteorological Organization (2025). Aerodrome Reports and Forecasts, A Users' Handbook to the Codes (WMO-No. 782)