lesma(1)                             LESMA                             lesma(1)

NAME
    lesma - simple paste app friendly with browser and command line

SYNOPSIS
    <command> | curl -F 'lesma=<-' https://lesma.eu

DESCRIPTION
    add ?limit=n to set a download count limit (0: unlimited; max: 255)
    add ?expire=n to set an expiration time in hours (max: 720h/30d)
    add ?password=p to set a password or obtain a password-protected lesma
    replace 'lesma=<-' with 'data=@file' to send binary files (max: 10MiB)
    add any extension to resulting url for syntax highlighting
    add ?raw for plain file
    add #n-<number> for go directly to line number anchor

DEFAULTS
    Download count limit: unlimited plain; unlimited browser
    Expiration time: 720 hour(s) / 30 day(s) plain; 1 hour(s) browser

EXAMPLES
  Basic usage
    ~$ cat lesma.rs | curl -F 'lesma=<-' https://lesma.eu
       https://lesma.eulesma
    ~$ curl https://lesma.eu/lesma

  Set a view / download limit
    ~$ cat lesma.rs | curl -F 'lesma=<-' 'https://lesma.eu?limit=1'
       https://lesma.eu/lesma
    ~$ curl https://lesma.eu/lesma.rs
       Show lesma contents. Colored!
    ~$ curl https://lesma.eu/lesma.rs
       lesma not found

    Note that cloning lesmas over the web or sharing the link in a social
    network or chat that has the preview enabled consumes a view. To avoid
    consuming this view when sharing the link you can set a password.

  Send text that can only be viewed once
    ~$ curl -F 'lesma=some text' 'https://lesma.eu?limit=1'

  Set an expiration time of one hour
    ~$ curl -F 'lesma=some text' 'https://lesma.eu?expire=1'

  Set a limit of ten views or an expiration time of one day
    ~$ curl -F 'lesma=some text' 'https://lesma.eu?limit=10&expire=24'

  Set a password-protected lesma
    ~$ curl -F 'lesma=some text' 'https://lesma.eu?password=complexword'

    Note that the password is entered as a URL option so special characters
    must be transformed into URL encoding. To avoid this you can use the
    following method.

    ~$ curl -F 'lesma=some text' -F 'password=some pass' https://lesma.eu

  Get a password-protected lesma
    ~$ curl 'https://lesma.eu/lesma?password=complexword'

    If the password has special characters, it is easier to use the
    following method.

    ~$ curl -F 'password=some pass' https://lesma.eu

  Set a limit of one view or an expiration of one hour and password-protected
    ~$ curl -F 'lesma=text' 'https://lesma.eu?limit=1&expire=1&password=pass'

  Send parameters in the request body instead of in the URL
    ~$ curl -F 'lesma=text' -F 'limit=1' -F 'expire=1' -F 'password=pass' \
       https://lesma.eu

  Send any binary file
    ~$ curl -F 'data=@file' https://lesma.eu

    You can send 'limit', 'expire' and 'password' parameters just like with
    text lesmas. This always generates a download link regardless of the
    file you send.

AUTHOR
    Written by Óscar García Amor

COPYRIGHT
    Copyright © 2017-2023 Óscar García Amor (https://ogarcia.me).
    Distributed under terms of the GNU GPLv3 license.

REPORTING BUGS
    https://gitlab.com/ogarcia/lesma/issues

SPECIALS
    /:help show full help

SEE ALSO
    https://gitlab.com/ogarcia/lesma

lesma v1.2.0                                                           lesma(1)