---
name: "amo-changelog"
section: "1"
platform: "linux"
package: "mozilla-devscripts"
version: "0.54.2+nmu1"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/amo-changelog"
---

# amo-changelog(1)

fetch Version History of an addon

## NAME

amo-changelog - fetch Version History of an addon

## SYNOPSIS

**amo-changelog** \[*options*\] *extension*

## DESCRIPTION

**amo-changelog** fetches the Version History of an addon from the Mozilla Extensions website. It is meant to offer an easy way to include upstream changelogs in Debian packages of mozilla extensions - in many cases, this is not contained in the upstream source code repository, but is available on said website.

The *extension* argument is its short name, as used by the website. For example, the homepage for "Adblock Plus" is https://addons.mozilla.org/en-US/firefox/addon/adblock-plus/, so the short name would be "adblock-plus".

Here is an example for debian/rules:

\# if using debhelper\
 override\_dh\_installchangelogs:\
\
 	dh\_installchangelogs debian/upstream/changelog.html debian/upstream/changelog

.PHONY: get-orig-changelog\
 get-orig-changelog:\
\
 	amo-changelog -p rst adblock-plus

Using this approach, one would save the output files debian/upstream/{changelog.html,changelog} as part of the Debian packaging. When updating the package with a new upstream release, one would run \`debian/rules get-orig-changelog\`

## OPTIONS

- **-h**, **--help**

  Display a brief help message.

- **-f**, **--html-file**

  File to write to. Default: debian/upstream/changelog.html

- **-p**, **--plain-format**

  Generate a human-readable form of the changelog in the file without the .html extension, using an external program. Possible options are text (uses [lynx(1)](/lynx/1.md)), markdown ([pandoc(1)](/pandoc/1.md)), or rst ([pandoc(1)](/pandoc/1.md)). Default: none.

## AUTHOR

Jakub Wilk \<jwilk@debian.org\> and Ximin Luo \<infinity0@pwned.gg\>