Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    wsendpublic

    node-wsend

    wsend: The opposite of wget, for node

    Overview

    node-wsend is a Command Line Tool (CLI) for sending files. It's open-source and easy to use. We've designed wsend to be suitable for command line beginners and well seasoned users alike.

    wsend dependencies should be handled by npm. And if you've ever run into this problem: http://xkcd.com/949/

    wsend uses wsend.net for backend file handling.

    One-line wsend install

    sudo npm install wsend -g
    

    Features

    • Sending files right from the command line without having to specify a directory
    • Gives you a url
    • Integrates well with unix pipes
    • Send a file without registering
    • User accounts available with large amounts of storage space

    Usage

    Usage:

     wsend <file>
    

    Common Commands:

    Send a file

     wsend file.txt
    

    Send a file in an email to your friend (if you have the mail command set up)

     wsend -p logfile.log | mail -s "Here was that log file you wanted" friend@example.com
    

    Register

     wsend --register
    

    Login

     wsend --login
    

    Refer a friend (receive 1GB for you and friend)

     wsend --refer friend@example.com
    

    Get a referral link to send to people

     wsend --referlink
    

    Pricing

    Account Space Price
    Unregistered (Anonymous) Account 200MB Free
    Free Account 2GB Free
    Supporter Paid Account 10GB $10/year or $1/month
    Enthusiast Paid Account (coming soon) 75GB $30/year or $3/month
    Hero Paid Account (coming soon) 100GB $50/year or $5/month

    API

    The API is REST like in the sense that there is a representational transfer of state. It isn't REST like in the sense that the only transport method that is used is HTTP POST.

    To get a user id:

    curl -F "start=1" https://wsend.net/createunreg
    

    This should be saved to a file or a database

    To send a file:

    curl -F "uid=$id" -F "filehandle=@$fileToSend" https://wsend.net/upload_cli
    

    Where $id is the id from the previous request and $fileToSend is the file you would like to send.

    To see if the user has storage space available to send this file:

    curl -F "uid=$id" -F "size=$fileToSendSize" https://wsend.net/userspaceavailable
    

    Where $fileToSendSize is the filesize in bytes.

    To register a user:

    curl -F "uid=$id" -F "email=$email" -F "password=$password" https://wsend.net/register_cli
    

    You want to protect the password from showing up anywhere as security measure. For the wsend command line script the password is not echoed and passed directly as a variable.

    To log in a user:

    curl -F "email=$email" -F "password=$password" https://wsend.net/login_cli
    

    FAQ

    1. Q: How does this differ from wsend?

      A: This command line tool is written in javascript for node.js and while it has a dependency on npm and the packages which it requires and node is not as ubiquitous as bash and curl; it is easier to install and update.

    2. Q: When are the Enthusiast and Hero accounts going to become available?

      A: As soon as we generate enough income with the Supporter accounts we can purchase more servers and more space. We do not want to degrade the quality of paid accounts because paying customers deserve the best treatment. We do not want to offer services that we can't fully 100% support until we are ready to.

    3. Q: What is the max filesize?

      A: For the Unregistered Account it is 200MB, for the Free account it is 2GB, for the Paid accounts it is 10GB.

    4. Q: I had an unregistered 200MB account. Can I get a listing of my files?

      A: If you register through the command line and then log into https://wsend.net you sould be able to get a listing of all of the files you have uploaded.

    5. Q: But I don't want to register, can't you list my files on the command line with a wsend --ls or some such?

      A: While command line account management is definitely in the works, we would really prefer it if you registered so you can make sure a file is actually yours before deleting.

    6. Q: I have an unregistered account, why is my file not loading?

      A: We remove files from unregistered accounts when they become 30 days old or space is needed on the server whichever comes first.

    7. Q: I have a free account, why are my files missing?

      A: We remove files from free accounts when they become 30 days old or space is needed on the server whichever comes first.

    8. Q: But why, that doesn't seem right, no other service does this?

      A: The wsend program and service is primarily provided for sending files. We have to maintain the best service possible for paying users, once the paying user-base grows we can support more benefits for the unregistered and free accounts. This service is not meant to compete with other services that store files for free, it can be used as a quick and easy way to send files.

    9. Q: Can I use the wsend script to interface with another web service?

      A: By all means, its GPL licensed and you can adapt it to whatever service you would like or create your own.

    10. Q: I have a problem but it is not listed here, who should I ask?

    A: While we will try to respond to all requests, you can contact us at https://wsend.net/about If you are a paying user we will definitely respond and will not rest till your problem is resolved.  Just fill out the contact form with your email that is registered to your paid account.  Paid accounts are so important to us because it not only keeps the lights on and the hard drives spinning, it validates what we are doing and it says you support us, you support the community, and you support an open internet where everyone can exchange ideas.  You are also joining us in contributing to something larger than ourselves.
    

    Help

    If you find wsend difficult to use, please open up a Github issue or if you see an area that can be improved send a pull request!

    ~.wsend/ directory

    This directory stores a file called .id, which is an identifier for the command line user.

    .id

    This file stores an identifier for the command line user

    (C) Copyright 2013, wsend.net

    Keywords

    none

    install

    npm i wsend

    Downloadsweekly downloads

    23

    version

    0.0.11

    license

    none

    repository

    githubgithub

    last publish

    collaborators

    • avatar