IMGUR(1) User Manuals IMGUR(1) NAME imgur - upload images to the web SYNOPSIS imgur [-b] filename imgur -l imgur -r [-b] record_name DESCRIPTION imgur uploads images to imgur.com, and optionally launches the system web browser to view the uploaded image. It can also list any previ- ously uploaded images, and re-display their details. No account or payment is needed to host images on imgur.com, and therefore this pro- gram should operate correctly with no configuration. Details of each image are printed to standard output in three tab- delimited columns. The first column is an identifier for the image. The second is a field name, and the third is a value. This allows you to use grep(1) and cut(1) to pull out only the parts you need. A list of valid field names is given in KEYS , below. OPTIONS -b Launch the browser to look at the uploaded image. This may be combined with the -r option, to allow you to look at a previ- ously-uploaded image in the browser. -l List all previously uploaded images to standard output. The images are listed newest first. Their identifiers may be in the form of filenames; if so, they represent thumbnails of the images, and only the part without the path or extension is sig- nificant. If there are no previously uploaded files, prints "(no records to list)" to standard error. -r View the records of a previously-uploaded image. Identifiers are case-sensitive. The identifier may be given in plain form, such as LThFy , or in the form of a filename, such as /home/user/.local/share/imgur/LThFy.jpg -- if given as a file- name, the path and extension are discarded. You can obtain a list of valid identifiers using the -l option. KEYS These are the strings you may find in the second column of the results tables which are printed to standard output. delete_hash A secret value used by the API to allow deletion of the copy of the image on the web. Not currently usable by this program, though it will be later. delete_page The address of a web page which includes the delete_hash men- tioned above. This allows you to delete the copy of the image on the web using a web browser. filename The original name of the file on your computer which was uploaded. This field is inserted by the program locally; it is not gener- ated by the remote server. As such, it is not printed after an upload, only as part of a historical record. image_hash A six-character identifier which represents the copy of the image on the web. This is the simplest form which may be used to refer to the image. It is case-sensitive. imgur_page The address of a web page where you may view the image. This address is what the -b option opens in the web browser. large_thumbnail The web address of a large thumbnail of the image, suitable for inclusion in blogs. This image is generally at most 640 pixels on its longest side. local_thumbnail A local copy of the image referenced by small_thumbnail whose filename can also be used as a reference to the image as a whole. This is the filename which the -l option attempts to use in its listings. This field is inserted by the program locally; it is not gener- ated by the remote server. As such, it is not printed after an upload, only as part of a historical record. original_image The web address for a copy of the original image, at the same size. small_thumbnail The web address of a small thumbnail of the image. This image is generally at most 100 pixels on its longest side. time The time at which the upload was made. This is stored as a num- ber of seconds since the epoch, but printed as a human-readable date. The date format is sortable. This field is inserted by the program locally; it is not gener- ated by the remote server. As such, it is not printed after an upload, only as part of a historical record. DIAGNOSTICS The following diagnostics may be issued on standard error: (no records to list) You requested a listing of previous uploads, but there are none to list. Either you have never uploaded files using this pro- gram, or the program has been told not to log uploads. (name) found 0 You asked to list the details of a record which was not found. FILES These paths are derived from the specifications given in the XDG Base Directory Specification, and so may vary according to the provisions of that document. /etc/xdg/imgur/imgur.conf Site-wide configuration file, in key-file format. Currently ignored: this is a bug. The file is well-commented; copy it to the path given in the next entry to customise it for yourself. ~/.config/imgur/imgur.conf Local configuration, in the same format as the preceding entry. In particular, you may set the recording key in the general group to 0 to prevent recording of uploads. ~/.local/share/imgur/uploads.conf The details of previous uploads. Thumbnails of these uploads are stored in the same directory. BUGS See https://github.com/tthurman/imgur-integration/issues for an up-to- date list of issues. See https://github.com/tthurman/imgur-integration/wiki/roadmap to get an idea about priorities for fixing them. Patches and suggestions are always welcome. AUTHOR Thomas Thurman SEE ALSO Further documentation may be found at https://github.com/tthurman/imgur-integration/wiki . Linux January 2011 IMGUR(1)