What is AtamanCloud Drive?
AtamanCloud Drive lets you browse, search, and manage your Google Drive from your computer. It runs on your PC and opens in your web browser — like a personal Drive app on your desktop.
✅ You can
Open folders, search files with plain English, rename items, move files, and send things to Trash — all from one window.
Important: AtamanCloud Drive only works while it is running on your computer. It does not run in the cloud and is not visible on the internet — only you can use it on this PC.
Quick start (AtamanCloud package)
Your installer from AtamanCloud already includes everything needed. Setup is automatic:
- Unzip the folder AtamanCloud sent you (it already contains the Google key file).
-
Double-click AtamanCloud Drive.bat
The first time, the app will automatically install Node.js (if needed) and configure Google access. You may see a Windows permission prompt — click Yes. -
Sign in with Google when your browser opens.
Use the Google account AtamanCloud registered for you. Click Allow to access Drive.
That's it! After the first run, double-click AtamanCloud Drive.bat whenever you want to use the app. For Settings or Uninstall, run AtamanCloud Drive.bat menu
First-time install may take a few minutes while Node.js and app dependencies download. Keep the black console window open until your browser opens.
For administrators only (optional)
If you are not using an AtamanCloud-provided package and need to create your own Google Cloud credentials, follow the section below. Customers with a standard AtamanCloud install can skip this.
Google setup — create your own credentials (optional)
Google needs to know that you are allowing this app to access your Drive. This is normal and safe — the app only runs on your computer.
Part A — Create a Google Cloud project
- Open console.cloud.google.com and sign in with your Google account.
- At the top, click the project dropdown → New Project → name it AtamanCloud Drive → Create.
- Go to APIs & Services → Library → search Google Drive API → click it → press Enable.
Part B — Tell Google who can use the app
- Go to APIs & Services → OAuth consent screen.
- Choose External → Create.
- Fill in App name (e.g. AtamanCloud Drive) and User support email → Save and Continue through the screens.
- On Test users, click + Add Users and add your own Gmail address. This is required while the app is in "Testing" mode.
Part C — Get your key file
- Go to APIs & Services → Credentials → Create Credentials → OAuth client ID.
- Application type: Web application
- Name: AtamanCloud Drive
- Under Authorized redirect URIs, click + Add URI and paste exactly:
Copy this exactly — no spaces, no extra slashes.
http://localhost:3000/auth/callback - Click Create → then click Download JSON (or the download icon).
- Save the file. It will be named something like client_secret_….json. Remember where you saved it.
Tip: In Settings, click Browse... to select this file. The app copies it into the AtamanCloud Drive folder for you — you don't need to move it manually.
First run & sign in
Starting the app
- Double-click AtamanCloud Drive.bat
- A black window titled AtamanCloud Drive appears — leave it open while you use the app.
- Your browser opens to the app. If it doesn't, go to http://localhost:3000
🚀 AtamanCloud Drive running at http://localhost:3000
Closing this window stops the app.
Closing this window stops the app.
Signing in with Google
- Click the blue Sign in with Google button.
- Choose your Google account.
- If Google warns the app is unverified, click Advanced → Go to AtamanCloud Drive (unsafe). This is your own app on your own computer — it's safe.
- Click Allow to give Drive access.
- You're in! Your files and folders appear.
If you close the black console window or restart your PC, you'll need to sign in again. Just double-click AtamanCloud Drive.bat and sign in — your files are still in Google Drive.
Everyday use
Opening folders
Click any folder to open it. Use the breadcrumb trail at the top (e.g. My Drive / Work / 2024) to go back. The left sidebar shows shortcuts to My Drive and subfolders.
Working with files
| To do this | Do this |
|---|---|
| Select a file | Click it once |
| Select several files | Hold Ctrl and click each one |
| Open a file in Google Drive | Double-click it |
| Rename a file | Select one file → click Rename |
| Move files | Select files → click Move → browse to a folder → Move here |
| Move to Trash | Select files → click Trash |
| Delete forever | Select files → click Delete (cannot be undone!) |
| Create a new folder | Click the New button at the top of the left sidebar |
| Switch view | Use the grid / list icons in the toolbar |
| Sort files | Use the sort dropdown (Name, Modified, Size, Type) |
Keyboard shortcuts
| Key | Action |
|---|---|
| Ctrl + K | Jump to search |
| Ctrl + A | Select all files |
| Delete | Move selected items to Trash |
| Esc | Clear selection or close a popup |
Smart search
The search bar at the top is smarter than a normal search box. You can type normal sentences and it figures out what you mean.
Try typing things like
invoices last month
large pdf
budget xlsx
Q3 report
Filter buttons (chips)
Above the search box you'll see small buttons like PDF, Spreadsheet, This folder, and Large. Click one to narrow results. Click the ✕ on an active filter to remove it.
Using search results
| Action | What happens |
|---|---|
| Click a result | Opens the file in Google Drive, or opens a folder in the app |
| Enter | Opens the highlighted result |
| Shift + Enter | Shows all matches in the main file list |
| ↑ ↓ | Move through results |
| Hover over a result | See a quick preview (size, date, type) |
Settings
Double-click AtamanCloud Drive.bat and choose Settings to change how the app works.
| Setting | What it does |
|---|---|
| OAuth JSON file | Import or change your Google key file (Browse...) |
| Port | Change the address number (leave at 3000 unless you know you need to change it) |
| Session secret | Click Generate for a random security code (recommended) |
| Open browser on start | Automatically open the app when you launch |
| Start when Windows starts | App launches automatically when you log into Windows |
After changing settings, close the AtamanCloud Drive console window and double-click AtamanCloud Drive.bat again for changes to apply.
Uninstall
Double-click AtamanCloud Drive.bat → Uninstall. This removes downloaded dependencies and the startup shortcut. You can keep your Google settings to reinstall quickly, or remove everything for a full reset.
Files you might see in the folder
| File | What it is |
|---|---|
| AtamanCloud Drive.bat | The only file you need — install, run, settings, uninstall |
| guide.html | This guide (also available from the menu) |
| client_secret_….json | Your Google key — keep private, don't share |
Something wrong?
Google says "redirect_uri_mismatch"
Go to Google Cloud Credentials, open your OAuth client, and make sure this exact address is listed under Authorized redirect URIs:
If you changed the port in Settings, the address must match your new port (e.g.
http://localhost:3000/auth/callbackIf you changed the port in Settings, the address must match your new port (e.g.
http://localhost:3001/auth/callback).
Google says "Access blocked" or "This app isn't verified"
Add your email under OAuth consent screen → Test users in Google Cloud Console. Then try signing in again. On the warning screen, click Advanced → Go to AtamanCloud Drive.
"Node.js is required" message appears
Install Node.js from nodejs.org (click the LTS button). Restart your computer after installing, then try again.
The browser says "This site can't be reached"
The app isn't running. Double-click AtamanCloud Drive.bat and wait for the black console window to show "AtamanCloud Drive running". Then refresh your browser.
Setup window says credentials are missing
Open AtamanCloud Drive.bat → Settings, click Browse..., and select your client_secret_….json file from Google. Click Save, then choose Run AtamanCloud Drive.
I signed in but no files appear
Make sure Google Drive API is enabled in Google Cloud (APIs & Services → Library → Google Drive API → Enable). Sign out and sign in again.
FAQ
Is my data safe?
Yes. The app runs only on your computer and talks directly to Google. Nothing is sent to other servers. Your key file and settings stay on your PC.
Can I use this on another computer?
Copy the whole AtamanCloud Drive folder to the other PC, install Node.js there, and run setup again. You can use the same Google key file.
Do I need to be online?
Yes. AtamanCloud Drive needs an internet connection to talk to Google Drive.
What's the black console window?
That's the app running in the background. Think of it like the engine of a car — close it and the app stops. Minimize it if it bothers you, but don't close it while using AtamanCloud Drive.
Can other people on my network use it?
No. The app only accepts connections from your own computer (localhost). Nobody else can access it over the network.