e695a8b481 | ||
---|---|---|
.circleci | ||
android | ||
app | ||
assets | ||
assets_src | ||
build | ||
common | ||
docs | ||
ios | ||
public | ||
scripts | ||
server | ||
test | ||
.dockerignore | ||
.editorconfig | ||
.eslintignore | ||
.eslintrc.yml | ||
.gitattributes | ||
.gitignore | ||
.gitlab-ci.yml | ||
.htmllintrc | ||
.prettierignore | ||
.stylelintrc | ||
CHANGELOG.md | ||
CODE_OF_CONDUCT.md | ||
CONTRIBUTORS | ||
Dockerfile | ||
LICENSE | ||
README.md | ||
browserslist | ||
docker-compose.yml | ||
l10n.toml | ||
package-lock.json | ||
package.json | ||
postcss.config.js | ||
s3-lifecycle-example.xml | ||
tailwind.config.js | ||
webpack.config.js |
README.md
Send
A fork of Mozilla's Firefox Send. Mozilla discontinued Send, this fork is a community effort to keep the project up-to-date and alive.
- Forked at Mozilla's last publicly hosted version
- Mozilla & Firefox branding is removed so you can legally self-host
- Kept compatible with
ffsend
(CLI for Send) - Dependencies have been updated
- Mozilla's changes since the fork have been selectively merged
- Mozilla's experimental report feature, download tokens, trust warnings and FxA changes are not included
Find an up-to-date Docker image here: docs/docker.md
The original project by Mozilla can be found here.
The mozilla-master
branch holds the master
branch
as left by Mozilla.
The send-v3
branch holds the commit tree of Mozilla's last
publicly hosted version, which this fork is based on.
The send-v4
branch holds the commit tree of Mozilla's last
experimental version which was still a work in progress (featuring file
reporting, download tokens, trust warnings and FxA changes), this has
selectively been merged into this fork.
Please consider to donate to allow me to keep working on this.
Thanks Mozilla for building this amazing tool!
Docs: FAQ, Encryption, Build, Docker, More
Table of Contents
- What it does
- Requirements
- Development
- Commands
- Configuration
- Localization
- Contributing
- Instances
- Deployment
- Clients
- License
What it does
A file sharing experiment which allows you to send encrypted files to other users.
Requirements
- Node.js 15.x
- Redis server (optional for development)
- AWS S3 or compatible service (optional)
Development
To start an ephemeral development server, run:
npm install
npm start
Then, browse to http://localhost:8080
Commands
Command | Description |
---|---|
npm run format |
Formats the frontend and server code using prettier. |
npm run lint |
Lints the CSS and JavaScript code. |
npm test |
Runs the suite of mocha tests. |
npm start |
Runs the server in development configuration. |
npm run build |
Builds the production assets. |
npm run prod |
Runs the server in production configuration. |
Configuration
The server is configured with environment variables. See server/config.js for all options and docs/docker.md for examples.
Localization
See: docs/localization.md
Contributing
Pull requests are always welcome! Feel free to check out the list of "good first issues" (to be implemented).
Instances
Find a list of public instances here: https://github.com/timvisee/send-instances/
Deployment
See: docs/deployment.md
Docker quickstart: docs/docker.md
AWS example using Ubuntu Server 20.04
: docs/AWS.md
Clients
- Web: this repository
- Command-line:
ffsend
- Android: see Android section
- Thunderbird: FileLink provider for Send
Android
The android implementation is contained in the android
directory,
and can be viewed locally for easy testing and editing by running ANDROID=1 npm start
and then visiting http://localhost:8080. CSS and image files are
located in the android/app/src/main/assets
directory.
License
Mozilla Public License Version 2.0
qrcode.js licensed under MIT