+0
日增长
997
stars
165
forks
20
watchers
4,135
prs
467
issues
509
releases
README
Twake Drive
The open-source alternative to Google Drive.
Learn more »
Website
|
Issues
About
What's Drive?
Twake Drive makes your file management easy. Main features are:
- File tree
- Files and folders upload.
- Files and folders sharing (via URLs)
- Files and folders search
Getting Started
_:pushpin: Note:_ [Yarn] is the official Node package manager of Twake Drive. Don't hesitate to [install Yarn][yarn-install]
Install
Starting the Drive app requires you to [setup a dev environment][setup].
You can then clone the app repository and install dependencies:
sh
$ git clone https://github.com/linagora/twake-drive.git
$ cd twake-drive
$ yarn install
:pushpin: Don't forget to set the local node version indicated in the .nvmrc before doing a yarn install.
Twake Drive use a standard set of _npm scripts_ to run common tasks, like watch, lint, test, build…
Run in dev mode
Using a watcher - with Hot Module Replacement:
sh
$ cd twake-drive
$ yarn watch
$ cozy-stack serve --appdir drive://twake-drive/build/drive --disable-csp
Or directly build the app (static file generated):
sh
$ cd twake-drive
$ yarn build
$ cozy-stack serve --appdir drive://twake-drive/build/drive
Your app is available at http://drive.cozy.localhost:8080//folder
Note: it's mandatory to explicit to cozy-stack the folder of the build that should be served, to be able to run the app.
Run it inside the VM
You can view your current running app, you can use the [cozy-stack docker image][cozy-stack-docker]:
sh
in a terminal, run your app in watch mode
$ cd twake-drive
$ yarn watch
sh
in another terminal, run the docker container
$ docker run --rm -it -p 8080:8080 -v "$(pwd)/build/drive":/data/cozy-app/drive cozy/cozy-app-dev
Your app is available at http://drive.cozy.tools:8080.
Advanced case
Share and send mails in development
Twake Drive let users share documents from twake to twake.
Meet Alice and Bob.
Alice wants to share a folder with Bob.
Alice clicks on the share button and fills in the email input with Bob's email address.
Bob receives an email with a _« Accept the sharing »_ button.
Bob clicks on that button and is redirected to Alice's twake to enter his own twake url to link both twakes.
Bob sees Alice's shared folder in his own twake.
🤔 But how could we do this scenario on binary cozy-stack development environment?
If you develop with the cozy-stack CLI, you have to run MailHog on your computer and tell cozy-stack serve where to find the mail server with some options:
./cozy-stack serve --appdir drive:../twake-drive/build --mail-disable-tls --mail-port 1025
_This commands assumes you git clone twake-drive in the same folder than you git clone cozy-stack._
Then simply run mailhog and open http://cozy.tools:8025/.
Retrieve sent emails
With MailHog, every email sent by cozy-stack is caught. That means the email address _does not have to be a real one_, ie. bob@cozy, bob@cozy.Top issues
#4013Sub folders/files User story9 comments · 2026-07-02#2903Difficulties to setup the dev environment8 comments · 2023-04-17#2022Photo / files sync is not working automatically in background7 comments · 2020-05-25#1781Add photo to album from drive app7 comments · 2019-08-17#915Release on fdroid?7 comments · 2018-05-26#1416Select a range of photos5 comments · 2019-01-28#4452public link statistics3 comments · 2026-10-22#4201broken top bar in docx, sheets and notes - recipient(editor) can't share. TWP logo doen't work cant get back3 comments · 2026-09-15
Latest release
1.108.0 1.108.0 2026-10-22Releasing Twake Drive 1.108.0 to production: New features Shared drives and sharing - With federated sharing enabled, you can share folders nested inside shared folders. Drive asks for confirmation when reducing access also affects a parent folder. (4182, 4196) - Accept or decline sharing invitations from a banner without leaving Drive. Invitations appear one at a time, and unrelated banners are hidden on sharing pages. (4289, 4399, 4309) Moving and choosing files - Browse destinations and create folders in the move dialog, including folders shared with you where you have write access.