twcloud/README.md at master - GitHub

Python package + CLI to generate wordclouds of Twitter tweets. - twcloud/README.md at master · minimaxir/twcloud. Skiptocontent {{message}} minimaxir / twcloud Public Notifications Fork 3 Star 76 Code Issues 1 Pullrequests 0 Actions Projects 0 Security Insights More Code Issues Pullrequests Actions Projects Security Insights Permalink master Branches Tags Couldnotloadbranches Nothingtoshow {{refName}} default Couldnotloadtags Nothingtoshow {{refName}} default twcloud/README.md Gotofile Gotofile T Gotoline L Copypath Copypermalink     Cannotretrievecontributorsatthistime twcloud Installation Usage HelpfulParameters stylecloudparametersw/ChangedDefaults HelpfulNotes Maintainer/Creator License Disclaimer 122lines(80sloc) 4.7KB Raw Blame OpenwithDesktop Viewraw Viewblame twcloud GenerateawordcloudofTwittertweetswithasinglecommand. twcloudisaPythonpackagethatleveragesthetwintpackagetogatherTweetsfromanypublicaccountwithoutrequiringauthentication,andthestylecloudpackagewhichaddsmanyusefulfeaturestocreatetrulyuniquewordclouds! Retrievetweetsfromauser,oraTwittersearch. GatheranynumberofTweetsfromthespecifiedqueryforbuildingthewordcloud(evenbeyondthetypical3,200limit) CommandLineInterface! Additionally,fromthebasestylecloudpackage: Iconshapes(ofanysize!)forwordclouds Supportforadvancedcolorpalettes(viapalettable) Manualcolorselectionfortextandbackgrounds, Directionalgradientsw/theaforementionedpalettes. Installation Youcaninstalltwcloudviapip: pip3installtwcloud Usage YoucanusetwcloudinaPythonscriptorasastandaloneCLIapp.Forexample,let'svisualizeTwitterCEOJackDorsey'smostrecentTweets: FromPython: importtwcloud twcloud.gen_twcloud(username='jack') Orfromthecommandline: twcloud--usernamejack Orevenmoresimply,toquicklygathertweetsfromauser: twcloudjack Youcanalsosearchforkeywords.HowaboutfindingEnglishTweetsabout#MondayNightFootball,andchangingthethemingappropriately? importtwcloud twcloud.gen_twcloud(search='#MondayNightFootballlang:en', icon_name='fasfa-football-ball', background_color='black', colors='yellow') twcloud--search'#MondayNightFootballlang:en'--icon_name'fasfa-football-ball'--background_colorblack--colorsyellow AlittleknownfeatureofTwittersearchisthatifyousearchforaTweetURL,youwillgetallQuoteTweetscorrespondingtothattweet.HowaboutgettingEnglishquotetweetsresultingfromtherecenttweetaskingforquotetweetswithcontroversialfoodopinions? importtwcloud twcloud.gen_twcloud(search='https://twitter.com/jonbecker_/status/1196805486907052033lang:en', icon_name='fasfa-utensils', background_color='#c0392b', palette='colorbrewer.sequential.YlOrBr_3', gradient='vertical') twcloud--search'https://twitter.com/jonbecker_/status/1196805486907052033lang:en'--icon_name'fasfa-utensils'--background_color'#c0392b'--palettecolorbrewer.sequential.YlOrBr_3--gradientvertical HelpfulParameters TheseparametersarevalidforboththePythonfunctionandtheCLI(youcanusetwcloud----helptogetthisinformationaswell).Additionalvisualcustomizationparameterscanbefoundwithinthestylecloudrepo. username:Twitter@usernametogathertweets(excludingthe@).AnypublicTwitteraccountisvalid. search:Searchquerytouse.CanuseahashtagoratweetURL(togetquote-tweets) limit:Numberoftweetstogatherbeforerenderingthetwcloud[default:500] stylecloudparametersw/ChangedDefaults icon_name:IconNameforthestylecloudshape.(e.g.'fasfa-grin')[default:fabfa-twitter] colors:Color(s)touseasthetextcolors.[default:white] background_color:Backgroundcolor(nameorhex)[default:#1DA1F2] output_name:Outputfilenameofthestylecloud.[default:twcloud.png] HelpfulNotes Specifyingapaletteparameterwilloverridethecolorsparameter.Thisisthereverseofstylecloud. Savingtheretrievedtweetsisoutofscopeforthispackage.Ifyouwanttosavethetweets+additionalmetadata,usetwintdirectly. usernamequerieswillnotreturnRetweetsmadebytheuser. Advancedsearchfilterscanbeusefultooforincreasingthequalityofthetwcloud,e.g.filter:verifiedtoretrieveonlytweetsfromverifiedusers,orlang:entoretrieveonlyEnglishtweets. Maintainer/Creator MaxWoolf(@minimaxir) Max'sopen-sourceprojectsaresupportedbyhisPatreonandGitHubSponsors.Ifyoufoundthisprojecthelpful,anymonetarycontributionstothePatreonareappreciatedandwillbeputtogoodcreativeuse. License MIT Disclaimer ThisrepohasnoaffiliationwithTwitterInc. Go Youcan’tperformthatactionatthistime. Yousignedinwithanothertaborwindow.Reloadtorefreshyoursession. Yousignedoutinanothertaborwindow.Reloadtorefreshyoursession.